Google Cloud에 Jira 배포

이 가이드에서는 MySQL 데이터베이스인 Cloud SQL과 Compute Engine을 사용하여 Google Cloud에 Atlassian Jira Server Edition을 배포하는 방법을 보여줍니다.

목표

  • Linux Ubuntu 가상 머신을 만들어 Jira 버전 8.8.1을 설치합니다.
  • Jira가 연결할 MySQL용 Cloud SQL 버전 5.7 인스턴스를 만듭니다.
  • Jira를 서비스로 실행되도록 구성합니다.
  • HTTPS를 사용하여 Jira 서비스에 대한 액세스를 사용 설정합니다.

비용

이 가이드에서는 비용이 청구될 수 있는 다음과 같은 Google Cloud 구성요소를 사용합니다.

  • Compute Engine
  • Cloud SQL
  • Cloud Load Balancing
  • Networking

가격 계산기를 사용하면 예상 사용량을 기준으로 예상 비용을 산출할 수 있습니다.

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  3. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Compute Engine and Cloud SQL Admin API를 사용 설정합니다.

    API 사용 설정

또한 다음 요구사항을 충족하는지 확인합니다.

  • Jira Server Edition에 대한 평가판 또는 정품 라이선스 키가 있는지 확인합니다.
  • Jira 사이트에 등록된 도메인 이름이 있는지 확인합니다.

이 가이드를 마치면 만든 리소스를 삭제하여 비용이 계속 청구되지 않도록 할 수 있습니다. 자세한 내용은 삭제를 참조하세요.

배포 아키텍처

다음 다이어그램은 Jira를 설치하는 데 사용하는 배포 구조를 보여줍니다. 주 Jira 애플리케이션 서버는 Compute Engine 인스턴스에서 실행됩니다. 이 인스턴스는 Jira와 동일한 가상 머신에서 실행되는 Cloud SQL 프록시 도구를 사용하여 MySQL용 Cloud SQL의 인스턴스에 안전하게 연결됩니다.

Google Cloud에서의 JIRA 배포 아키텍처

환경 설정

이 섹션에서는 가이드를 완료하는 데 필요한 인프라 및 ID를 구성합니다.

Cloud Shell 인스턴스 시작

Cloud Shell에서 이 가이드의 모든 터미널 명령어를 실행합니다.

서비스 계정 구성

다음 단계는 서비스 계정을 만들고 Jira가 Cloud SQL의 데이터에 액세스할 수 있도록 Jira에 권한을 위임하는 것입니다.

  1. Cloud Shell에서 서비스 계정을 만듭니다.

    gcloud iam service-accounts create jira-service-account \
        --display-name jira-service-account
    
  2. 이후에 명령어에서 사용할 수 있도록 서비스 계정 이메일 주소, 현재 프로젝트 ID, 기본 영역을 환경 변수에 저장합니다. [ZONE]에는 지리적으로 가장 가까운 영역을 선택합니다.

    export SA_EMAIL=$(gcloud iam service-accounts list \
        --filter="displayName:jira-service-account" \
        --format='value(email)')
    export PROJECT=$(gcloud info \
        --format='value(config.project)')
    export ZONE=[ZONE]
    

    영역 목록을 보려면 다음 명령어를 실행하세요.

    gcloud compute zones list
    
  3. 서비스 계정에 roles/cloudsql.client 역할을 결합합니다.

    gcloud projects add-iam-policy-binding $PROJECT \
        --role roles/cloudsql.client \
        --member serviceAccount:$SA_EMAIL
    

MySQL용 Cloud SQL 인스턴스 만들기

