Pipeline の作成と設定

この Quick start では、最初の Pipeline を作成する手順を説明します。Source を指定し、Stage と Job を追加して保存します。完了すると、実行できる状態の Pipeline ができあがります。

前提条件

• 既存の Project が必要です。まだない場合は、初期設定 を参照してください（通常は最初の 1 回だけの作業です）。
• Project 内で Pipeline を作成する権限があること。
• 使用する予定がある場合は、Git Connection または Registry Connection が設定済みであること。

この Quick start で作成するもの

Pipeline Source、Stage、Job をそれぞれ 1 つずつ持つ、保存済みの Pipeline です。これは Pipeline を実行できるようにするための最小構成です。

Create Pipeline 画面を開く

1. 設定したい Project を開きます。
2. Create New Pipeline をクリックします。

Pipeline の作成画面が開きます。

基本情報を入力する

1. Pipeline Name を入力します。
2. Description を入力します（任意）。

Pipeline の基本情報が入力されます。

Pipeline を作成する

1. Save をクリックします。

Pipeline が作成され、Pipeline の設定画面にリダイレクトされます。

Pipeline Source を設定する

1. Pipeline Source エリアで Add Pipeline Source をクリックします。
2. ソースの種類を選択します。Code source（Git リポジトリ）または Registry source（コンテナレジストリ）です。

Code source の場合:

3. Git account connection を選択します。
4. Code repository URL（有効な Git URL のフルパス）を入力します。
5. Reference type（Branch または Tag)を選択し、branch 名または tag 名を入力します。
6. 必要に応じて Trigger を設定します。詳細は Trigger の設定 を参照してください。

Registry source の場合:

3. Container registry connection を選択します。
4. deploy する image を入力します(例: namespace/repository:tag)。

Save をクリックして確定します。Pipeline Source が設定されます。

Stage を追加する

1. Stage を追加する位置を選択します。
2. New Stage をクリックします。

新しい Stage が Pipeline に作成されます。

Stage に Job を追加する

1. 作成した Stage を選択します。
2. 順番に実行する場合は Add serial job、同じ Stage 内で他の Job と並行して実行する場合は Add Parallel Job をクリックします。
3. カタログから job type を選びます。この Quick start では Build and push を選択します。source から Docker image を build して container registry に push する job です。他の job type については Pipeline コンポーネントの理解 を参照してください。
4. job のフィールド(Dockerfile path、build context、push 先の container registry)を入力し、Save をクリックします。

Job が Stage に追加されます。

ヒント

既存の 2 つの Stage の間に Stage を追加したい場合は、Stage 間のコネクターにカーソルを合わせ、Stage 追加アイコンをクリックします。実行順序は自動的に更新されます。

Pipeline を保存する

保存する前に、Pipeline に次が揃っていることを確認します。

• Pipeline Source
• 少なくとも 1 つの Stage
• 少なくとも 1 つの Job

1. Save をクリックします。

Pipeline が保存され、実行できる状態になります。

警告

Pipeline を保存するには Pipeline Source が必須です。また、保存していない Pipeline は実行できません。

次のステップ

• Pipeline Source を設定する — 後でこの Pipeline の source を更新します。
• Add a Build and push job — 上で追加した Build and push Job の詳しい手順です。
• Trigger の設定 — Git の push、merge、tag をきっかけにこの Pipeline を自動実行します。
• Deploy Job の設定とアプリケーションの Deploy — この Pipeline に Deploy Job を追加します。
• Pipeline の Run と監視 — 作成した Pipeline を実行します。
• Pipeline コンポーネントの理解 — 上記で設定したすべての項目のフィールドリファレンスです。