Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

배포(Deployment)를 Jira와 통합

배포 기능은 시간 규모에 따라 Jira 문제에 대한 Git 파이프 라인을 추적하고 표시하여 배포에 대한 가시성을 높입니다. 배포 파이프 라인을 통해 이동하는 작업 항목의 진행 상황을 시각화할 수 있습니다.

배포 기능을 활성화하려면 먼저 Jira Software를 배포 또는 CI/CD 공급자와 통합해야 합니다.

클래식 소프트웨어 프로젝트에 대한 배포 활성화

프로젝트 관리자만 프로젝트에서 기능을 활성화 및 비활성화 할 수 있습니다.

  1. 클래식 소프트웨어 프로젝트로 이동

  2. 프로젝트 설정 > 배포로 이동

  3.  배포 기능 활성화

새 메뉴 항목인  Deployments가 프로젝트 메뉴에 추가됩니다.

배포보기 이해

배포보기는 다음 필터 및 설정과 함께 제공됩니다.

  • 검색 : 이 텍스트 필터에서 관심있는 이슈 및 관련 배포 파이프 라인을 표시할 키워드를 지정합니다.

  • Environment : 이 필터를 사용하여 드롭다운에서 환경을 선택하여 배포 보기를 개발 인스턴스에 집중합니다.

  • Epic : 이 필터를 사용하여 배포 및 이슈를 에픽별로 그룹화할 수 있습니다. 상위 에픽이 없는 이슈도 필터링할 수 있습니다.

  • Type : 이 필터를 사용하여 이슈를 유형별로 정렬할 수 있습니다.

  • Export : 이 버튼을 사용하여 CSV 파일로 배포 보기를 다운로드할 수 있습니다. 선택한 필터를 기반으로 정보가 CSV 파일로 내보내집니다. 이 CSV 파일을 Microsoft Excel 또는 Google Sheets로 추가로 가져올 수 있습니다. 예를 들어 샘플 CSV 파일을 참조하십시오.

 

  • Deployments Settings : 이 창에서는 환경 유형, 아이콘 및 이슈와 같은 하위 메뉴를 사용하여 배포보기를 구성할 수 있습니다. 이 창의 정보를 사용하여 배포 기능을 비활성화 할 수도 있습니다.

    • Environment types : 환경 유형을 통해 배포보기를 사용자 지정합니다. 시간 규모에 따른 배포 상태를 시각화하기 위해 보기를 수정하려면 환경 유형을 선택합니다.

    • 아이콘

      • 배포 키 : 시간 척도에서 배포 상태를 숨기거나 표시합니다.

      • 다중 배포 : 프로젝트 타임 라인에서 각 이슈에 해당하는 배포 환경 수를 숨기거나 표시합니다.

    • 이슈

      • 배포없이 이슈 표시 : 배포와 관련이 없는 이슈를 숨기거나 표시합니다.

 

프로젝트에 저장소 연결

코드 기능은 프로젝트에서 팀의 코드 리포지토리를 자동으로 연결하고 표시하여 팀의 작업에 대한 가시성을 높입니다.

클래식 소프트웨어 프로젝트를 위한 코드 활성화

프로젝트 관리자만 프로젝트에서 기능을 활성화 및 비활성화 할 수 있습니다.

  1. 클래식 소프트웨어 프로젝트로 이동

  2. 프로젝트 설정 > 코드로 이동

  3.  코드 기능 활성화

새 메뉴 항목인  Code가 프로젝트 메뉴에 추가됩니다.

팀의 저장소 연결

코드 기능을 사용하려면 Jira Software를 Bitbucket 또는 기타 소스 코드 관리 도구에 연결해야합니다.

코드 화면에는 현재 프로젝트와 관련된 팀이 작업하는 저장소 목록이 표시됩니다.

 스마트 커밋으로 이슈 처리

Bitbucket 또는 GitHub에서 프로젝트의 리포지토리를 관리하거나 Fisheye를 사용하여 리포지토리를 탐색하고 검색할 때 커밋 메시지에서 Smart Commits라는 특수 명령을 사용하여 Jira Software 이슈를 처리할 수 ​​있습니다 .

다음을 수행할 수 있습니다.

  • 이슈에 대한 의견

  • 이슈에 대한 시간 추적 정보 기록

  • Jira Software 프로젝트의 워크 플로우에 정의된 모든 상태로 이슈 전환

Smart Commit 명령은 둘 이상의 행에 걸쳐서는 안 되지만(즉, 명령에서 캐리지 리턴을 사용할 수 없음) 동일한 행에 여러 개의 명령을 추가할 수 있습니다. 아래 예제를 참조하십시오.

스마트 커밋 명령어

스마트 커밋 메시지의 기본 구문은 다음과 같습니다:

