カスタムパイプラインを作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：5分

    • リリース運用プレイブックの 1 つを複製して、変更を開発環境から本番 (またはターゲットインスタンス) に移動するためのカスタムパイプラインを作成します。

    始める前に

    必要なロール:releaseops.pipeline_adminおよび playbook.admin または pd_author

    プレイブックの詳細については、「 Exploring playbooks」を参照してください。

    手順

    1. リリース運用プレイブックのうちの 1 つを複製します。
      1. 移動先 すべて > ワークフロースタジオ をクリックし、目的のプレイブックを選択します。
      2. 新しいプレイブックの名前を入力し、その他の必要な詳細を更新します。
      詳細については、「Duplicate Playbooks」を参照してください。
    2. 必要に応じて、プレイブックのステージを追加または更新します。
      注:
      フローの特定の部分では、特定のステージが意味をなします。たとえば、展開アナライザーは、展開ステータスが [テストに移動] の前に実行されます。他のステージは、[テストに移動] の後または [ATF テストの実行] の後に実行する必要がある場合があります。通常、[展開準備完了] の後に何も追加しないでください。
      詳細については、「Add and configure a stage in a playbook」を参照してください。
    3. 必要に応じて、プレイブックで意思決定を追加または更新します。
      詳細については、「Decision activities」を参照してください。
    4. [ アクティブ化] を選択して更新を確定し、新しいプレイブックを使用できるようにします。
    5. 新しいプレイブックを活用するパイプラインを作成します。
      1. 移動先 すべて > リリース運用 > パイプライン をクリックし、[ 新規] を選択します。
      2. パイプラインに名前を付け、[ アセスメントプレイブック] フィールドと [プレイブックをリリース] フィールドにプレイブックを選択します。
        両方に独自のカスタムプレイブックを使用することも、カスタムプレイブックとサンプルプレイブックを組み合わせて使用することもできます。
      3. [パイプライン] フォームのヘッダーを右クリックし、[ 保存] を選択します。
    6. 新しく作成したパイプラインで、[パイプラインインスタンス] 関連リストを見つけて [新規] を選択します。
      1. ラベル [テスト] を選択します 。
      2. 展開インスタンスを選択します。
      3. [Submit (送信)] を選択します。

    例:アセスメントプレイブックの作成

    展開要求アセスメントプレイブックを複製して、非本番環境で変更を移動するカスタムパイプラインを作成します。展開アナライザーを追加して、展開でコードの変更があるかどうかを検出し、アセスメント中に自動テストフレームワーク (ATF) テストをスキップします。

    始める前に

    必要なロール:releaseops.pipeline_adminおよび playbook.admin または pd_author

    手順

    1. 展開要求アセスメントプレイブックを複製します。
      1. 移動先 すべて > ワークフロースタジオ をクリックし、 展開要求アセスメント プレイブックを選択します。
      2. [その他のアクション] メニューから [複製 ] を選択します。
      3. 新しいプレイブックの名前を入力し、その他の必要な詳細を更新します。
    2. [開始] の後の [+] アイコンを選択してプレイブックに新しいステージを追加し、ラベルを入力します ( 例:[展開を分析])。
      注:
      フローの特定の部分では、特定のステージが意味をなします。たとえば、展開アナライザーは展開ステータス (テストに移動) の前に実行されます。他のステージは、[テストに移動] の後または [ATF テストの実行] の後に実行する必要がある場合があります。通常、[展開準備完了] の後に何も追加しないでください。
    3. [ 展開アナライザーを実行 ] アクティビティを追加します。
    4. 新しく追加された [展開アナライザーを実行] アクティビティを選択して構成します。
      1. 追加オプションモーダルで [自動化 ] タブを選択します。
      2. モーダルの [入力] セクションで、アイコンを選択し、[ 親レコード - 展開要求] を選択します。
      3. [Save and close (保存して閉じる)] を選択します。
    5. プレイブックの [ATF テストを実行] セクションを見つけ、[+] アイコンを選択し、[ 意思決定を追加 (if/then)] を選択して、[評価アクティビティへの移行] の後に新しい意思決定を追加します。
      詳細については、「Decision activities」を参照してください。
    6. 新しく追加された決定を選択して構成します。
      1. [ 分岐] タブを選択し、ラベル ( 例:[テストをスキップ] ) を入力します。
      2. [ 条件を追加] を選択します。
      3. [Field (フィールド)] ドロップダウンメニューから、 1.1 デプロイメントアナライザー > 出力 > コード変更あり.
      4. [演算子] ドロップダウンメニューから 選択します 。
      5. [True/False] ドロップダウンメニューから [false ] を選択します。
      6. [保存して閉じる] を選択します。
    7. [テストをスキップ] 分岐にカーソルを合わせて [ 新しいコネクタをドラッグ ] アイコンを選択し、[テスト失敗タスクを作成] の後のジャンクションにコネクタをドラッグします。
      デフォルトの分岐が展開の ATF テストの実行に接続されていることを確認します。
    8. [ アクティブ化] を選択して更新を確定し、新しいプレイブックを使用できるようにします。
    9. アセスメントプレイブックを活用するパイプラインを作成します。
      1. 移動先 すべて > リリース運用 > パイプライン をクリックし、[ 新規] を選択します。
      2. パイプラインに名前を付け、[ アセスメントプレイブック] フィールドで新しく作成したプレイブックを選択します。
      3. [パイプライン] フォームのヘッダーを選択して長押し (または右クリック) し、[ 保存] を選択します。
    10. 新しく作成したパイプラインで、[パイプラインインスタンス] 関連リストを見つけて [新規] を選択します。
      1. ラベル [テスト] を選択します 。
      2. 展開インスタンスを選択します。
      3. [Submit (送信)] を選択します。

    タスクの結果

    これで、デフォルトの展開要求アセスメントプレイブックからアセスメントステージ用に作成したカスタムプレイブックを利用するカスタムパイプラインを使用する準備が整いました。
    注:
    • パイプラインインスタンスラベル (上記の例では、ステップ 10a で入力した Test ラベル) は、インスタンス定義をプレイブックで参照されているインスタンスにマッピングするために使用されます。インスタンス定義をインスタンスラベルにマッピングすると、異なるトポロジ (ただし同じプロセス) を持つ複数のパイプライン定義でプレイブックを使用できます。たとえば、別のパイプラインレコードを作成して同じプレイブックに関連付けますが、別のテストインスタンスマッピングを定義できます。
    • プレイブックのソースインスタンスは展開要求で定義されるため、1 つのリリースに複数のソース環境または開発環境を使用できます。
    • 宛先インスタンスはリリースで定義されているため、同じパイプラインを再利用して複数の宛先環境または本番環境にリリースできます。
    • 中間インスタンスのみをマッピングする必要があります。