이 가이드에서는 Jira가 MySQL 데이터베이스를 사용하도록 설정합니다. MySQL을 직접 설치하기보다는 MySQL의 관리형 버전을 제공하는 Cloud SQL을 사용합니다.

  1. Cloud Shell에서 MySQL 데이터베이스를 사용하여 Cloud SQL의 인스턴스를 만듭니다. 다음 명령어는 인스턴스 이름으로 mysql-jira-instance를 사용합니다. 다른 이름을 사용할 수도 있습니다. 이후 단계에서 이 이름이 필요하므로 사용한 이름을 적어 두세요.

    gcloud sql instances create mysql-jira-instance \
        --database-version MYSQL_5_7 --zone $ZONE \
        --database-flags \
        character_set_server=utf8mb4,sql_mode=STRICT_TRANS_TABLES
    

    새 인스턴스 속성이 표시됩니다.

    NAME                 DATABASE_VERSION  LOCATION    TIER              STATUS
    mysql-jira-instance  MYSQL_5_7         us-east1-d  db-n1-standard-1  RUNNABLE
    
  2. root@% MySQL 사용자의 비밀번호를 설정합니다. Cloud SQL 인스턴스에 mysql-jira-instance라는 이름을 사용하지 않았으면 이전에 사용한 이름을 사용해야 합니다. [PASSWORD]를 안전한 비밀번호로 바꿉니다.

    gcloud sql users set-password root \
        --host=% --instance=mysql-jira-instance --password=[PASSWORD]
    

Compute Engine 인스턴스 및 인스턴스 그룹 만들기

Compute Engine 인스턴스를 만들어 Jira를 배포한 후 인스턴스 그룹에 새 인스턴스를 추가합니다. 이렇게 하면 이후 단계에서 HTTPS 부하 분산기를 사용할 수 있습니다.

Compute Engine 인스턴스 만들기

이 가이드에서는 n1-standard-1의 기본 머신 유형을 사용합니다.

  • Cloud Shell에서 Jira Software를 설치할 수 있는 Compute Engine 인스턴스를 만듭니다. 이 가이드에서는 인스턴스 이름을 jira-instance로 지정합니다.

    gcloud config set compute/zone $ZONE
    
    gcloud compute instances create jira-instance \
        --image-family ubuntu-1804-lts \
        --image-project gce-uefi-images \
        --tags=jira-server \
        --service-account $SA_EMAIL \
        --scopes cloud-platform
    

    새 인스턴스 속성이 표시됩니다.

    NAME           ZONE        MACHINE_TYPE   PREEMPTIBLE    STATUS
    jira-instance  us-east1-d  n1-standard-1                 RUNNING
    

Jira의 운영체제 및 머신 유형에 대한 자세한 내용은 다음 Atlassian 페이지를 참조하세요.

인스턴스 그룹을 만들고 Compute Engine 인스턴스 추가

이제 인스턴스 그룹을 만들고 jira-instance 가상 머신을 추가할 수 있습니다.

  1. Cloud Shell에서 인스턴스 그룹을 만듭니다.

    gcloud compute instance-groups unmanaged create jira-resources \
        --zone $ZONE
    
  2. Compute Engine 인스턴스를 인스턴스 그룹에 추가합니다.

    gcloud compute instance-groups unmanaged add-instances jira-resources \
        --instances jira-instance \
        --zone $ZONE
    

Jira Software 설치

이 섹션에서는 Compute Engine 인스턴스를 구성하고 Jira 설치를 완료합니다.

Compute Engine 인스턴스에 연결

인스턴스 설정을 구성하려면 인스턴스에 대한 SSH 연결을 설정해야 합니다.

  • Cloud Shell에서 인스턴스에 연결합니다.

    gcloud compute ssh jira-instance
    

    Compute Engine은 SSH 키를 생성하고 생성된 키를 프로젝트 또는 인스턴스 메타데이터에 추가합니다.

필수 패키지 설치

이후 단계에서 Jira 및 MySQL을 사용하는 데 필요한 도구를 Compute Engine 인스턴스에 설치해야 합니다.

  1. 인스턴스의 명령줄에서 wget을 설치합니다.

    sudo apt-get install wget
    
  2. 인스턴스에 MySQL 클라이언트를 설치합니다.

    sudo apt-get install mysql-client
    

