Orb のパブリッシュ

ここでは、Orb のパブリッシュ手順について説明します。

作成した Orb は、 セマンティックバージョン タグを付けてパブリッシュすることで、 Orb レジストリに公開できます。

手動ではなく、 Orb 開発キットを使用して Orb をパブリッシュすると、セマンティックリリースがこのセクションで説明する手順で簡単に行えます。 パブリッシュプロセスの概説は、作成プロセスの開始時に circleci orb init コマンドで生成される README.md ファイルを参照してください。

以下では、Orb の新しいセマンティックリリースを公開する方法について説明します。

circleci orb init コマンドでサンプルの Orb プロジェクトを生成すると、自動的に alpha ブランチに移行されます。 ブランチ名は任意で構いませんが、デフォルト以外のブランチで変更することをお勧めします。

変更したら、コミットしブランチにプッシュします。 コミットメッセージには、 Conventional Commits を使用することを強くお勧めします。

下記の手順に従って変更から新しいリリースを作成します。

1. 新しいプルリクエストをデフォルトのブランチに作成します。./circleci ディレクトリに含まれるconfig.yml ファイルと test-deploy.yml ファイルは、CircleCI Web アプリで Orb の変更を自動的に リント、 シェルチェック、 レビュー、 テストします。</p></li>

   1 すべてのテストが成功したか確認してください。
   テスト結果は、GitHub 上のプルリクエストで直接確認できます。 また、CircleCI Web アプリではパイプライン全体に対する詳細な結果を確認できます。 ワークフローが 2 つあり、lint-pack が先に実行され、リント、シェルチェック、レビューを含まれており、2 つ目のワークフローでテストするよう開発版をパブリッシュします。 この test-deploy には結合テストが含まれており、準備が整い次第 Orb の安定版をパブリッシュできます。

1 “スカッシュ” マージ
変更が完了したら、 Conventional Commit メッセージ を使って変更を一つのコミットに “ スカッシュマージ” することをお勧めします（必須ではありません）。

例：

    - `fix: x-command parameter from string to integer`
  - `feat: added new x parameter to y command` 1 **タグとリリース**<br/> 変更がデフォルトのブランチにマージされましたが、[ Orb レジストリ](https://circleci.com/ja/developer/orbs)をチェックすると、新しいバージョンはパブリッシュされていません。</ol> 

新しいバージョンの Orb をパブリッシュするには、リリースのタグ付けが必要です。 タグは手動で作成し、プッシュできますが、 GitHub.com のリリース機能の使用をお勧めします。

GitHub のリリース機能を使うとリリースノートをパブリッシュできます。これはOrb の更新履歴として機能します。

GitHub のドキュメントに従って新しいリリースを作成します。

1. タグの選択を求められたら、今回のリリースでパブリッシュされる新しいタグを指定します。 Orb の現在のバージョンを Orb レジストリで再度確認します。 どのような変更を行っているかわからない場合は、この後修正することができます。 タグの形式が vX.Y.Z であることを確認してください。
2. [+ Auto-generate release notes] ボタンをクリックします。 変更点のまとめが作成されます。これには前回のリリース以降にマージされたすべてのプルリクエストが含まれます。 Conventional Commit メッセージ を使用したことがあれば、セマンティックインクリメントの変更タイプはコミットメッセージにより簡単に分かります。 たとえば、前に “fix:” がついた 2 つのコミットがある場合、セマンティックバージョンが “patch” レベルでインクリメントすることが予想されます。
3. タイトルを追加して、リリースをパブリッシュします。
4. 完了です！

リリースがパブリッシュされると、タグが作成され、CircleCI パイプラインが最終的にトリガーされます。 この最終的なパイプラインは、以前と同じすべてのステップと追加された最終ジョブ１つを実行します。これにより、新しいバージョンの Orb が作成され、Orbレジストリにパブリッシュされます。

最終的な orb-tools/publish ジョブを見ると、Publishing Orb Release ステップで、次のようなメッセージが表示されます。

Your orb has been published to the CircleCI Orb Registry.
You can view your published orb on the CircleCI Orb Registry at the following link:
https://circleci.com/developer/orbs/orb/circleci/orb-tools?version=11.1.2

この例は、 こちらの orb-tools Orb からご覧いただけます。