<무시된 텍스트> <ISSUE_KEY> <무시된 텍스트> #<COMMAND> <optional COMMAND_ARGUMENTS>

이슈 키와 명령 사이의 텍스트는 무시됩니다.

스마트 커밋 메시지에서 사용할 수 있는 세 가지 명령은 다음과 같습니다:

  • comment

  • time

  • transition

Comment

설명

Jira Software 이슈에 주석을 추가합니다 .

구문

<무시된 텍스트> <ISSUE_KEY> <무시된 텍스트> #comment <comment_string>

비고

커미터의 이메일 주소는 특정 프로젝트의 이슈에 대해 댓글을 달 수 있는 권한이 있는 단일 Jira Software 사용자의 이메일 주소와 일치해야 합니다 .

Time

설명

 이슈에 대한 시간 추적 정보를 기록합니다.

구문

<무시된 텍스트> <ISSUE_KEY> <무시된 텍스트> #time <값>w <값>d <값>h <값>m <comment_string>

비고

이 예에서는 이슈에 대해 1주, 2일, 4시간 및 30분을 기록하고 이슈의 작업 로그 탭에 '기록된 총 작업 수'라는 주석을 추가합니다.

  • w,d,hm값은 소수점일 수 있습니다.

  • 주석은 #comment 명령을 사용할 필요 없이 자동으로 추가됩니다.

  • 커미터의 이메일 주소는 이슈에 대한 작업을 기록할 권한이 있는 단일 Jira Software 사용자 의 이메일 주소와 일치해야 합니다.

  • 시스템 관리자는 Jira Software 인스턴스에서 시간 추적을 활성화해야 합니다.

Workflow transitions

설명

Jira Software 이슈를 특정 워크플로우 상태로 전환합니다.

구문

<무시된 텍스트> <ISSUE_KEY> <무시된 텍스트> #<transition_name> #comment <comment_string>

비고

이 예에서는 이슈에 대한 근접 이슈 워크플로우 전환을 실행하고 이슈에 '오늘 수정' 주석을 추가합니다.  

이 구문에는 몇 가지 예외가 있습니다:

  • Jira 관리자가 설명을 필수 필드로 설정한 경우 명령에 #comment를 추가해서는 안 됩니다.

  • 다른 필드가 필요에 따라 설정된 경우 전환 명령이 자동으로 실패합니다.

Jira Software 이슈를 방문하여 Smart Commits에서 사용할 수 있는 사용자 지정 명령을 확인할 수 있습니다:

  1. 프로젝트 > 이슈

  2. 워크플로우 보기 클릭

스마트 커밋은 첫 번째 공백 앞의 전환 이름 부분만 고려합니다. 따라서 finish work 와 같은 전환 이름의 경우 #finish를 지정하는 것으로 충분합니다. 전환 이름이 모호할 수있는 경우 공백을 대체하려면 하이픈을 사용해야합니다. (예: #finish-work)

워크플로우에 다음과 같은 두 가지 유효한 전환 사항이 있는 경우:

  • 진행 시작

  • 검토 시작

#start 동작의 스마트 커밋은 두 가지 전환 중 하나를 의미할 수 있기 때문에 모호합니다. 이러한 두 가지 전환 중 하나를 지정하려면 #start-review 또는 #start-progress를 사용하여 원하는 전환을 완전히 검증합니다.

  • #resolve 명령으로 이슈를 해결할 때 스마트 커밋으로 해결 필드를 설정할 수 없습니다.

  • 커미터의 이메일 주소는 이슈 전환에 대한 프로젝트 권한이 있는 단일 Jira Software 사용자의 이메일 주소와 일치해야 합니다.

이슈에 대한 개발 정보보기

관리자가 Jira Software를 호환되는 개발 도구에 연결한 경우 이슈 보기 화면에 개발 패널이 표시됩니다. Jira Software가 연결되는 도구에 따라 개발 패널은 다음과 같은 기능을 제공합니다.

  • Bitbucket Cloud 또는 Bitbucket Server : 브랜치 보기 및 생성, 커밋 보기, 꺼내기 요청 보기 및 생성, Bitbucket Pipeline 빌드 보기(배포는 릴리스 패널에 표시됨)

  • Fisheye/Crucible(Git/Subversion/Perforce/CVS) : 브랜치 보기(생성 불가), 커밋 보기, 검토 보기 및 작성

  • Bamboo : 빌드 및 배포 상태 보기(Bitbucket Pipeline 배포가 릴리스 패널에 표시됨)

  • GitHub 또는 GitHub Enterprise : 브랜치 보기(생성 불가), 커밋 보기, 꺼내기 요청 보기 및 생성

  • 관리자는 Jira Software 및 개발 도구를 올바르게 설정해야합니다. 

  • 사용자는 개발 패널을 볼 수 있는 권한이 있어야합니다.

  • 개발 패널에 링크로 표시하려면 커밋, 브랜치, 꺼내기 요청 등에서 이슈 키를 참조해야 합니다.

