Artifacts

# Artifacts

# はじめに

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

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

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

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

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

### Artifactのプロパティ

#### アップロード

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

{{%note%}}{{%bold%}}注意:{{%/bold%}}

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

artifactsが設定されたサンプルYAMLコードスニペットについては、{{%link href="/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction" %}}こちらのセクション{{%/link%}}を参照してください。

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

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

artifactsキーを使用して、pipelineに必要なartifactsをkey-value pairsとして定義できます。これらのartifactsは、Catalystコンソールでstepsを使用して作成されたjobsの一部として含めることができます。jobsでのartifact設定の詳細については、こちらのヘルプセクションを参照してください。ただし、parallelおよびapproval jobsには適用されません。

Artifactのプロパティ

アップロード

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

ダウンロード

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

注意:

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

artifactsが設定されたサンプルYAMLコードスニペットについては、こちらのセクションを参照してください。

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

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

パイプラインの設定