Skip to content
Docs
Cancel

Orb の手動オーサリング プロセス

ここでは、Orb 開発キットを使わずにシンプルな Orb を手動で作成する手順について説明します。 ただし、ほとんどの Orb プロジェクトでは、Orb 開発キットのご利用をおすすめします。詳細は「Orb のオーサリング プロセス」を参照してください。

  1. まだ名前空間を作成していない場合は、次のコマンドでユーザー/組織の名前空間を作成します。希望する名前空間と GitHub 組織名を代入して実行してください。 
    circleci namespace create <my-namespace> github <my-gh-org>

    メモ: CircleCI CLI から名前空間を作成する場合は、VCS プロバイダーを指定してください。

  2. 名前空間内に Orb を作成します。 この段階では Orb のコンテンツは何も生成されませんが、Orb をパブリッシュするときの名前が予約されます。

パブリック Orb を作成する場合:

circleci orb create <my-namespace>/<my-orb-name>

プライベート Orb を作成する場合:

circleci orb create <my-namespace>/<my-orb-name> --private
  1. YAML ファイル形式で Orb のコンテンツを作成します。 以下のシンプルな例を参考にしてください。 
    version: 2.1
description: あいさつコマンド Orb
commands:
 greet:
     description: 相手に "Hello" とあいさつします。
     parameters:
         to:
             type: string
             default: World
     steps:
         - run: echo "Hello, << parameters.to >>"
  2. CLI を使用して、Orb コードをバリデーションします。 
    circleci orb validate /tmp/orb.yml
  3. 開発版の Orb をパブリッシュします。 
    circleci orb publish /tmp/orb.yml <my-namespace>/<my-orb-name>@dev:first
  4. Orb を本番にプッシュする準備が整ったら、circleci orb publish を使用して手動でパブリッシュするか、開発バージョンから直接プロモートすることができます。 以下のコマンドを使用すると、開発バージョン番号を 0.0.1 にインクリメントできます。 
    circleci orb publish promote <my-namespace>/<my-orb-name>@dev:first patch
  5. 安定版の Orb が変更不可形式でパブリッシュされ、CircleCI プロジェクトで安全に使用できるようになりました。 以下のコマンドを使用して、Orb のソースをプルします。 
    circleci orb source <my-namespace>/<my-orb-name>@0.0.1
  6. CLI を使用して、公開中の Orb を一覧表示します。

パブリック Orb を一覧表示する場合:

circleci orb list <my-namespace>

プライベート Orb を一覧表示する場合:

circleci orb list <my-namespace> --private

circleci orb コマンドの使用方法の詳細については、CLI に関するドキュメントを参照してください。


Help make this document better

This guide, as well as the rest of our docs, are open-source and available on GitHub. We welcome your contributions.

Creative Commons License
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.