Orb に関するよくあるご質問

よく寄せられるご質問や技術的な問題など、Orb の使用時に役立つ情報をまとめました。

• 質問: Orb はプライベートにできますか？

• 回答: 現在のすべての料金プランで プライベート Orb をご利用いただけます。

• 質問: コマンドとジョブの違いは何ですか？

• 回答: コマンドと ジョブはどちらも Orb 内で使用される要素です。 コマンド_には、Orb のロジックを含む一つまたは複数の ステップが含まれます。 コマンドは多くの場合、シェルコード (バッシュ) を実行します。 _ジョブ_は、実行するステップやコマンドの定義であり、_かつ、ステップやコマンドを実行する Executor です。 _コマンド_は、ジョブ内で呼び出されます。 _ジョブ_は、 ワークフロー</em>を使ってオーケストレーションされます。

• **質問: ** Orb はプライベートなインストール環境で使用できますか？

• **回答: ** Orb は、CircleCI Server v3 でご利用いただけます。 CircleCI Server での Orb のインポートと使用に関しては、 CircleCI Server v3.x の Orb ガイドを参照して下さい。

  CircleCI Server v2.19.x では Orb は使用できませんが、コミットの前に設定を処理すると、Orb を変換して使用できます。 コミット前の Git Hook の使用については、 サーバーでの Orb の使用を参照して下さい。

• **質問: ** Orb に関するバグや問題をレポートする方法は？

• **回答: ** すべての Orb はオープンソースプロジェクトです。 問題やバグのレポートだけでなく、プルリクエストも Orb の Git リポジトリに対して行えます。 Orb オーサーは、Orb レジストリ 上で Git リポジトリへのリンクを含めるかを選択できます。

  Git リポジトリへのリンクがない場合は、サポートまでご連絡ください。オーサーに連絡いたします。 または、その Orb をフォークして、独自のバージョンをパブリッシュしてはいかがでしょう。

• **質問: ** 未承認 Orb を使用しようとするとエラーメッセージが出るのはなぜですか？

• 回答: 未承認 Orb の使用を有効にするには、お客様の組織の設定ページから_Security_ タブをクリックします。 その後、yes をクリックして_未承認 Orb を許可する_を有効にします。

**注: **CircleCI では、未承認 Orb のテストや検証は行っていません。 現在、CircleCI が作成した Orb のみが承認されています。 それ以外の Orb (パートナーの Orb を含む) は、未承認です。

• 質問: どうすれば常に最新バージョンの Orb をインポートできますか？

• 回答: Orb には セマンティックバージョニングが使用されています。つまり、_メジャー_バージョンを設定すると (例:3 )、_マイナー_と_パッチ_のすべてのアップデートを受け取ります。静的にバージョンを設定すると(例:3.0.0 )、アップデートは適用されません。これが最も決定論的で推奨される方法です。

• 質問: ローカルでのテストで以下のエラーが表示されるのはなぜですか？

circleci build -c .circleci/jobs.yml --job test

Error:
You attempted to run a local build with version 2.1 of configuration.

• 回答: このエラーを解決するには、設定で circleci config process を実行し、その設定をディスクに保存します。 次に、処理された設定に対して circleci local execute を実行します。

• Orb のコンセプト: CircleCI Orb に関するハイレベルな情報
• Orb のパブリッシュ: ワークフローやジョブに使用する Orb のパブリッシュプロセス
• Orb リファレンス ガイド: 再利用可能な Orb、コマンド、パラメーター、および Executor の例