---
title: "Introducción"
url: https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/jobs/introduction/
description: "Conoce en detalle los jobs de Catalyst Pipelines, las palabras clave asociadas y fragmentos de código de ejemplo."
last_updated: 2026-03-20T16:21:56Z
service: Pipelines
type: general
related_links:
  - name: "Configure the Pipeline"
    url: /es/pipelines/help/catalyst-pipelines.yaml/implementation
---

# Jobs

# Introducción

Un job es una secuencia de [steps](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps) que se ejecutan en el pipeline. Es obligatorio definir al menos un job en el pipeline. Puedes definir los jobs requeridos para el pipeline como pares clave-valor utilizando la clave `jobs`.

Además de los jobs regulares definidos en el pipeline, puedes configurar los siguientes jobs:

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

Puedes obtener el estado de un job utilizando `<< status.{stage_name}.{job_name} >>`.

### Propiedades de un Job

<table class="content-table">
        <thead>
            <tr>
                <th>Clave</th>
                <th>Valor</th>
                <th>Es obligatorio</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>`[variables](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/variables)`</td>
                <td>Un arreglo de variables</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`[artifacts](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts)`</td>
                <td>Incluye las claves `upload` y `download`. Consulta [esta página de ayuda](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/artifacts) para más detalles.</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`notify`</td>
                <td>Esta clave se puede configurar para enviar correos electrónicos de notificación sobre el job antes de que comience su ejecución y después de que la ejecución del job se complete.
                Contiene las subclaves `on-start` y `on - end`</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`on-start / on -end`</td>
                <td>Contiene las subclaves `notify-type` y `notify-variables`.</td>
                <td>Sí (si se utiliza `notify`)</td>
            </tr>
            <tr>
                <td>`notify-type`</td>
                <td>Proporciona el valor como `email`.</td>
                <td>Sí (si se utiliza `notify`)</td>
            </tr>
            <tr>
                <td>`notify-variables`</td>
                <td>Proporciona la dirección de correo electrónico a notificar cuando comience la ejecución del job (para `on-start`) y la dirección de correo electrónico a notificar cuando el job complete su ejecución exitosamente (para `on-end`)</td>
                <td>Sí (si se utiliza `notify`)</td>
            </tr>
            <tr>
                <td>`[runner](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/runners)`</td>
                <td>Especifica el nombre del runner en el cual se deben ejecutar los jobs.</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`[image](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images)`</td>
                <td>Especifica el nombre de la image necesaria para la ejecución del job específico.</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`cwd`</td>
                <td>Especifica el directorio de trabajo actual en el cual se debe ejecutar el job.</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`[steps](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/steps)`</td>
                <td>Un arreglo que contiene los scripts que necesitan ejecutarse en el pipeline.</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`[when](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/when-condition)`</td>
                <td>Especifica las condiciones que determinan si el job debe ejecutarse o no.</td>
                <td>No</td>
            </tr>
            </tbody>
</table>

### Fragmento de código YAML para Job

A continuación se muestra un fragmento de código de ejemplo para jobs que se pueden definir en un pipeline:

```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"

```

El código anterior ilustra el siguiente flujo de trabajo:

* Hay tres jobs definidos en el pipeline: `testJob1`, `testJob2`, `testJob3`.
* El `testJob2` está configurado para ejecutarse solo si la rama de trabajo actual en el repositorio es la rama main.
* El `testJob2` maneja el proceso de almacenar y recuperar los archivos de compilación generados hacia y desde Catalyst Stratus. Esto se define utilizando las claves `upload` y `download`.
* También envía una notificación a la dirección de correo electrónico definida para mantenerla informada sobre el inicio de la ejecución del job y la finalización del mismo. Esto se logra utilizando las claves `notify on-start` y `on-end`.