소프트웨어 설치 프로그램을 다운로드하고 Jira 소프트웨어 설치

  1. 인스턴스의 명령줄에서 Atlassian의 Jira Software 설치 프로그램을 다운로드합니다.

    wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.8.1-x64.bin
    
  2. 설치 프로그램 파일을 실행 가능하게 만듭니다.

    chmod a+x atlassian-jira-software-8.8.1-x64.bin
    
  3. 설치 프로그램을 실행합니다. 설치 프로세스 중에 Jira를 서비스로 설치하는 옵션을 제공하는 sudo를 사용하여 이 단계를 수행해야 합니다.

    sudo ./atlassian-jira-software-8.8.1-x64.bin
    

    메시지가 표시되면 종속 항목을 설치합니다.

  4. 설치 프로세스 중에 다음 값을 입력합니다.

    • Installation option(설치 옵션): Custom Install 선택(옵션 2)
    • Installation directory(설치 디렉터리): /opt/atlassian/jira
    • Software data directory(소프트웨어 데이터 디렉터리): /var/atlassian/application-data/jira
    • TCP ports(TCP 포트): HTTP: 8080, Control(제어): 8005
    • Install as service(서비스로 설치): y
    • Start Jira(Jira 시작): no 아직 남아 있는 단계가 있으므로 Jira를 아직 시작하지 않는 것이 좋습니다.
  5. 설치 프로그램 파일을 삭제하여 정리합니다.

    rm atlassian-jira-software-8.8.1-x64.bin
    

MySQL용 Cloud SQL에 대한 Jira 연결 구성

이 섹션에서는 MySQL 클라이언트를 사용하여 Jira에서 사용하는 데이터베이스인 MySQL용 Cloud SQL에 연결하는 방법을 설명합니다.

MySQL 커넥터/J 다운로드

Jira는 JDBC 데이터베이스 연결을 사용하여 데이터베이스에 연결합니다. MySQL 커넥터는 MySQL용 공식 JDBC 드라이버입니다. 이 가이드에서는 MySQL 커넥터 버전 5.1.48을 사용합니다.

  1. Jira 인스턴스의 명령줄에서 커넥터를 다운로드합니다.

    wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.48.tar.gz
    
  2. tar 파일 압축을 풉니다.

    tar -xzf mysql-connector-java-5.1.48.tar.gz
    
  3. 파일을 /opt/atlassian/jira/lib에 복사합니다.

    sudo cp ./mysql-connector-java-5.1.48/mysql-connector-java-5.1.48-bin.jar /opt/atlassian/jira/lib/.
    
  4. tar 파일을 삭제하여 정리합니다.

    rm -rf mysql-connector-java-5.1.48d \
    mysql-connector-java-5.1.48.tar.gz
    

Compute Engine 인스턴스에 Cloud SQL 프록시 설치

Cloud SQL 프록시는 MySQL 인스턴스용 Cloud SQL에 대한 보안 액세스를 제공합니다.

  1. 인스턴스의 명령줄에서 프록시를 다운로드합니다.

    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. 프록시 실행 파일을 만듭니다.

    chmod +x cloud_sql_proxy
    
  3. 프록시 바이너리를 로컬 디렉토리에 복사합니다.

    sudo cp cloud_sql_proxy /usr/local/bin/.
    

Jira를 서비스로 실행하기