개발 패널보기

모든 것이 올바르게 설정된 경우 아래 스크린샷과 유사하게 각 이슈에 대한 개발 패널이 표시됩니다. 개발 패널은 이슈의 개발 상태를 한눈에 평가할 수 있는 충분한 정보를 제공합니다.

  1. 개발 패널 : 브랜치, 커밋 및 꺼내기 요청 위로 마우스를 가져 가면 마지막 업데이트 날짜를 확인할 수 있습니다.

꺼내기 요청 상태값 :

  • OPEN 하나 이상의 열린 꺼내기 요청이 있는 경우

  • MREGED 열려 있는 꺼내기 요청이 없고 하나 이상의 꺼내기 요청이 병합된 경우

  • DECLINED 열려 있거나 병합된 꺼내기 요청이 없고 하나 이상의 꺼내기 요청이 거부된 경우

검토 상태값 :

  • REVIEW '검토' 상태에 적어도 하나의 검토가 있는 경우(노란색 바탕에 검은 글씨)

  • APPROVAL '검토'상태에서 검토가 없는 경우, '승인'상태일 경우(검은색)

  • SUMMARIZE '검토' 또는 '승인' 상태의 검토가 없고 '요약' 상태의 검토가 하나 이상 있는 경우(검은색)

  • REJECTED '검토', '승인' 또는 '요약' 상태에 검토가 없고 '거부' 상태에 있는 검토가 하나 이상 있는 경우(빨간색)

  • APPROVAL 모든 ‘검토'가 '닫힘’ 상태일 경우

참고로, 'Draft' 및 'Abandoned' 리뷰는 표시되지 않습니다.

빌드 상태값 :

  • (tick) 여러 빌드(예: 장치 테스트, 기능 테스트, 스테이징에 배포)가 모두 통과된 경우

  • ❗ 연결된 빌드 서버에서 빌드에 대해 하나 이상의 실행이 실패한 경우

정보 조사 및 조치

개발 패널에서 항목을 조사하려면 항목을 클릭하여 자세한 정보가 포함된 대화 상자를 표시할 수 있습니다. 대화 상자에는 작업을 수행하거나 드릴다운할 수 있는 링크가 있습니다. 먼저 연결된 응용 프로그램으로 인증하라는 메시지가 나타날 수 있습니다.

예를 들어, 개발 패널에 다음과 같은 표시가 나타났다고 가정해 보겠습니다: 3 builds ❗. 3 builds를 클릭하여 세 개의 빌드 중 어떤 빌드가 문제인지 보여주는 대화 상자를 열 수 있습니다. 추가 조사를 원하면 클릭하여 빌드 도구에서 확인할 수 있습니다.

개발 패널을 통해 수행 할 수있는 작업은 다음과 같습니다:

기능 브랜치 만들기

BITBUCKET

개발 패널에서 브랜치 생성을 클릭하여 연결된 SCM을 열고 브랜치 생성 프로세스를 시작합니다. 여러 애플리케이션이 연결된 경우 브랜치를 생성할 위치를 선택할 수 있습니다. Jira 이슈에 대한 키가 브랜치 이름에 자동으로 추가됩니다.

리포지토리 브랜치보기

BITBUCKET FISHEYE GITHUB

개발 패널에서 n 개의 브랜치를 클릭하여 연결된 SCM에 대한 브랜치를 표시하는 대화 상자를 Jira Software에서 엽니다. Jira Software가 둘 이상의 SCM에 연결된 경우 각 SCM 제품(예: Bitbucket)에 대한 탭이 표시됩니다. 이러한 탭의 각 SCM 아래에 브랜치가 그룹화됩니다.

  • 리포지토리 또는 브랜치를 클릭하여 연결된 SCM을 관련 리포지토리/브랜치에서 엽니다.

  • 꺼내기 요청 상태(예: MERGED) 위에 마우스를 올려 놓으면 꺼내기 요청에 대한 링크가 표시되는 팝업이 표시됩니다.

  • 꺼내기 요청 생성을 클릭하여 브랜치에 대한 꺼내기 요청을 만듭니다(마스터로 다시 병합).

리포지토리 커밋 보기

BITBUCKET FISHEYE GITHUB

