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

# Jobs

# はじめに

jobは、pipelineで実行される[steps](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps)のシーケンスです。pipelineには少なくとも1つのjobを定義することが必須です。`jobs`キーを使用して、pipelineに必要なjobsをkey-value pairsとして定義できます。

pipelineで定義される通常のjobs以外に、以下のjobsも設定できます：

* **Approval Job**
* **Parallel Job**

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

### Jobのプロパティ

<table class="content-table">
        <thead>
            <tr>
                <th>キー</th>
                <th>値</th>
                <th>必須</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>`[variables](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/variables)`</td>
                <td>variablesの配列</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`[artifacts](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts)`</td>
                <td>`upload`と`download`キーを含みます。詳細については、[こちらのヘルプページ](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts)を参照してください。</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`notify`</td>
                <td>このキーは、job実行の開始前および完了後にjobに関する通知メールを送信するように設定できます。
                サブキー`on-start`と`on - end`を含みます。</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`on-start / on -end`</td>
                <td>サブキー`notify-type`と`notify-variables`を含みます。</td>
                <td>はい（`notify`を使用する場合）</td>
            </tr>
            <tr>
                <td>`notify-type`</td>
                <td>値として`email`を指定します。</td>
                <td>はい（`notify`を使用する場合）</td>
            </tr>
            <tr>
                <td>`notify-variables`</td>
                <td>job実行開始時に通知するメールアドレス（`on-start`の場合）およびjob実行が正常に完了した時に通知するメールアドレス（`on-end`の場合）を指定します。</td>
                <td>はい（`notify`を使用する場合）</td>
            </tr>
            <tr>
                <td>`[runner](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/runners)`</td>
                <td>jobsを実行するrunner nameを指定します。</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`[image](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images)`</td>
                <td>特定のjob実行に必要なimage nameを指定します。</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`cwd`</td>
                <td>jobを実行するworking directoryを指定します。</td>
                <td>いいえ</td>
            </tr>
            <tr>
                <td>`[steps](https://docs.catalyst.zoho.com/ja/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps)`</td>
                <td>pipelineで実行する必要があるスクリプトを含む配列。</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>jobを実行するかどうかを決定する条件を指定します。</td>
                <td>いいえ</td>
            </tr>
            </tbody>
</table>

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

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

```yaml
jobs:
  testJob1:
    steps:
      - echo "Enter your scripts here"
  testJob2:
    variables:
      BRANCH: main
    artifacts:
      upload:
        - name: artifactTest
          type: zip
          location: stratus://mybucket/home/artifacts
          files:
            - '**/*'
      download:
        - name: artifactTest
		    type: zip
          location: stratus://mybucket/home/artifacts
   notify:
      on-start:
        - notify-type: email
          notify-variables:
            to: amelia.burrows@zylker.com
      on-end:
        - notify-type: email
          notify-variables:
            to: amelia.burrows@zylker.com
    runner: runner2
    image: testImage1
    cwd: cd ./src
    steps:
      - echo "Enter your scripts here"
    and:
      - equal:
          - << pipeline.event.branch >>
          - main
      - true
  testJob3:
    steps:
      - echo "Hello"

```

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

* pipelineには3つのjobsが定義されています - `testJob1`、`testJob2`、`testJob3`。
* `testJob2`は、repository内の現在のworking branchがmain branchの場合にのみ実行されるように設定されています。
* `testJob2`は、生成されたビルドファイルをCatalyst Stratusに保存および取得するプロセスを処理します。これは`upload`と`download`キーを使用して定義されます。
* また、job実行の開始とjobの完了について情報を提供するために、定義されたメールアドレスに通知を送信します。これは`notify on-start`と`on-end keys`を使用して実現されます。