例

パイプライン UI に必要なパラメーターを追加することで、独自のビルド用の Artifactory 認証資格情報を作成することができます。

     my-artifactory-email
    my-artifactory-user
    my-artifactory-password
    my-artifactory-url

これらのパラメーターをパイプラインで使用できる場合は、ユーザー・スクリプトでこれらにアクセスして Docker 認証 JSON ファイルを作成できます。 以下に例を示します。

kubectl create secret docker-registry regcred \
  --o json \
  --dry-run=client \
  --docker-server="$(get_env my-artifactory-url)" \
  --docker-username="$(get_env my-artifactory-user)" \
  --docker-email="$(get_env my-artifactory-email)" \
  --docker-password="$(get_env my-artifactory-password)" \
   | jq -r '.data[".dockerconfigjson"]'

{"auths":{"us.icr.io":{"username":"user@ibm.com","password":"secret-password","email":"user@ibm.com","auth":"dXNlckBpYm0uY29tOnNlY3JldC1wYXNzd29yZA=="}}}

カスタム・スクリプトのパラメーター

パイプライン環境変数とシークレットに加えて、これらのパラメーター値がユーザー・スクリプト・ステージ用に提供されています。

ユーザー・スクリプトで pipelinectl コマンドを使用して、リポジトリー、成果物、ファイル、および環境変数にアクセスできます。 メソッド list_repos、load_repo、load_artifact、list_artifacts、および get_env を使用します。

カスタム・スクリプトからのツールチェーン・データへのアクセス

toolchain.json file 環境変数に格納されたパスの位置にパイプラインによって提供された TOOLCHAIN_DATA_PATHから、ツールチェーン・データを読み取ることができます。 また、ツールチェーン統合と jsonpath を使用し、/config にあるそれらに、他の変数と同様の方法でアクセスすることもできます。 あるいは、get_env を使用することによってもアクセスできます。

TOOLCHAIN_CONFIG_JSON="$(get_env TOOLCHAIN_CONFIG_JSON)"
toolchain_id=$(jq -r '.toolchain_guid' "$TOOLCHAIN_CONFIG_JSON")

共有ワークスペース

これらのカスタム・スクリプトは同じワークスペースで動作するため、これらのスクリプトの間では、データをファイルに書き込み、それをもう一方のタスクで読み込むことで、データを受け渡すことができます。 このワークスペースは、$WORKSPACE 変数で指定されたパスにマウントされます。

echo -n "$DIGEST" > "${WORKSPACE}"/image-digest

image_digest=$(cat "${WORKSPACE}"/image-digest)

カスタム終了ステージ

終了ステージには、以下の 3 つのステップがあります。

このパイプラインの状況は、以下の 2 つの方法で判別できます。

1. パイプライン実行の全体的な状況は、環境変数 PIPELINE_STATUS から取得できます。 値は、「Succeeded」、「Failed」、または「"」(大/小文字の区別あり) のいずれかです。 PIPELINE_STATUS は、基礎となる Tekton フレームワークから提供されます。
2. evaluate ステップはエビデンスの観点からパイプライン実行を評価するため、この評価は PIPELINE_STATUS で設定された値とは異なる場合があります。 エビデンス評価に基づいてパイプラインの状況を表示するには、環境変数 finish_evaluate_exit_code を使用します。