この記事では、GitLabを使用したCI/CDパイプラインのセットアップ方法を説明します。

前書き

最初にCapgoにあなたのCapacitorアプリを追加していることを確認してください。このチュートリアルはアップロードフェーズに焦点を当てています。Capgoにアプリを追加する必要がある場合は、このTutorialを参照してください。

コミット規約

最初に、コミット規約conventional commitsに従い始める必要があります。これにより、ツールがバージョン番号をどのようにアップグレードするかを理解するのに役立ちます。学ぶのに5分かかります。

タグ用のGitLab CI/CD

GitLabリポジトリのルートにgitlab-ci.ymlファイルを作成し、以下の内容を記述します。

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」をあなたのGitLabのメールアドレスとユーザー名に置き換えます。この設定により、ジョブはメインブランチへのプッシュ時のみトリガーされ、「chore(release):」で始まるメッセージのコミットは除外されます。

ビルド用のGitLab CI/CD

ビルド用にgitlab-ci.ymlファイルに別のステージを追加します。

stages:
  - deploy

deploy:
  stage: deploy
  only:
    - tags  # このジョブはタグプッシュのみに対して実行されます
  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  # これをGitLabプロジェクトの設定で定義します
  environment:
    name: production

Capgo APIキー（CAPGO_TOKEN）がGitLabプロジェクトのCI/CD変数として追加されていることを確認してください。GitLabのプロジェクトに移動し、設定 > CI/CD > 変数に進み、CAPGO_TOKENという名前の変数をAPIキーの値で追加します。

ビルドスクリプトを特定のプロジェクトのビルドプロセスに合わせてカスタマイズします。たとえば、npm run buildコマンドを変更するなどです。

結論

ここまできました！私たちは技術の旅の中で一歩進んだのです。現代のソフトウェア開発において、CI/CDは考慮すべき重要な要素です。このガイドラインが皆に理解されることを願っています。