リリース手順

esa-cliのリリースは、GitHub Actionsによって大部分が自動化されています。 以下の手順で新しいバージョンをリリースできます。

リリース手順

1. バージョン番号の更新

   internal/version/version.go のバージョン番号を更新します。

   internal/version/version.go

   const Version = "x.y.z"  // 新しいバージョン番号

2. 変更のコミットとプッシュ

   バージョン番号の更新をコミットし、mainブランチにプッシュします。

   git add internal/version/version.go
   git commit -m "build: Bump version to x.y.z"
   git push origin main

3. リリースタグの作成とプッシュ

   セマンティックバージョニングに従った新しいタグを作成し、プッシュします。 このプッシュがGitHub Actionsのリリースワークフローをトリガーします。

   git tag -a vX.Y.Z -m "Release vX.Y.Z"
   git push origin main --follow-tags

   Note

   vから始まるタグ (v1.2.3など) をプッシュすると、リリースワークフローが自動的に開始されます。

自動化されていること

タグをプッシュすると、GitHub Actionsは以下の作業を自動的に行います。

• LinuxとmacOS用のバイナリをビルド
• macOS用のユニバーサルバイナリを作成 (lipoコマンドを使用)
• GitHub Releaseを新規作成
• すべてのバイナリ（ユニバーサルバイナリを含む）とチェックサムをAssetsにアップロード
• homebrew-esa-cliリポジトリのHomebrew Formula (esa-cli.rb) を自動で更新

リリース後の確認作業

1. GitHub Actionsの確認

   Actionsタブで、リリースワークフローが正常に完了したことを確認します。

2. GitHubリリースの確認

   リリースページに移動し、以下を確認します。

   • 新しいバージョンのリリースが作成されていること。
   • esa-cli-darwin-universal.tar.gzを含む、必要なすべてのアセットがアップロードされていること。

3. リリースノートの編集 (任意)

   自動生成されたChangelogだけでは不十分な場合、リリースノートを編集して、変更点の概要やユーザーへのメッセージを追加します。

4. Homebrewでのインストール確認

   リリースが反映されたことを確認するため、ローカル環境でHomebrewを使ってインストールまたはアップグレードを試します。

   brew update
   brew upgrade esa-cli
   # または再インストール
   brew reinstall esa-cli

トラブルシューティング

エラー: Resource not accessible by integration

• 原因: GitHubのパーソナルアクセストークン（PAT）が無効か、リポジトリのSecretsに正しく設定されていません。
• 解決策:
  1. PATの設定ページで、repoスコープを持つ有効なトークンが存在することを確認します。
  2. esa-cliリポジトリのSecretsページで、HOMEBREW_TAP_GITHUB_TOKENという名前のSecretにそのトークンが正しく設定されていることを確認します。