Orb オーサリングの概要

クイックスタート

Orb とは、再利用可能な構成をパッケージとしてまとめたものです。 Orb は Orb レジストリにパブリッシュしたり、複数の設定ファイルにインポートしたりすることができます。 類似した複数のプロジェクトを管理する場合に、Orb を使って構成を抽象化してみましょう。

Orb のオーサリングを始める前に、まず CircleCI の設定ファイルに関するページと、パラメーター化された再利用可能な構成要素のオーサリングに関するページの説明をよく理解することをお勧めします。

Orb は、以下の 3 つの要素で構成されます。

インライン Orb を使って練習してみましょう。 インライン Orb は 1 つの設定ファイル内で定義できるので、手早く簡単にテストできます。

Orb をオーサリングすると、CircleCI コード共有利用規約に同意したものと自動的に見なされます。 パブリッシュされたすべての Orb は、MIT ライセンス契約に基づき、Orb レジストリで公開されます。 詳細については、Orb ライセンスに関するページをご覧ください。

はじめよう

Orb CLI

Orb の作成を始めるには、パーソナル アクセス トークンを使用して、ローカル マシンに CircleCI CLI をセットアップする必要があります。 CircleCI CLI のすべてのヘルプ コマンドは、CircleCI CLI ヘルプで参照できます。

権限の一覧表

Orb CLI のコマンドは、VCS (バージョン管理システム) によって、ユーザーの権限レベルごとに異なる範囲が設定されています。 組織のオーナーは、オーサリングを行うユーザー自身です。 別の組織の名前空間に対して Orb のオーサリングやパブリッシュを行うには、組織の管理者への支援要請が必要な場合があります。

Orb コマンド 権限の範囲
circleci namespace create オーナー
circleci orb init オーナー
circleci orb create オーナー
circleci orb publish 開発バージョン メンバー
circleci orb publish 本番バージョン オーナー

名前空間の登録

CircleCI に登録している組織は、一意の名前空間1 つ要求できます。 「組織」には、自分の個人用組織や自分がメンバーになっている組織が含まれます。 名前空間は各組織につき 1 つに制限されているため、組織の名前空間を登録するには、自分が組織の_オーナー_である必要があります。

まだ名前空間を要求していない場合は、以下のコマンドを実行して要求できます。

circleci namespace create <name> <vcs-type> <org-name> [flags]

name は要求する名前空間、vcs-type はお使いのバージョン管理システムの種類 (github または bitbucket)、org-name は自分の組織名を入力してください。

次のステップ

Orb の作成について解説した Orb オーサリング プロセス ガイドに進んでください。

関連項目



ドキュメントの改善にご協力ください

このガイドは、CircleCI の他のドキュメントと同様にオープンソースで、GitHub で使用できます。 ご協力いただき、ありがとうございます。


クリエイティブ・コモンズ・ライセンス
CircleCICircleCI ドキュメントは、クリエイティブ・コモンズの表示--非営利-継承 4.0 国際ライセンス に基づいてライセンス供与されています。