Jira를 서비스로 실행하면 컴퓨터가 다시 시작될 때마다 Jira가 자동으로 시작됩니다.

  1. 인스턴스의 명령줄에서 cloud_sql_proxy.service라는 새 파일을 만듭니다. 예를 들어 다음 vi 명령어를 사용하여 cloud_sql_proxy.service 파일을 만듭니다.

    sudo vi /lib/systemd/system/cloud_sql_proxy.service
    
  2. 파일에 다음 구성을 추가합니다. [PROJECT_ID]를 Google Cloud 프로젝트 ID로 바꾸고 [REGION]을 사용 중인 리전(예: us-east1)으로 바꿉니다. Cloud SQL 인스턴스에 mysql-jira-instance라는 이름을 사용하지 않았다면 이름을 바꿉니다.

    [Unit]
    Description=Google Cloud SQL Proxy
    After=network.service
    
    [Service]
    User=root
    Type=forking
    WorkingDirectory=/usr/local/bin
    ExecStart=/bin/sh -c '/usr/bin/nohup /usr/local/bin/cloud_sql_proxy -instances=[PROJECT_ID]:[REGION]:mysql-jira-instance=tcp:3306 &'
    RemainAfterExit=yes
    StandardOutput=journal
    KillMode=process
    
    [Install]
    WantedBy=multi-user.target
    
  3. 저장하고 파일을 닫습니다.

  4. jira.service라는 새 파일을 만듭니다.

    sudo vi /lib/systemd/system/jira.service
    
  5. 파일에 다음 구성을 추가합니다.

    [Unit]
    Description=JIRA Service
    Requires=cloud_sql_proxy.service
    After=network.target iptables.service firewalld.service httpd.service
    
    [Service]
    Type=forking
    User=root
    ExecStart=/opt/atlassian/jira/bin/start-jira.sh
    ExecStop=/opt/atlassian/jira/bin/stop-jira.sh
    ExecReload=/opt/atlassian/jira/bin/stop-jira.sh | sleep 60 | /opt/atlassian/jira/bin/stop-jira.sh
    
    [Install]
    WantedBy=multi-user.target
    
  6. 저장하고 파일을 닫습니다.

  7. Jira를 설치할 때 생성된 SysV 스크립트를 삭제합니다.

    sudo rm /etc/init.d/jira
    
  8. Jira 및 Cloud SQL 프록시 서비스를 사용 설정합니다.

    sudo systemctl daemon-reload
    sudo systemctl enable jira
    sudo systemctl enable cloud_sql_proxy
    
  9. 서비스를 시작합니다.

    sudo systemctl start jira
    

    Jira 서비스만 시작하면 됩니다. 프록시 서비스는 Jira 서비스에 종속되며 Jira 서비스가 시작된 후 자동으로 시작됩니다.

  10. 서비스 상태를 확인합니다.

    sudo systemctl status jira
    sudo systemctl status cloud_sql_proxy
    

    상태가 녹색이고 active (running)이 표시되면 서비스가 활성 상태이고 실행 중인 것입니다. 상태가 inactive이면 몇 분 후에 sudo systemctl daemon-reload를 사용하여 서비스를 다시 로드해 봅니다.

MySQL 세션 시작

이 섹션에서는 MySQL 사용자 및 비밀번호를 만드는 방법과 설정 과정에서 Jira를 연결할 MySQL 데이터베이스를 만드는 방법을 보여줍니다.

  1. 인스턴스의 명령줄에서 MySQL 세션을 시작합니다.

    mysql -u root -p --host 127.0.0.1 -P 3306
    

    세션이 준비되면 mysql 프롬프트가 표시됩니다.

  2. 데이터베이스를 만듭니다. [DATABASE_NAME]을 데이터베이스 이름으로 바꿉니다. 이름 지정에 대한 자세한 내용은 MySQL의 데이터베이스 생성 가이드를 참조하세요.

    CREATE Database [DATABASE_NAME] CHARACTER SET utf8 COLLATE utf8_bin;
    
  3. 루트 이외의 사용자를 만들고 사용자의 비밀번호를 설정합니다. [USERNAME]을 사용자 이름으로, [PASSWORD]를 비밀번호로 바꿉니다.

    CREATE USER '[USERNAME]'@'%' IDENTIFIED BY '[PASSWORD]';
    
  4. 사용자에게 모든 권한을 부여합니다.

    GRANT ALL PRIVILEGES ON [DATABASE_NAME] . * TO '[USERNAME]'@'%';
    FLUSH PRIVILEGES;
    
  5. MySQL 세션을 종료합니다.

    EXIT;
    
  6. 인스턴스에 대한 SSH 연결을 닫습니다.

    exit
    

HTTPS 부하 분산기 생성 및 구성

