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

# Stages

# はじめに

stageは、pipeline内のjobsの実行順序を整理する重要なコンポーネントです。各stageは、アプリケーションのビルド、テスト、デプロイなど、ソフトウェアデリバリープロセスの個別のフェーズを表します。stagesにより、jobsの論理的なグループ化と分離が可能になり、より高速なビルドとデプロイのための並列実行が実現します。また、ワークフローを管理可能な単位に分解することで複雑なpipelinesの効率的な管理を促進し、デプロイプロセス全体の明確さと制御を提供します。

`stages`キーを使用して、pipelineに必要なstagesをkey-value pairsとして定義できます。

`<< status.{stage_name} >>`を使用して、stageの現在のステータスを取得できます。

> **注意:**

1. pipeline内の複数のstagesは、デフォルトで順次実行され、1つずつ進行します。stage実行の条件を定義するオプションがあり、各stageがいつトリガーされるかをカスタマイズして制御できます。pipelineでの条件の定義方法については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/when-condition)を参照してください。

2. pipeline設定では、少なくとも1つのstageが必要で、最大5つのstagesまでです。また、各stageは[parallel jobs](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/parallel-job)を含めて最大5つのjobsを収容できます。

### Stageのプロパティ

以下の属性の1つまたは複数の組み合わせで、pipeline内のstagesを定義できます：

<table class="content-table">
        <thead>
            <tr>
                <th>キー</th>
                <th>値</th>
                <th>必須</th>
            </tr>
        </thead>
        <tbody>
        <tr>
                <td>name</td>
                <td>stage nameを文字列値として指定します。</td>
                <td>はい</td>
            </tr>
            <tr>
                <td>`[jobs](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction)`</td>
                <td>jobsの配列</td>
                <td>はい</td>
            </tr>
            </tr>
            <tr>
                <td>`[runner](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/runners)`</td>
                <td>jobsを実行するrunnerの名前</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`[image](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images)`</td>
                <td>特定のstageでのjob実行に使用されるimageの名前</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`[when](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/when-condition)`</td>
                <td>stageを実行するための条件ロジック。基本条件とともに`"and"`、`"or"`、`"not"`、`"not-equal"`、または`"equal"`演算子を使用できます。</td>
                <td>いいえ</td>
            </tr>
        </tbody> 
</table>

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

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

```yaml
stages:
  - name: testStage1
    runner: runner1
    image: testImage1
    jobs:
      - testJob1
	   when:
     - and:
      - equal:
          - << pipeline.event.branch >>
          - master
      - true
  - name: testStage2
    jobs:
      - testJob1
      - - testJob2
        - testJob3

```

上記のコードは以下のワークフローを示しています：

* pipelineには2つのstagesが定義されています - `testStage1`と`testStage2`。
* stage `testStage1`は1つのjob（`testJob1`）を実行し、stage `testStage2`は3つのjobs（`testJob1`とparallel job）を実行します。parallel jobには、それぞれ`testJob2`と`testJob3`が含まれます。
* runnerとimageはstageレベルで定義されており、両方のstagesで利用されます。
* when conditionは、現在のbranchがmasterを指しているかどうかを検証し、それがtrueの場合、`testJob1`が実行されます。