13.1 Jira
ํํ์ง
๋ฐ์์ฒ
Jira๋ฅผ ๊ด๋ฆฌํ๊ธฐ ์ํ ํ๋ฉด์ ์ ๊ณตํ๋ค. Host ํ์์ Atlassian Server์์ Jira์ ์์ฑ, ์์ , ์ญ์ ๊ฐ ๊ฐ๋ฅํ๋ฉฐ, ์ํ์กฐํ์ ์์/์ข ๋ฃ๋ฅผ ์ํํ ์ ์๋ค.
์ฐธ๊ณ
Playce WASup์ด ์ง์ํ๋ Jira ๋ฒ์ ์ 8.5.2 ์ด๋ค.
๋ด์ฉ
Jira ์์ฑ
Jira๋ฅผ ์์ฑํ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. [Create Server > Jira] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira ์ ๋ณด ๋ฑ๋ก์ ์ค๋นํ๋ค.
2. Jira์ ์์ฑ์ ์ ๋ ฅํ๋ค.
3. [Save] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ ์ฅํ๋ค.
์ฐธ๊ณ
Jira๋ Host์์ Engine ์ค์น ๊ณผ์ ์ ๊ฑฐ์น์ง ์๊ณ Jira ์์ฑ ์ ์๋์ ์ผ๋ก Engine์ด ์ค์น๋๋ค. 1๊ฐ์ Host์๋ 1๊ฐ์ Jira๋ง ์ค์น ๊ฐ๋ฅํ๋ค.
Jira์ ์ฃผ์ ์ค์ ๊ฐ์ ๋ค์๊ณผ ๊ฐ๋ค. ๊ธฐํธ * ๋ ํ์๊ฐ์ด๋ค.
ํญ๋ชฉ | ์ค๋ช | ๋น๊ณ |
---|---|---|
Server Name * | Server์ ์ด๋ฆ |
|
Host | Server ์์ง์ด ์ค์น๋ ํธ์คํธ์ ์ด๋ฆ | |
Engine | Server์์ ์ฌ์ฉ๋๋ ์์ง์ ์ด๋ฆ |
|
Version * | Server์์ ์ฌ์ฉ๋๋ ์์ง์ ๋ฒ์ | |
Install Path * | Server์์ ์ฌ์ฉ๋๋ ์์ง ์ค์น ๊ฒฝ๋ก |
|
Jira์ ๋์ ๋ฐฉ๋ฒ์ ์ ์ํ๋ ๋ฐ ํ์ํ ์ฃผ์ ๋ฐ์ดํฐ๊ฐ ์ ์ฅ๋๋ Jira ํ ๋๋ ํ ๋ฆฌ |
| |
Server๋ฅผ ์์ํ ๋ ์ฌ์ฉํ๋ Java ํ ๋๋ ํ ๋ฆฌ |
| |
Jira ๊ตฌ๋ ์ฌ์ฉ์ ์ด๋ฆ |
| |
Java Heap Minimum Size (MB) * | JVM์ ์ต์ Heap ๋ฉ๋ชจ๋ฆฌ |
|
Java Heap Maximum Size (MB) * | JVM์ ์ต๋ Heap ๋ฉ๋ชจ๋ฆฌ |
|
Server Link | Jira์ ์ ๊ทผํ ๋ ์ฌ์ฉํ๋ URL ์ฃผ์ |
|
Description | Server์ ๋ํ ์ค๋ช |
|
Target | ๋ฅผ ์ฌ์ฉํ์ฌ Jira์ ์ค์๊ฐ ๋ชจ๋ํฐ๋ง ์ ๋ณด๋ฅผ ์์ง ๋ฐ ๋ถ์ |
Jira ์์
1. Atlassian Server ์ค ์์ ํ Jira๋ฅผ ์ ํํ๋ค.
2. [Action > Edit] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ ํํ Jira๋ฅผ ์์ ํ๋ค.
3. Server Name๊ณผ ๊ฐ ์์ฑ ์ ๋ณด๋ฅผ ์ํ๋ ๊ฐ์ผ๋ก ์์ ํ๋ค.
[์์ ๊ฐ๋ฅํ ํญ๋ชฉ] Server Name, Java Home, Jira Run User, Java Heap Minimum Size (MB), Java Heap Maximum Size (MB), Server Link, Description, Target
4. ์์ ์ ์๋ฃํ๋ฉด [Save] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ ์ฅํ๋ค.
Jira ์ญ์
1. Atlassian Server ์ค ์ญ์ ํ Jira๋ฅผ ์ ํํ๋ค.
2. [Action > Delete] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira๋ฅผ ์ญ์ ํ๋ค.
3. ์ญ์ ๊ฐ๋ฅํ ์ํ์ผ ๊ฒฝ์ฐ์๋ง [Delete] ๋ฒํผ์ด ํ์ฑํ ๋๋ค.
์ค์
Jira๊ฐ ๊ธฐ๋์ค์ผ ๊ฒฝ์ฐ ์ญ์ ํ ์ ์์ผ๋ฉฐ, ์ญ์ ๊ฐ๋ฅํ ์ํ์ผ ๊ฒฝ์ฐ์๋ง [Delete] ๋ฒํผ์ด ํ์ฑํ ๋๋ค.
Jira ์ค์ ๊ด๋ฆฌ
Atlassian Server ๋ชฉ๋ก์์ Jira์ Server Name์ ์ ํํ๋ฉด ์์ธ์กฐํ ๋ฐ ์ค์ ์ ๋ณด๋ฅผ ๋ณ๊ฒฝํ๋ ๊ธฐ๋ฅ์ ์ ๊ณต, ์ค์ ํ์ผ์ ๋ฒ์ ๋ณ ๋น๊ต ๋ฐ ๋ณต์์ด ๊ฐ๋ฅํ๋ค.
Jira ํ์์ Scouter Java Agent๊ฐ ์กด์ฌํ๋ ๊ฒฝ์ฐ, Scouter Java Agent ํญ์ด ์์ฑ๋์ด Config File ๊ด๋ฆฌ๊ฐ ๊ฐ๋ฅํ๋ค.
๋ํ ์ฌ์ฉ์๊ฐ ์ํ๋ Config ํ์ผ์ ์ง์ ์์ฑํ๊ณ ๊ด๋ฆฌํ ์ ์๋ค.
์ค์
Jira ์ค์ ์ ๋ณ๊ฒฝํ ๊ฒฝ์ฐ ์์ ๋ ์ฌํญ์ ๋ฐ์์ ์ํ์ฌ Jira์ ์ฌ๊ธฐ๋์ด ํ์ํ๋ค.
1) General
Jira์ ๋ฑ๋ก ์ ๋ณด๋ Jira ์์ธ์กฐํ ์ ์๋จ์์ญ์ ํ์๋๋ค. ์ฐ์ธก ์๋จ์ [] ๋ฒํผ์ ํด๋ฆญํ๋ฉด ์์ ํ๋ฉด์ด ์ถ๋ ฅ๋๋ค.
ํ๋จ์์ญ์๋ Jira๋ฅผ ๋ชจ๋ํฐ๋ง ํ๊ณ ์๋ Scouter Java Agent์ ์ ๋ณด๊ฐ ํ์๋๋ค.
2) Config File
Jira์ Config File์ ํญ์ผ๋ก ๊ตฌ๋ถ๋์ด ํ์ผํธ์ง๊ธฐ๋ฅผ ํตํด ๊ด๋ฆฌํ ์ ์๋ค.
Jira์ ์ ๊ณต๋๋ Config File์ ๋ค์๊ณผ ๊ฐ๋ค.
ํญ๋ชฉ | ์ค๋ช | |
---|---|---|
setenv.sh | JVM size, Catalina log, Java_home, Scouter setting ๋ฑ | |
user.sh | Jira User ์ค์ | |
server.xml | Jira Application Server ์ค์ | |
jira-application.properties | Jira Application Home ์ค์ | |
seraph-config.xml | ๋ณด์ ๋ฐ ์ธ์ฆ ๊ด๋ จ ์ค์ | |
crowd.properties | Jira์ Crowd ์ค์ | |
dbconfig.xml | Jira Database ์ค์ |
Config ํ์ผ์ ์์ ํ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. ์กฐํ๋ ํ๋ฉด์์ ์ฐ์ธก ์๋จ์ [] ๋ฒํผ์ ํด๋ฆญํ๋ฉด ํ์ผ์ ํธ์งํ ์ ์๋ Edit Mode๋ก ๋ณํ๋๋ค.
2. ์์ ์ ์๋ฃํ๋ฉด [] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ ์ฅํ๋ค.
3. ์ ์ฅ์ ์๋ฃํ๋ฉด Config ํ์ผ์ ์๋ก์ด ๋ฒ์ ์ด ์์ฑ๋๋ค.
Config ํ์ผ์ ๋ฒ์ ๋ณ ๋น๊ต ๋ฐ ๋ณต์ํ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. Selected Version์ ์ ํํ๋ค.
2. Compared Version์ ์ ํํ๋ค.
3. ๋น๊ตํ ๋ฒ์ ์ ์ ํ ์๋ฃํ๋ฉด ์ฐ์ธก ์๋จ์ [Compare] ๋ฒํผ์ ํด๋ฆญํ๋ค.
4. Compare Config File ํ์ ์ฐฝ์ด ์ถ๋ ฅ๋์ด ์ ํํ ๋ฒ์ ์ ํ์ผ ์ ๋ณด๋ฅผ ๋ณผ ์ ์๋ค. ์ค์ ํ์ผ ๋น๊ต ๊ฒฐ๊ณผ๋ ๋๊ฐ ๋ฒ์ ์ ๋์์ ๋ณผ ์ ์๋ [Split View]๋ฅผ ๋ํดํธ๋ก ์ ๊ณตํ๋ค.
5. [Unified View] ๋ก๋ ๋ณํํ์ฌ ํ์ธ ๊ฐ๋ฅํ๋ค.
6. ๋ณต์ํ๊ณ ์ ํ๋ ๋ฒ์ ์ ์์ [Restore] ๋ฒํผ์ ํด๋ฆญํ๋ฉด ํด๋น ์ค์ ํ์ผ๋ก ๋ณต์ํ ์ ์๋ค. ๋ณต์ ์ Config ํ์ผ์ ์๋ก์ด ๋ฒ์ ์ด ์์ฑ๋๋ค.
์ค์
Jira์ ์ค์ ํ์ผ ์์ ๋ฐ ์ ์ด๋ฅผ Script ํ์ผ์์ ์ง์ ์ํํ ๊ฒฝ์ฐ ์ฌ์ฉ์๊ฐ ์๋ชป๋ ๋ด์ฉ์ ์ ๋ ฅํ ์ ์์ผ๋ฏ๋ก ์ฃผ์ํด์ผ ํ๋ค. Playce WASup์ ๋ชจ๋ ์์ ๋ค์ Manager๋ฅผ ํตํด ์ํํ ๊ฒ์ ๊ถ์ฅํ๋ค.
3) ์ฌ์ฉ์ ์ ์ Config File
์ ๊ณต๋๋ Config File ์ธ ์ฌ์ฉ์๊ฐ Config File์ด ์ถ๊ฐ๋ก ํ์ํ ๊ฒฝ์ฐ, Config ํ์ผ์ ์ฌ์ฉ์๊ฐ ์ง์ ์์ฑํ๊ณ ๊ด๋ฆฌํ ์ ์๋ค.
Config ํ์ผ์ ์์ฑํ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. ์กฐํ๋ ํ๋ฉด์์ ๋ง์ง๋ง ํญ ์ฐ์ธก์ [Add New +] ๋ฒํผ์ ํด๋ฆญํ๋ฉด Add Config File ํ์ ์ฐฝ์ด ์ถ๋ ฅ๋๋ค.
2. File Path๋ฅผ ํด๋ฆญํ์ฌ Install Path ๋๋ Jira Home ์ค 1๊ฐ๋ฅผ ์ ํํ์ฌ ๊ฒฝ๋ก๋ฅผ ์ง์ ํ๋ค.
3. ์ ํ๋ File Path ๋ค์์ผ๋ก ํด๋น๋๋ Path๋ฅผ ์ ๋ ฅํ๊ณ [Check File] ๋ฒํผ์ ํด๋ฆญํ์ฌ Config ํ์ผ์ ์กด์ฌ์ ๋ฌด๋ฅผ ํ์ธํ๋ค.
4. ํ์ผ์ด ์กด์ฌ ์์๋ ํ๋จ์ File Content ์์ญ์ ํด๋น ๋ด์ฉ์ ํ์ํด์ฃผ๋ฉฐ, ์ฌ์ฉ์๋ ์ด๋ฅผ ์์ ํ ์ ์๋ค. ๋ํ ํ์ผ์ด ์กด์ฌํ์ง ์์ ๊ฒฝ์ฐ์๋ File Content ์์ญ์ ์ฌ์ฉ์๊ฐ ์ ๊ท๋ก ์์ฑํ ์ ์๋ค.
5. File Content ์์ฑ์ด ์๋ฃํ๋ฉด [Save] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ฌ์ฉ์์ ์ ํญ์ ์์ฑํ๋ค.
6. ์ฌ์ฉ์๊ฐ ์์ฑํ ํญ์ ๋ํด์๋ ์์ , ์ญ์ ๊ฐ ๊ฐ๋ฅํ๋ค.
์ฐธ๊ณ
์ฌ์ฉ์๊ฐ ์์ฑํ ํญ์ ์ญ์ ํ ๊ฒฝ์ฐ, ํญ์ ์ญ์ ๋๋ Config ํ์ผ ์์ฒด๋ ์ญ์ ๋์ง ์๋๋ค.
Jira์ Scouter ์ฐ๋
Jira์ Scouter Server๋ฅผ ์ฐ๋ํ์ฌ Jira์ ์ค์๊ฐ ๋ชจ๋ํฐ๋ง์ด ๊ฐ๋ฅํ๋ฉฐ, ์ฐ๋๋ Scouter Server์ ์ค์ ํ์ผ์ ๊ด๋ฆฌํ ์ ์๋ค.
Jira์ Scouter Server๋ฅผ ์ฐ๋ํ๋ ค๋ฉด ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. [Create Server > Jira] ๋ฒํผ์ ํด๋ฆญํ๋ค.
2. ํ๋จ์ Target Scouter Server๋ฅผ ์ ํํ๋ฉด Scouter Java Agent๋ฅผ ์คํํ์ฌ Jira์ ๋ํ ๋ชจ๋ํฐ๋ง์ด ๊ฐ๋ฅํ๋ค.
[Target Scouter Server ํ์ ๊ธฐ์ค] IP Address : TCP Port
3. [Save] ๋ฒํผ์ ํด๋ฆญํ์ฌ ์ ์ฅํ๋ค.
Jira์ ์ฐ๋๋ Scouter Server๊ฐ ์กด์ฌํ๋ ๊ฒฝ์ฐ, Jira ์์ธ์กฐํ ์ Scouter Java Agent ํญ์ด ํ์๋๋ฉฐ Scouter Server์ Config File ๊ด๋ฆฌ๊ฐ ๊ฐ๋ฅํ๋ค.
Scouter Java Agent์ ์ ๊ณต๋๋ Config File์ ๋ค์๊ณผ ๊ฐ๋ค.
ํญ๋ชฉ | ์ค๋ช |
---|---|
scouter.conf | Scouter Server์ ํฌํธ ๋ฐ ๊ธฐ๋ณธ ์ค์ |
capture.plug | hook_args_patterns๋ hook_constructor_patterns๋ฑ์ ํตํด ์ค์ ๋จ. method์ ๋ํด ํด๋น method์ ์์ ์์ , ์ข ๋ฃ์์ , Constructor ์์ฑ ์์ ์ ํธ์ถ๋จ |
counter.plug | ์ฑ๋ฅ์นด์ดํฐ ์ ๋ณด์ ๋ํ ์ ์ฒ๋ฆฌ plugin |
httpcall.plug | HttpClient ๋ฑ์ ํตํด http call์ ์ฌ์ฉํ๋ ์์ ์ ํธ์ถ๋จ |
httpservice.plug | Http Service ์์์ , Http Service์ด ์ข ๋ฃ์์ ์ ํธ์ถ๋จ. ํน์ Service๋ ์ฌ์ฉ์๊ฐ ์ ์ํ ์กฐ๊ฑด์ ๋ฐ๋ผ rejectํ ์ ์๋ ๊ธฐ๋ฅ์ ์ ๊ณต |
jdbcpool.plug | DB connection URL ์์ฒญ ์์ ์ ํธ์ถ๋จ |
service.plug | Service์ ์์์ , ์ข ๋ฃ ์์ ์ ํธ์ถ๋จ (hook_service_patterns๋ฅผ ํตํด ์ค์ ๋ ์๋น์ค๊ฐ ๋์์ด ๋จ) |
springControllerCapture.plug | Spring Controller์ ํด๋นํ๋ URL ์์ฒญ์ ํธ์ถ๋จ |
Jira์ ์ฐ๋๋ Scouter Server์ Config File ๊ด๋ฆฌ๋ ๋ค์๊ณผ ๊ฐ์ด ์งํํ๋ค.
1. Scouter Java Agent ํญ์ ํด๋ฆญํ๋ฉด ํ์์ ํด๋น๋๋ ํญ์ด ์กฐํ๋๋ค.
2. ๊ฐ ํญ์์ ํ์ผํธ์ง๊ธฐ๋ฅผ ํตํด Config ํ์ผ์ ํธ์งํ ์ ์๋ค.
3. ๋ํ Config ํ์ผ์ ๋ฒ์ ๋ณ ๋น๊ต ๋ฐ ๋ณต์๋ ๊ฐ๋ฅํ๋ค.
Jira ์ ์ด
- [Action > Start] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira๋ฅผ ์์ํ๋ค.
- [Action > Stop - Force] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira๋ฅผ ์ข ๋ฃํ๋ค.
- [Action > Shutdown - Gracefully] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira๋ฅผ ์์ ํ๊ฒ ์ข ๋ฃํ๋ค.
- [Action > Restart - Force] ๋ฒํผ์ ํด๋ฆญํ์ฌ Jira๋ฅผ ๊ฐ์ ์ฌ์์ํ๋ค.
์ฐธ๊ณ
[Start], [Stop - Force], [Shutdown - Gracefully], [Restart] ๋ฒํผ ๋ชจ๋ ๊ฐ๋ฅํ ์ํ์ผ ๊ฒฝ์ฐ์๋ง ๋ฒํผ์ด ํ์ฑํ ๋๋ค.
- [Start] ๋ฒํผ์ Jira๊ฐ Stopped ์ํ์ผ ๋๋ง ์คํ ๊ฐ๋ฅ
- [Stop - Force], [Shutdown - Gracefully] ๋ฒํผ์ Jira๊ฐ Running ์ํ์ผ ๋๋ง ์คํ ๊ฐ๋ฅ
- [Restart] ๋ฒํผ์ Jira๊ฐ Running, Stopped ์ํ ๋ชจ๋ ์คํ ๊ฐ๋ฅ
Jira ๋ฐ๋ก๊ฐ๊ธฐ
1 . Atlassian Server ๋ชฉ๋ก์์ [Jira ] ๋ฒํผ์ ํด๋ฆญํ๋ค.
2. Server Link์ ์ ๋ ฅ๋ ์ฃผ์๋ก ์ ๊ทผํ์ฌ Jira๋ฅผ ์ฌ์ฉํ ์ ์๋ค.
Log View
1 . Atlassian Server ๋ชฉ๋ก์์ Jira์ [View] ๋ฒํผ์ ํด๋ฆญํ๋ฉด ํ์ธ ๊ฐ๋ฅํ Log ํ์ผ์ ๋ชฉ๋ก์ด ํ์ถ๋๋ค.
2. Log ํ์ผ์ ํ์ธํ ์ ์๋ Log View ํ์ ์ฐฝ์ด ์ถ๋ ฅ๋๋ค.
Copyright ยฉ 2021 Open Source Consulting, Inc. All Rights Reserved.