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

# Artifacts

# はじめに

artifactは、pipeline実行中のアプリケーションビルドプロセスで生成されるファイルまたはZIPです。これらのartifactsはデプロイ可能なエンティティであり、インフラストラクチャやアプリが含まれます。pipeline実行中にCatalyst Stratusサービスでartifactsを保存および取得できます。

artifactsには2つのタイプがあります：

* **単一のartifactファイル：** このビルドファイルはCatalyst Stratusのバケットに直接アップロードし、必要に応じてダウンロードできます。

* **artifact ZIP：** このタイプでは、正規表現を設定して関連ファイルを選択し、それらをZIPに圧縮してCatalyst Stratusのバケットにアップロードし、必要に応じてZIPをダウンロードします。

`artifacts`キーを使用して、pipelineに必要なartifactsをkey-value pairsとして定義できます。これらのartifactsは、Catalystコンソールでstepsを使用して作成されたjobsの一部として含めることができます。jobsでのartifact設定の詳細については、[こちらのヘルプセクション](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/implementation/)を参照してください。ただし、[parallel](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/parallel-job/)および[approval](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/approval-job/) jobsには適用されません。

### Artifactのプロパティ

#### アップロード

<table class="content-table">
        <thead>
            <tr>
                <th>キー</th>
                <th>値</th>
                <th>必須</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>`upload`</td>
                <td>このキーには、artifactのアップロードプロセスに必要な設定が含まれます。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`type`</td>
                <td>`file`または`zip`のいずれかの値を指定します。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`name`</td>
                <td>artifactの名前（ファイル名またはZIP名）。
                例：
                SNAPSHOT.jar（fileタイプの場合）
                Build.zip（zipタイプの場合）
                </td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`file`</td>
                <td>artifactファイルのソースパス。
                例：target/demo-0.0.1-SNAPSHOT.jar
                </td>
                <td>はい（artifactタイプがfileの場合）</td>
            </tr>
            <tr>
                <td>`regex`</td>
                <td>ファイルを識別し、一致するすべてのファイルを圧縮する正規表現パターン。
                例：
                - /catalyst/node_modules/**/
                </td>
                <td>はい（artifactタイプがzipの場合）</td>
            </tr>
            <tr>
                <td>`location`</td>
                <td>ファイルまたはZIPをアップロードするStratusのロケーションパス。
                例：
                stratus://<<env.BUCKET_NAME >>/ （送信先）
                </td>
                <td>はい</td>
            </tr>
            </tbody>
</table>

#### ダウンロード

<table class="content-table">
        <thead>
            <tr>
                <th>キー</th>
                <th>値</th>
                <th>必須</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>`download`</td>
                <td>このキーには、artifactのダウンロードプロセスに必要な設定が含まれます。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`type`</td>
                <td>fileまたはzip。お好みに応じてこの値を指定します。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`name`</td>
                <td>Stratus内のartifactの名前。
                例：
                SNAPSHOT.jar（fileタイプの場合）
                Build.zip（zipタイプの場合）
                </td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`file`</td>
                <td>ファイルをダウンロードする送信先パス。
                例：/SNAPSHOT.jar
                </td>
                <td>はい（artifactタイプがfileの場合）</td>
            </tr>
            <tr>
                <td>`location`</td>
                <td>ファイルをダウンロードするStratusのロケーション。
                例：
                stratus://<<env.BUCKET_NAME >>/ artifact名
                </td>
                <td>はい</td>
            </tr>
            </tbody>
</table>

> **注意:**

artifactタイプがzipに設定されている場合、ZIPファイルはデフォルトでルートディレクトリにダウンロードされます。

artifactsが設定されたサンプルYAMLコードスニペットについては、[こちらのセクション](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction)を参照してください。