GitLab을 사용하여 자동 빌드 및 릴리즈 앱 만들기

이 기사에서는 GitLab을 사용하여 CI/CD pipeline 설정 방법에 대해 안내해드립니다.

소개

Be sure you have added your Capacitor app first to Capgo, this tutorial just focuses on the upload phase. If you need to add your app to Capgo, you can follow this 튜토리얼.

커밋 규칙

먼저 커밋 규칙을 따라야 합니다. conventional commits` 이 명령어를 사용하면 버전 번호를 업그레이드하는 방법을 이해하는 도구가 생기는데, 5분만 배워도 됩니다.

태그를 위한 GitLab CI/CD

.gitlab-ci.yml 파일을 GitLab 저장소의 루트에 생성하세요. 다음 내용을 포함하세요.

 stages:
      - tag

 bump_version:
   stage: tag
   only:
     - main
  except:
    variables:
  - $CI_COMMIT_MESSAGE =~ /^chore\(release\):/
  script:
   - git config --global user.email "gitlab@yourdomain.com"
   - git config --global user.name "GitLab CI/CD"
   - git checkout $CI_COMMIT_REF_NAME
   - git pull origin $CI_COMMIT_REF_NAME
   - npx capacitor-standard-version
   - git push origin $CI_COMMIT_REF_NAME --tags

‘gitlab@yourdomain.com’와 ‘GitLab CI/CD’를 스크립트 섹션에 있는 이메일과 사용자 이름으로 대체하세요. 이 구성은 메인 branch로 푸시하는 경우에만 작업을 트리거하고, 커밋 메시지가 ‘chore(release):’로 시작하는 커밋을 제외합니다.

빌드를 위한 GitLab CI/CD

.gitlab-ci.yml 파일에 빌드에 대한 또 다른 스테이지를 추가하세요.

    stages:
      - deploy

   deploy:
     stage: deploy
     only:
       - tags  # This job will only run for tag pushes
     script:
       - apt-get update -qy && apt-get install -y nodejs npm
       - npm install -g @capgo/cli
       - npm ci
       - npm run build
       - npx @capgo/cli bundle upload -a $CAPGO_TOKEN -c production
     variables:
       FIREBASE_CONFIG: $FIREBASE_CONFIG  # Define this in your GitLab project settings
     environment:
       name: production

Capgo API 키 (CAPGO_TOKEN)를 GitLab 프로젝트의 CI/CD 변수로 추가하십시오. GitLab에서 프로젝트를 열고, Settings > CI/CD > Variables로 이동하여 CAPGO_TOKEN 변수를 추가하고, API 키의 값을 입력하십시오.

npm 빌드 명령어를 프로젝트의 빌드 프로세스에 맞게 수정하십시오.

결론

우리는 기술의 여정을 한 걸음 더 나아갔습니다. 현대 소프트웨어 개발에서 CICD는 중요한 요소입니다. 따라서 이 안내서가 모든 분들에게 이해가 되기를 바랍니다.