Jira - Docker를 사용하여 설치 및 구성

설치하기 전에 사전 준비 사항과 Docker를 사용한 설치에 대한 일반 지침을 검토하십시오.

이 통합은 온프레미스(On-premise) Jira 배포와 안전한 연결을 보장하는 데 유용합니다.

Jira에 사용할 Broker 구성

Jira 배포에서 Broker 클라이언트를 사용하려면 docker pull snyk/broker:jira를 실행하십시오. 환경 변수의 정의는 Jira - Snyk Broker용 환경 변수를 참조하십시오.

Jira용 Broker 클라이언트 설정을 위한 Docker 실행 명령

지역별 멀티 테넌트 설정 설치 시 스크립트에 BROKER_SERVER_URL을 설정하는 명령을 추가해야 합니다. 이는 데이터가 호스팅되는 지역의 Broker 서버 URL입니다. 사용할 명령과 URL은 Broker URL을 참조하십시오.

다음 명령을 복사하여 Jira와 함께 사용할 전체 구성이 완료된 Broker 클라이언트를 설정하십시오. 관련 구성을 제공하여 Docker 컨테이너를 실행할 수 있습니다.

docker run --restart=always \
           -p 8000:8000 \
           -e BROKER_TOKEN=secret-broker-token \
           -e BROKER_SERVER_URL=<broker-region-url> \
           -e JIRA_USERNAME=username \
           -e JIRA_PASSWORD=password \
           -e JIRA_HOSTNAME=your.jira.domain.com \
           -e BROKER_CLIENT_URL=http://my.broker.client:8000 \
           -e PORT=8000 \
       snyk/broker:jira

필요한 경우 Snyk Broker Docker 설치를 위한 고급 구성으로 이동하여 Jira 인스턴스가 개인 인증서를 사용하는 경우 Broker 클라이언트 구성에 CA(인증 기관)를 제공하는 등 필요한 구성을 변경하십시오.

SSO가 활성화된 JIRA를 위한 Jira PAT 인증

SSO가 활성화된 경우, JIRA는 일반적으로 사용자 이름과 비밀번호 사용을 금지하고 개인 접근 토큰(PAT, Personal Access Token) 사용을 요구합니다.

SSO가 활성화된 경우, 대신 베어러 토큰(Bearer token)이 포함된 인증 헤더를 사용하는 특정 Jira 버전을 사용해야 합니다. 이 버전을 사용하려면 다음 구성을 제공하십시오.

docker run --restart=always \
           -p 8000:8000 \
           -e BROKER_TOKEN=secret-broker-token \
           -e JIRA_PAT=<your_pat_token> \
           -e JIRA_HOSTNAME=your.jira.domain.com \
           -e BROKER_CLIENT_URL=http://my.broker.client:8000 \
           -e PORT=8000 \
       snyk/broker:jira-bearer-auth

Broker 클라이언트 컨테이너 시작 및 Jira 연결 확인

Broker 클라이언트 구성을 붙여넣어 Broker 클라이언트 컨테이너를 시작하십시오.

컨테이너가 설정되고 Jira 통합 페이지에 Jira 연결이 표시되면 프로젝트(Projects) 아래에서 Jira 티켓을 생성할 수 있습니다.

Jira용 Broker 기본 문제 해결

• docker logs <container id>를 실행하여 오류를 확인하십시오. 여기서 container id는 Jira Broker 컨테이너 ID입니다.

• 관련 포트가 Jira에 노출되어 있는지 확인하십시오.