다음 단계는 Jira 인스턴스로 들어오는 트래픽을 보호하기 위해 HTTPS 부하 분산기를 생성하는 것입니다. 작성 시점을 기준으로 HTTPS를 통한 Jira 실행은 Atlassian의 지원 범위에 해당되지 않습니다. 따라서 HTTPS 부하 분산기를 Jira 인스턴스와 함께 사용해야 합니다. HTTPS 구성에 대한 자세한 내용은 Atlassian 사이트의 SSL 또는 HTTPS를 통해 Jira 애플리케이션 실행을 참조하세요.

글로벌 정적 IP 주소 만들기

글로벌 정적 외부 IP 주소는 고객이 부하 분산기에 연결하는 데 사용하는 외부 IP 주소입니다.

  • Cloud Shell에서 부하 분산기에 대한 글로벌 정적 외부 IP 주소를 만드세요.

    gcloud compute addresses create lb-ip --global
    

부하 분산 서비스 구성

다음 단계는 부하 분산기를 구성하는 것입니다.

  1. Cloud Shell에서 이름이 지정된 포트를 만듭니다.

    gcloud compute instance-groups unmanaged set-named-ports jira-resources \
        --named-ports http:8080 \
        --zone $ZONE
    

    포트가 구성되면 부하 분산 서비스가 이름이 지정된 포트로 트래픽을 전달합니다.

  2. 상태 확인을 만듭니다.

    gcloud compute health-checks create tcp jira-health --port 8080
    
  3. jira-health 상태 확인을 사용하여 백엔드 서비스를 만듭니다. 설치 프로세스가 완료될 수 있도록 제한 시간은 300초로 구성됩니다. 설치가 완료된 후 이 값은 30초로 변경됩니다.

    gcloud compute backend-services create jira-app \
        --protocol http \
        --health-checks jira-health \
        --timeout 300 \
        --global
    
  4. 백엔드 서비스에 인스턴스 그룹을 백엔드로 추가합니다.

    gcloud compute backend-services add-backend jira-app \
        --instance-group jira-resources \
        --instance-group-zone $ZONE \
        --global
    
  5. 수신되는 모든 요청이 모든 인스턴스로 전달되는 기본 URL 맵을 만듭니다.

    gcloud compute url-maps create jira-app \
        --default-service jira-app
    

방화벽 규칙 만들기

Jira 서비스 작업에 트래픽을 허용하려면 방화벽을 구성해야 합니다.

  • 부하 분산기에서 jira-instance 인스턴스로 트래픽을 허용하는 방화벽 규칙을 만듭니다.

    gcloud compute firewall-rules create jira-lb-allow \
        --action=ALLOW \
        --rules=tcp:8080 \
        --source-ranges=130.211.0.0/22,35.191.0.0/16 \
        --target-tags=jira-server
    

Google 관리 SSL 인증서 리소스 만들기

HTTPS 트래픽을 지원하려면 SSL 인증서가 필요합니다. 이 섹션에서는 Google 관리 SSL 인증서를 추가합니다. 이 기능은 현재 베타 테스트 중입니다. 다른 SSL 인증서를 사용하려면 SSL 인증서 리소스 만들기를 참조하세요.

Google 관리 SSL 인증서는 만료일 전에 자동으로 갱신됩니다. 갱신 과정에 대한 자세한 내용은 Google 관리 SSL 인증서 리소스 상태를 참조하세요.

  • Cloud Shell에서 Google 관리 SSL 인증서 리소스를 만듭니다. [DOMAIN]을 해당 도메인으로 바꿉니다.

    gcloud beta compute ssl-certificates create jira-cert \
        --domains [DOMAIN]
    

HTTPS 라우팅 구성