개발 패널에서 n 커밋을 클릭하여 연결된 SCM에 대한 커밋 및 관련 파일을 표시하는 대화 상자를 Jira Software에서 엽니다. Jira Software가 둘 이상의 SCM에 연결된 경우 각 SCM 제품(예: Bitbucket)에 대한 탭이 표시됩니다. 커밋은 이 탭의 각 SCM 아래에 그룹화됩니다. 커밋이 회색으로 표시되면 꺼내기 요청을 통해 병합된 것입니다.

  • 리포지토리를 클릭하거나 커밋하여 관련 리포지토리/브랜치에서 SCM을 엽니다.

  • Jira Software가 둘 이상의 SCM에 연결된 경우 대화 상자에 탭에 중복 커밋이 표시될 수 있습니다. 예를 들어, Fisheye와 Bitbucket을 동일한 리포지토리로 가리켰을 수 있습니다.

  • (비트 버킷만 해당) 커밋이 리포지토리의 포크에 속하는 경우 해당 커밋이 포크 아래에 그룹화됩니다. 또한 포크는 원래 리포지토리인 “Fork of <리포지토리 이름>”에 대한 링크도 갖게 됩니다.

꺼내기 요청 생성

BITBUCKET GITHUB

위의 '리포지토리 브랜치보기' 섹션을 참조하십시오.

꺼내기 요청 상태 보기

BITBUCKET GITHUB

개발 패널에서 n 꺼내기 요청을 클릭하여 연결된 SCM에 대한 꺼내기 요청을 표시하는 Jira Software 대화 상자를 엽니다. Jira Software가 둘 이상의 SCM에 연결된 경우 각 SCM 제품(예: Bitbucket)에 대한 탭이 표시됩니다. 꺼내기 요청은 이 탭의 각 SCM 아래에 그룹화됩니다.

  • 꺼내기 요청을 클릭하여 연결된 SCM에서 엽니다.

  • 사용자 아이콘 위로 마우스를 가져가면 사용자 이름이 표시됩니다.

리뷰 상태 확인

CRUCIBLE

개발 패널에서 n개의 리뷰를 클릭하여 Jira Software에서 리뷰를 보여주는 대화 상자를 엽니다.

  • 검토 내용을 클릭하여 Crucible에서 엽니다.

빌드 상태 확인

BAMBOO PIPELINES

개발 패널에서 n 빌드를 클릭하여 빌드를 표시하는 대화 상자를 Jira Software에서 엽니다.

  • 자세한 정보가 필요한 경우 빌드 도구로 이동할 링크를 클릭할 수 있습니다.

배포 상태 확인

BAMBOO

개발 패널에서 배포됨(환경)을 클릭하여 배포를 보여주는 대화 상자를 Jira Software에서 엽니다.

  • 환경 또는 릴리스를 클릭하여 Bamboo로 표시합니다.


이슈에 대한 릴리스 정보 보기


관리자가 Jira Software를 호환되는 릴리스 도구에 연결한 경우 이슈 보기 화면에 릴리스 패널이 표시됩니다. Jira Software가 연결된 도구에 따라 릴리스 패널은 다음 기능을 제공합니다.

  • Bitbucket Cloud : 파이프라인 배포(브랜치 보기 및 생성, 커밋 보기, 꺼내기 요청 보기 및 생성)

  • LaunchDarkly 또는 Rollout : 릴리스 상태(기능 플래그 수, 사용 가능한 상태, 고객 비율 및 규칙이 적용된 상태)

릴리스 패널 보기

모든 것이 올바르게 설정되면 아래 스크린샷과 유사하게 이슈에 대한 릴리스 패널이 표시됩니다. 릴리스 패널은 이슈 릴리스의 상태를 한눈에 평가할 수 있는 충분한 정보를 제공합니다. 이를 통해 코드가 배포되었는지, 그리고 고객에게 아직 활성화 되지 않았는지 쉽게 확인할 수 있습니다.

  1. 모든 배포가 요약으로 롤업됩니다(자세한 내용을 보려면 클릭).

  2. 기능 플래그가 이름별로 나열되고 일부 기본 요약 정보가 표시됩니다(이름을 클릭하면 플래그 공급자로 이동).

배포 상태값 :

  • 🔄 보류 중 또는 진행 중

  • (tick) 성공

  • ❗ 실패

  • ⏪ 롤백

  • (question) 알 수 없는

정보 조사 및 조치

릴리스 패널에서 항목을 조사하려면 항목을 클릭하여 자세한 정보를 표시할 수 있습니다.

배포

릴리스 패널에서 배포를 클릭하면 자세한 정보가 표시되지만 Bitbucket에서 보려면 파이프라인 번호를 클릭할 수도 있습니다.

형상 플래그

기능 플래그 상태에 대한 자세한 정보를 얻을 수 있는 두 가지 방법은 다음과 같습니다:

  • 플래그 위에 마우스를 올려 놓으면 플래그와 관련된 상태(예: 롤아웃 비율)를 빠르게 확인할 수 있습니다.

  • 공급자 사이트의 플래그로 직접 이동하려면 이름을 클릭합니다.

  • No labels