パイプライン ワークスペースの構成
継続的インテグレーション タスクとカスタム タスクを実行するには、
Automation Pipelines
パイプラインに対してワークスペースを構成する必要があります。 パイプライン ワークスペースで、
タイプ
に Docker または Kubernetes を選択し、各エンドポイントを指定します。Docker および Kubernetes プラットフォームは、継続的インテグレーション (CI) タスクまたはカスタム タスクを実行するために Automation Pipelines
が展開するコンテナのライフサイクル全体を管理します。- Docker ワークスペースには、Docker ホスト エンドポイント、ビルダー イメージ URL、イメージ レジストリ、作業ディレクトリ、キャッシュ、環境変数、CPU 制限、メモリ制限が必要です。Git リポジトリのクローンを作成することもできます。
- Kubernetes ワークスペースには、Kubernetes API エンドポイント、ビルダー イメージ URL、イメージ レジストリ、名前空間、NodePort、パーシステント ボリュームの要求 (PVC)、作業ディレクトリ、環境変数、CPU 制限、メモリ制限が必要です。Git リポジトリのクローンを作成することもできます。
パイプライン ワークスペースの構成には、次の表に示すように、いくつかの共通パラメータと、ワークスペースのタイプに固有のパラメータがあります。
選択 | 説明 | 詳細および可用性 |
|---|---|---|
タイプ
| ワークスペースのタイプ。 | Docker または Kubernetes で使用できます。 |
ホスト エンドポイント
| 継続的インテグレーション (CI) およびカスタム タスクが実行されるホスト エンドポイント。 | Docker ホスト エンドポイントを選択すると、Docker ワークスペースで使用できます。 Kubernetes API エンドポイントを選択すると、Kubernetes ワークスペースで使用できます。 |
ビルダー イメージ URL
| ビルダー イメージの名前と場所。このイメージを使用して Docker ホストおよび Kubernetes クラスタ上にコンテナが作成されます。継続的インテグレーション (CI) タスクとカスタム タスクは、このコンテナ内で実行されます。 | 例： fedora:latest ビルダー イメージには、 curl または wget が必要です。 |
イメージ レジストリ
| ビルダー イメージがレジストリ内にあり、そのレジストリが認証情報を必要とする場合は、イメージ レジストリ エンドポイントを作成し、ここでそれを選択することで、レジストリからイメージを取得できるようにする必要があります。 | Docker および Kubernetes ワークスペースで使用できます。 |
作業ディレクトリ
| 作業ディレクトリは、継続的インテグレーション (CI) タスクの手順が実行されるコンテナ内の場所であり、Git Webhook によってパイプラインの実行がトリガされたときにコードのクローンが作成される場所です。 | Docker または Kubernetes で使用できます。 |
名前空間
| 名前空間を入力しないと、指定した Kubernetes クラスタ内に Automation Pipelines によって一意の名前が作成されます。 | Kubernetes ワークスペースに固有。 |
プロキシ
| Kubernetes クラスタ内のワークスペース ポッドと通信するために、 Automation Pipelines は、各 Kubernetes クラスタの名前空間 codestream-proxy に単一のプロキシ インスタンスを展開します。クラスタ構成に基づいて、NodePort または LoadBalancer タイプのいずれかを選択できます。選択するオプションは、展開した Kubernetes クラスタの性質によって決まります。
| |
NodePort
| Automation Pipelines では、Kubernetes クラスタ内で実行されているコンテナとの通信に NodePort が使用されます。ポートを選択しない場合、 Automation Pipelines は、Kubernetes によって割り当てられる短期ポートを使用します。短期ポートの範囲（30000 ～ 32767）に対する入力を許可するようにファイアウォール ルールが構成されていることを確認する必要があります。ポートを入力する場合は、クラスタ内の別のサービスがそのポートを使用していないこと、およびポートがファイアウォール ルールで許可されていることを確認する必要があります。 | Kubernetes ワークスペースに固有。 |
パーシステント ボリュームの要求
| この機能により、Kubernetes ワークスペースのファイルをパイプラインの実行間で保持することができます。パーシステント ボリュームの要求に名前を指定すると、ログ、アーティファクト、およびキャッシュを保存できます。 パーシステント ボリュームの要求の作成の詳細については、 https://kubernetes.io/docs/concepts/storage/persistent-volumes/ にある Kubernetes のドキュメントを参照してください。
| Kubernetes ワークスペースに固有。 |
環境変数
| ここで渡されるキーと値のペアは、実行されるパイプライン内のすべての継続的インテグレーション (CI) タスクとカスタム タスクで使用できます。 | Docker または Kubernetes で使用できます。 ここで変数への参照を渡すことができます。 ワークスペースで提供される環境変数は、パイプライン内のすべての継続的インテグレーション (CI) タスクとカスタム タスクに渡されます。 ここで環境変数が渡されない場合、これらの変数は、パイプライン内のそれぞれの継続的インテグレーション (CI) タスクとカスタム タスクに明示的に渡す必要があります。 |
CPU リミット
| 継続的インテグレーション (CI) コンテナまたはカスタム タスク コンテナ向けの CPU リソースを制限します。 | デフォルトは 1 です。 |
メモリ リミット
| 継続的インテグレーション (CI) コンテナまたはカスタム タスクコンテナ向けのメモリを制限します。 | 単位は MB です。 |
Git クローン
| Git クローン を選択し、Git Webhook がパイプラインを呼び出すと、コードのクローンがワークスペース（コンテナ）内に作成されます。 | Git クローン が有効になっていない場合は、パイプライン内で別の明示的な継続的インテグレーション (CI) タスクを構成して、まずコードのクローンを作成してから、ビルドやテストなどの他の手順を実行する必要があります。 |
キャッシュ
| Automation Pipelines ワークスペースでは、一連のディレクトリまたはファイルをキャッシュして、その後のパイプライン実行を高速化できます。これらのディレクトリは、たとえば .m2 、npm_modules などです。パイプラインの実行間でデータのキャッシュを必須にしない場合、パーシステント ボリュームの要求が不要になります。 コンテナ内のファイルやディレクトリなどのアーティファクトは、複数のパイプライン実行で再利用するためにキャッシュされます。たとえば、 node_modules フォルダや .m2 フォルダをキャッシュできます。キャッシュ には、パスのリストを指定できます。例：
| ワークスペースのタイプに固有。 Docker ワークスペースでは、Docker ホスト内にある、キャッシュされたデータ、アーティファクト、およびログを保持するための共有パスを使用することで、 キャッシュ が実行されます。Kubernetes ワークスペースで キャッシュ の使用を有効にするには、パーシステント ボリュームの要求を指定する必要があります。それ以外の場合、キャッシュ は使用できません。 |
パイプライン ワークスペースで Kubernetes API エンドポイントを使用する場合、
Automation Pipelines
は、継続的インテグレーション (CI) タスクまたはカスタム タスクを実行するために必要な ConfigMap、シークレット、ポッドなどの Kubernetes リソースを作成します。Automation Pipelines
は、NodePort を使用してコンテナと通信します。パイプラインの実行の間でデータを共有するには、パーシステント ボリュームの要求を指定する必要があります。
Automation Pipelines
はパーシステント ボリュームの要求をコンテナにマウントしてデータを保存し、以降のパイプラインの実行に使用します。