お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Images

imageは、pipeline内でjobを実行するために必要な依存関係を含む実行可能なパッケージです。Catalyst Pipelinesは、Docker Hubやその他のプライベートレジストリなどのコンテナレジストリとシームレスに統合し、pipeline実行中にimagesと依存関係をプルします。

さまざまなオペレーティングシステム、プログラミング言語、フレームワーク、ツールをサポートする幅広いimagesから、特定の要件に合ったものを選択できます。また、事前定義されたimagesを使用することで、pipelineのさまざまなstagesおよび環境間での一貫性と再現性が保証されます。

registryキーを使用してコンテナレジストリURLを明示的に指定することで、imagesをプルできます。registry URLが定義されていない場合、imagesはデフォルトでDockerhubコンテナからプルされます。imagesキーを使用して、pipelineに必要なimagesを定義できます。

Imageのプロパティ

キー 必須
Image Variable Name imageにアクセスするために使用されるimage変数名 はい
image imageの名前 はい
registry imageを取得するURL いいえ
auth usernameとpasswordキーを含みます。 はい
auth usernameとpasswordキーを含みます。 はい
username 指定されたregistryのアカウントusername認証情報 はい
password 指定されたregistryのアカウントpassword認証情報 はい
注意:
  1. imageの定義は必須ではありません。imageが指定されていない場合、Catalyst CLIがプリインストールされたデフォルトのUbuntu imageがjobsの実行にデフォルトで使用されます。

  2. imagesはpipelineレベル、stageレベル、またはjobレベルで定義できます。複数の定義がある場合、最下位レベル(つまりjob)で指定されたものが優先されます。

  3. stage内の2つのjobsに同じimageが指定されている場合、キャッシュされたimageが2番目のjobに自動的に再利用され、パフォーマンス速度が向上します。

  4. image nameが指定されてregistry URLが指定されていない場合は、authキーにDockerhubアカウントのusernamepassword認証情報を必ず指定してください。imageはデフォルトでDockerHubからプルされます。

セキュリティ上の理由から、パスワード情報をグローバル設定のvariableとして保存し、catalyst-pipelines.yamlファイルで« env.{variable_name} »を使用してアクセスすることを強く推奨します。コンソールからvariablesをグローバルに設定する方法については、こちらのヘルプセクションを参照してください。

ImageのYAMLコードスニペット

以下は、pipelineで定義できるimagesのサンプルコードスニペットです:

copy
images:
  testImage1:
    image: node:18
    registry: my.private.registry.com
    auth:
      username: ameliab
      password: zylker@123
  testImage2:
    image: node:20
    auth:
      username: ameliab
      password: zylker@123

上記のコードスニペットは以下を示しています:

  • pipelineには2つのimagesが定義されています(testImage1testImage2)。
  • testImage1は、定義されたregistry URLからnode18の依存関係を使用します。registryの認証資格情報をauthキーワードに追加しています。
  • デフォルトでは、registryが指定されていないため、testimage2Dockerhubからnode20の依存関係を使用します。

グローバル設定

必要に応じて、pipelineレベルでimageを定義することもできます。このimage設定は、すべてのstagesとjobsからアクセス可能になります。pipelineレベルでのimage設定は以下のように行います:

copy
 pipeline-image: image1

最終更新日 2026-03-30 13:40:30 +0530 IST