---
title: "Variables"
url: https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/variables/
description: "Conoce en detalle las variables 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
---

# Variables

# Introducción

Una variable es un valor de marcador de posición que se puede definir a nivel de job o de pipeline según sea necesario. No es posible definir una variable a nivel de stage.

Puedes definir las variables requeridas para el pipeline como pares clave-valor utilizando la clave `variables`.

### Propiedades de una Variable

<table class="content-table">
        <thead>
            <tr>
                <th>Clave</th>
                <th>Valor</th>
                <th>Es obligatorio</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Nombre de la variable</td>
                <td>Especifica un valor de tipo string para la variable</td>
                <td>Sí</td>
            </tr>
            </tbody>
</table>

### Fragmento de código YAML para Variable

Puedes declarar una variable a nivel de job en el archivo `catalyst-pipelines.yaml` utilizando la siguiente sintaxis:

```yaml
variables:
  target:'app3.1'

```

### Variables globales

Puedes definir una variable a nivel de pipeline directamente desde la consola. Consulta [esta página de ayuda](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/implementation) para conocer los pasos exactos para crear una variable.

> **Note:**

Debes establecer obligatoriamente una variable global llamada **CATALYST_TOKEN** e ingresar el token generado desde tu Catalyst CLI, en caso de que hayas utilizado Catalyst CLI en la ejecución del pipeline. Para obtener tu token, consulta los pasos mencionados en [esta sección de ayuda](https://docs.catalyst.zoho.com/es/cli/v1/cli-options/#--token-lttokengt).

### Acceder a la Variable

Se puede acceder a una variable utilizando cualquiera de los siguientes métodos:

* **`<< variables.{variable_name} >>`** : Se puede utilizar para acceder a cualquier variable definida a nivel de job.

* **`<< event.{variable_name} >>`** : Se puede utilizar para acceder a cualquier variable pasada en el JSON del evento al activar el pipeline manualmente desde la consola.

* **`<< env.{variable_name} >>`** : Se puede utilizar para acceder a variables definidas a nivel de pipeline.