Manage development and production build with GitHub actions

このチュートリアルはGitHubホスティングに焦点を当てていますが、CI/CDプラットフォームを任意に変更するには少しの調整が必要です。

序文

まず、CapacitorアプリをCapgoに追加してください。このチュートリアルはアップロードフェーズに焦点を当てています。

コミット規約

最初に、コミット規約をフォローする必要があります conventional commits` これは、バージョン番号をアップグレードする方法を理解するのに役立ちます。5分で学べます。

Conventional commits

` GitHub actions for tag`

次に、自動ビルドとタグの作成を行う最初の GitHub アクションを作成する必要があります。

ファイルを作成するパス: .github/workflows/bump_version.yml

この内容で:

name: Bump version

on:
  push:
    branches:
      - main
      - development

jobs:
  bump-version:
    if: "!startsWith(github.event.head_commit.message, 'chore(release):')"
    runs-on: ubuntu-latest
    name: "Bump version and create changelog with standard version"
    steps:
      - name: Check out
        uses: actions/checkout@v6
        with:
          fetch-depth: 0
          filter: blob:none
          token: '${{ secrets.PERSONAL_ACCESS_TOKEN }}'
      - name: Git config
        run: |
          git config --local user.name "github-actions[bot]"
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
      - name: Create bump and changelog
        if: github.ref == 'refs/heads/main'
        run: npx capacitor-standard-version
      - name: Create bump and changelog
        if: github.ref != 'refs/heads/main'
        run: npx capacitor-standard-version --prerelease alpha
      - name: Push to origin
        run: |
          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
          remote_repo="https://${GITHUB_ACTOR}:${{ secrets.PERSONAL_ACCESS_TOKEN }}@github.com/${GITHUB_REPOSITORY}.git"
          git pull $remote_repo $CURRENT_BRANCH
          git push $remote_repo HEAD:$CURRENT_BRANCH --follow-tags --tags

毎回のコミットに対してタグをリリースし、 alpha リリース development、そして最後にコミットごとに変更履歴を記録します。 CHANGELOG.md.

このファイルが存在しない場合は、自動的に作成されます。

To make this work, you need to create a パーソナルアクセストークン and add it to your GitHub __CAPGO_KEEP_0__ のシークレットシークレット PERSONAL_ACCESS_TOKEN.

として

これは、CI が変更ログとバージョンアップをコミットできるようにする必要があります。 never トークンを作成するときに、期限を repo.

と version スコープを package.json に設定してください。

最初の1回だけ必要な場合、それ以降はツールが自動で更新します。

GitHub にコミットしてみて、最初のタグが表示されることを確認してください。

capacitor-standard-version パッケージは、デフォルトでは、Android と IOS のバージョン番号も自動で更新します。

GitHub のビルドアクション

このパスにファイルを作成してください: .github/workflows/build.yml

この内容でファイルを作成してください:

name: Build source code and send to Capgo

on:
  push:
    tags:
      - '*'
      
jobs:
  deploy:
    runs-on: ubuntu-latest
    name: "Build code and release"
    steps:
      - name: Check out
        uses: actions/checkout@v6
      - name: Install dependencies
        id: install_code
        run: npm i
      - name: Build
        id: build_code
        run: npm build
        env:
          MY_ENV_VAR: ${{ secrets.MY_ENV_VAR }}
      - name: Create Release Alpha
        if: "contains(github.ref, '-alpha.')"
        id: create_release_prepro
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c development
      - name: Create Release Production
        if: "!contains(github.ref, '-alpha.')"
        id: create_release_prod
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

Capgo への依存関係のインストールとビルドが完了し、Capgo に送信されるまでの流れです。

ビルドコマンドが異なる場合は、ステップを変更してください。 build_code 環境変数が必要な場合は、__CAPGO_KEEP_0__ のプロジェクト設定で、シークレットとして __CAPGO_KEEP_1__ Action を設定してください。

__CAPGO_KEEP_0__ MY_ENV_VAR __CAPGO_KEEP_1__ secret in your GitHub project setting, then secret then GitHub Action.

アップロードを実行するには、Capgoに必要なAPIキーを取得し、Capgoに追加する必要があります。 GitHub リポジトリの秘密 as CAPGO_TOKEN.

Capgoにファイルをコミットし、最初のバージョンが表示されます。

GitHub アクションを追加すると、コミットは新しい Capacitor の生産と開発チャンネルのビルドを生成します。

Ionic ビルドステップでテストを追加してください。そうすることで、code が正常に動作していることを確認できます。

Go To your Capgo dashboard and check your build who just appeared, you now have your CI/CD system.

Keep going from Manage development and production build with GitHub actions

Capgo Manage development and production build with GitHub actions チャンネルルーティングとステージドロールアウトを計画するには、接続するチャンネルチャンネルにおける実装詳細についてチャンネルチャンネルにおける実装詳細についてベータテストソリューションベータテストソリューションにおける製品ワークフローについてバージョン目標ソリューションバージョン目標ソリューションにおける製品ワークフローについて著者マーティン・ドナディュー