Delivery Pipeline の構成

DevOps Insights 2026年8月31 日にサービス終了となり、提供が中止されます。 Continuous Delivery は、2027年2月12日に以下のリージョンで提供が中止されます: au-sydca-torus-east。 また、同日をもって、Code Risk Analyzerもすべての地域で提供を終了いたします。 あるリージョンでこれらの機能が実際に利用されていない場合、そのリージョンの機能は早期に提供が終了し、新しいインスタンスの受け入れが停止される可能性があります。 詳細はこちら

Delivery Pipeline は、入力を取得してジョブ (ビルド、テスト、デプロイメントなど) を実行するステージのシーケンスを通して、プロジェクトの継続的デプロイメントを自動化します。

アプリの継続的なビルド、テスト、デプロイメントを自動化するように Delivery Pipelineを構成します。

  1. ツールチェーン作成時にこのツール統合を構成する場合は、「構成可能な統合」セクションで**「Delivery Pipeline」**をクリックします。 使用するテンプレートに応じて、使用できるフィールドは異なります。 デフォルトのフィールド値を確認し、必要に応じてそれらの設定を変更します。

  2. ツールチェーンをお持ちで、そこにこのツールの統合を追加する場合は、 IBM Cloud コンソールで、 メニュー アイコン( ハンバーガーアイコン ) > [Platform Automation ] > [Toolchains ] の順にクリックしてください。 「ツールチェーン」ページで、Delivery Pipeline を追加するツールチェーンをクリックします。

    a. **「ツールの追加」**をクリックします。

    b. 「ツール統合」セクションで**「Delivery Pipeline」**をクリックします。

  3. 新しいパイプラインの名前を指定します。

  4. 作成するパイプラインのタイプを選択します。

    • Classic :パブリックの共有インフラ上で実行されるステージやジョブを定義するための、使いやすいグラフィカルユーザーインターフェースを提供します。また、個々のステージをプライベートワーカー上で実行することもサポートしています。
    • Tekton: ダッシュボードで、定義した Kubernetes クラスターでの Tekton パイプライン実行の出力を参照できます。パイプライン定義リポジトリー、パイプライン・トリガー、パイプラインの実行場所、および単純なシークレットを構成することもできます。
  5. パイプラインを使用してユーザーインターフェースをデプロイする予定で、そのパイプラインがクラシックパイプラインである場合は、「 アプリメニューにアプリを表示する 」チェックボックスを選択してください。 パイプラインが作成するすべてのアプリケーションが、ツールチェーンの「概要」ページの**「アプリケーションの表示 (View App)」**リストに表示されます。

  6. **「統合の作成」**をクリックして、Delivery Pipeline をツールチェーンに追加します。

  7. ツールチェーンの**「デリバリー・パイプライン」**カードで、表示および構成するデリバリー・パイプラインをクリックします。 パイプラインの構成の基本を確認するには、『パイプラインのビルドとデプロイ』を参照してください。

    GitHub リポジトリーまたは Git リポジトリーにコミットがプッシュされるとパイプラインが自動的に実行されるようにしたい場合は、以下のステップを実行します。

    a. パイプラインのステージを定義する前に、ツールチェーン用に GitHub または Git Repos and Issue Tracking を構成します。 パイプラインのステージには、リポジトリーの Git URL が必要です。 各パイプライン・ステージは、ツールチェーンと関連付けられた、GitHub リポジトリーまたは Git リポジトリーのうち 1 つのみを参照できます。 GitHub の構成手順については、GitHub のセクションを参照してください。 Git Repos and Issue Tracking の構成手順については、Git Repos and Issue Tracking のセクションを参照してください。

    b. Web フックを使用します。 Web フックを使用しない場合、パイプラインは手動でのみ実行できます。 GitHub リポジトリーまたは GitHub Enterprise リポジトリーにリンクする場合に Web フックを使用するには、管理特権が必要です。 Git Repos and Issue Tracking リポジトリーにリンクするには、Master または Owner 特権が必要です。

  8. オプション: IBM Cloud Public でツールチェーンを使用していて、Sauce Labs でアプリのテストを実行したい場合、Delivery Pipeline を構成して Sauce Labs テスト・ジョブを追加します。 テスト・ジョブの構成手順については、『パイプラインに SauceLabs テスト・ジョブを構成する』セクションを参照してください。

パイプラインに Sauce Labs テスト・ジョブを構成する

パイプラインに Sauce Labs テスト・ジョブを構成する前に、アプリをビルドしてデプロイするためのステージを含む、正常に機能するパイプラインが存在していなければなりません。 また、ツールチェーンに Sauce Labs を構成しておく必要もあります。 Sauce Labs の構成方法については、 Sauce Labs のセクションを参照してください。

Delivery Pipeline を構成して Sauce Labs テスト・ジョブを追加します。

  1. アプリのテスト・バージョンをデプロイするステージがない場合は作成します。

  2. そのステージで、デプロイ・ジョブの後にテスト・ジョブを追加します。 これらのジョブは、同じステージに置くことにより、同じ環境プロパティーのセットにアクセスできるようになります。

    caption-side=bottom"
    テストジョブテストジョブ

  3. ステージを構成します。 **「環境プロパティー (ENVIRONMENT PROPERTIES)」**タブで、CF_APP_NAME プロパティーを作成します。

    Sauce Labs のユーザー名とアクセスキーは、テストジョブのスクリプト内で SAUCE_USERNAME および SAUCE_ACCESS_KEY という環境変数として利用可能です。 テストを記述する際は、これらの環境変数を使用して Sauce Labs の認証を受ける必要があります。

  4. デプロイ・ジョブを構成します。 「デプロイ・スクリプト」**フィールドに、コマンド ** を含めます。export CF_APP_NAME="$CF_APP" このコマンドは、アプリ名を環境プロパティーとしてエクスポートします。

  5. テスト・ジョブを構成します。

    サービスインスタンス 」、「 ターゲット 」、「 組織 」、「 スペース 」の各フィールドには、ご利用中の Sauce Labs のユーザー名、リージョン、組織、およびスペースが自動的に入力されます。

    a. テスター・タイプには、Sauce Labs を選択します。

    b. サービスインスタンスについては、ツールチェーン用にSauce Labsを設定した際に使用したSauce Labsのユーザー名を選択してください。

    ツールチェーン用にSauce Labsを設定した際に使用したユーザー名とアクセスキーを確認するには、「 設定 」をクリックしてください。

    c. **「テスト実行コマンド (Test Execution Command)」**フィールドに、テストに必要な依存関係をインストールしてテストを実行するコマンドを入力します。 例えば、Node.js アプリの場合、次のようなコマンドを入力します。

    npm install
    node_modules/grunt-cli/bin/grunt test:sauce:parallel
    

    d. テスト・ジョブ・ログでテストのレポートを確認する場合は、**「テスト・レポートを有効にする (Enable Test Report)」**チェック・ボックスにチェックマークを付け、「テスト結果のファイル・パターン (Test Result File Pattern)」を test/*.xml に設定します。

  6. 保存 をクリックします。 パイプラインが実行されるときには必ず Sauce Labs のテストが実行されます。

API を使用した Delivery Pipeline の設定

ツール Delivery Pipeline 統合は 、ツールチェーン HTTP API および SDK を使用してツール統合 を作成読み取り更新する際に使用できる以下の構成パラメータをサポートしています。

pipeline 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

Delivery Pipelineツール統合パラメータ
パラメーター 使用法 タイプ Terraform 引数 説明
名前 オプション、更新可能 ストリング 名前 このツール統合の名前。