이제 Jira 트래픽을 프록시에 보내도록 라우팅을 구성할 수 있습니다.

  1. 대상 HTTPS 프록시를 만들어 요청을 URL 맵으로 라우팅합니다.

    gcloud compute target-https-proxies create https-lb-proxy \
        --url-map jira-app --ssl-certificates jira-cert
    
  2. 부하 분산기의 고정 외부 IP 주소를 가져옵니다.

    gcloud compute addresses list
    

    이후 단계에서 필요하므로 이 주소를 기록해 둡니다.

  3. 들어오는 요청을 프록시로 라우팅하는 글로벌 전달 규칙을 만듭니다. [LB_IP_ADDRESS]를 자신이 만들고 이전 단계에서 나열한 고정 외부 주소로 바꿉니다.

    gcloud compute forwarding-rules create https-fwd-rule \
        --address [LB_IP_ADDRESS] \
        --global \
        --target-https-proxy https-lb-proxy \
        --ports 443
    

DNS 레코드 추가 또는 업데이트

다음 단계는 트래픽이 도메인에서 부하 분산기로 전달되도록 도메인의 DNS 레코드를 추가하거나 업데이트하는 것입니다.

  1. 등록기관의 사이트에서 도메인의 DNS 레코드를 추가하거나 업데이트하여 사용자가 만든 정적 외부 IP 주소를 가리키게 합니다.

    외부 IP 주소를 보려면 다음 명령어를 사용하세요.

    gcloud compute addresses list
    

SSL 인증서 리소스가 활성 상태인지 확인

인증서 리소스 프로비저닝에는 몇 분이 걸립니다.

  • 프로세스 상태를 확인합니다.

    gcloud beta compute ssl-certificates list
    

    SSL 리소스가 ACTIVE 상태가 될 때까지 기다립니다.

브라우저에서 Jira에 연결하기

이제 Jira를 설치하고 서비스로 실행하도록 구성한 후 데이터베이스를 만들었으므로 웹브라우저 창에서 설치 프로세스를 시작할 수 있습니다.

  1. 로컬 컴퓨터에서 웹브라우저에 창을 엽니다.
  2. 검색 주소창에 https://[DOMAIN]을 입력합니다. [DOMAIN]을 해당 도메인으로 바꿉니다.
  3. JIRA의 설정 창에서 I'll set it up myself(직접 설정하겠습니다)를 클릭한 후 Next(다음)를 클릭합니다.

    데이터베이스 연결 창이 나타납니다.

  4. 프로덕션 환경에 권장되는 my own database(자체 데이터베이스)를 클릭하고 다음을 작성합니다.

    • Database type(데이터베이스 유형): MySQL 5.7+
    • Hostname(호스트 이름): 127.0.0.1
    • Port(포트): 3306
    • Database(데이터베이스): 자신이 만든 MySQL 데이터베이스
    • User(사용자): 자신이 만든 MySQL 사용자
    • Password(비밀번호) - MySQL 사용자의 비밀번호
  5. Test Connection(연결 테스트) 버튼을 클릭하여 Jira와의 데이터베이스 연결을 테스트합니다.

    다음 이미지는 성공적인 연결을 보여줍니다.

    연결에 대한 예시 입력 값과 '데이터베이스 연결 테스트에 성공했습니다'라는 페이지 상단의 녹색 메시지를 보여주는 데이터베이스 연결 페이지의 스크린샷

  6. Jira의 라이선스 키를 입력합니다.

  7. 설정 과정에서 이메일 알림 및 관리자 액세스를 구성합니다.

이제 MySQL용 Cloud SQL을 사용하여 데이터베이스 연결에 Jira Software를 사용할 수 있습니다.

부하 분산기 제한 시간 업데이트

설치가 완료되었으므로 이제 부하 분산기 제한 시간을 기본값인 30초로 되돌립니다.

  • Cloud Shell에서 jira-app 백엔드 서비스의 제한 시간을 업데이트합니다.

    gcloud compute backend-services update jira-app --timeout 30 --global
    

정리

이 가이드에서 사용된 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 리소스가 포함된 프로젝트를 삭제하거나 프로젝트를 유지하고 개별 리소스를 삭제하세요.

프로젝트 삭제

  1. Cloud Console에서 리소스 관리 페이지로 이동합니다.

    리소스 관리로 이동

  2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.
  3. 대화상자에서 프로젝트 ID를 입력한 후 종료를 클릭하여 프로젝트를 삭제합니다.

다음 단계