---
title: "イメージ"
url: https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images/
description: "Catalyst Pipelinesのimagesの詳細、関連するキーワード、およびサンプルコードスニペットについて学びます。"
last_updated: 2026-03-30T08:10:30Z
service: Pipelines
type: general
related_links:
  - name: "パイプラインの設定"
    url: /ja/pipelines/help/catalyst-pipelines.yaml/implementation
---

# Images

# はじめに

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

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

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

### Imageのプロパティ

<table class="content-table">
        <thead>
            <tr>
                <th>キー</th>
                <th>値</th>
                <th>必須</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Image Variable Name</td>
                <td>imageにアクセスするために使用されるimage変数名</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`image`</td>
                <td>imageの名前</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`registry`</td>
                <td>imageを取得するURL</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`auth`</td>
                <td>usernameとpasswordキーを含みます。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`auth`</td>
                <td>usernameとpasswordキーを含みます。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`username`</td>
                <td>指定されたregistryのアカウントusername認証情報</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`password`</td>
                <td>指定されたregistryのアカウントpassword認証情報</td>
                <td>はい</td>
            </tr>
            </tbody>
</table>

> **注意:**

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](https://hub.docker.com/)アカウントの`username`と`password`認証情報を必ず指定してください。imageはデフォルトでDockerHubからプルされます。

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

### ImageのYAMLコードスニペット

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

```yaml
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が定義されています（`testImage1`と`testImage2`）。
* `testImage1`は、定義されたregistry URLからnode18の依存関係を使用します。registryの認証資格情報を`auth`キーワードに追加しています。
* デフォルトでは、registryが指定されていないため、`testimage2`は[Dockerhub](https://hub.docker.com/)から**node20**の依存関係を使用します。

### グローバル設定

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

```json
 pipeline-image: image1
```