---
title: "Imágenes"
url: https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/build-the-pipeline/images/
description: "Conoce en detalle las images de Catalyst Pipelines, las palabras clave asociadas y fragmentos de código de ejemplo."
last_updated: 2026-03-30T08:10:30Z
service: Pipelines
type: general
related_links:
  - name: "Configure the Pipeline"
    url: /es/pipelines/help/catalyst-pipelines.yaml/implementation
---

# Images

# Introducción

Una image es un paquete ejecutable que contiene las dependencias necesarias para ejecutar un job en el pipeline. Catalyst Pipelines se integra de forma transparente con registros de contenedores como Docker Hub u otros registros privados para obtener images y dependencias durante la ejecución del pipeline.

Puedes elegir entre una amplia variedad de images que admiten diversos sistemas operativos, lenguajes de programación, frameworks y herramientas para adaptarse a tus requisitos específicos. Además, el uso de images predefinidas garantiza consistencia y reproducibilidad en las diferentes fases del pipeline y entornos.

Puedes obtener images especificando la URL del registro de contenedores explícitamente utilizando la clave `registry`. Si la URL del registro no se define, las images se obtienen del contenedor de [Dockerhub](https://hub.docker.com/) por defecto. Puedes definir las images requeridas para el pipeline utilizando la clave `images`.

### Propiedades de una Image

<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 de Image</td>
                <td>El nombre de la variable de image utilizado para acceder a la image</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`image`</td>
                <td>El nombre de la image</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`registry`</td>
                <td>La URL desde la cual se debe obtener la image.</td>
                <td>No</td>
            </tr>
            <tr>
                <td>`auth`</td>
                <td>Contiene las claves username y password.</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`auth`</td>
                <td>Contiene las claves username y password.</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`username`</td>
                <td>La credencial de nombre de usuario de la cuenta del registro especificado.</td>
                <td>Sí</td>
            </tr>
            <tr>
                <td>`password`</td>
                <td>La credencial de contraseña de la cuenta del registro especificado.</td>
                <td>Sí</td>
            </tr>
            </tbody>
</table>

> **Note:**

1. Definir una image no es obligatorio. Si no se especifica una image, se utiliza por defecto la image de Ubuntu con Catalyst CLI preinstalado para ejecutar los jobs.

2. Puedes definir images a nivel de pipeline, de stage o de job. En caso de múltiples definiciones, la especificada en el nivel más bajo (es decir, job) tiene prioridad.

3. Si se especifica la misma image para dos jobs dentro de un stage, la image en caché se reutilizará automáticamente para el segundo job, mejorando la velocidad de rendimiento.

4. Si se especifica el nombre de la image y no se proporciona la URL del registro, asegúrate de proporcionar las credenciales de `username` y `password` de tu cuenta de [Dockerhub](https://hub.docker.com/) en la clave `auth`. La image se obtendrá de DockerHub por defecto.

Por razones de seguridad, recomendamos encarecidamente almacenar la información de tu contraseña como una variable en la configuración global y acceder a ella mediante `<< env.{variable_name} >>` en el archivo `catalyst-pipelines.yaml`. Puedes consultar [esta sección de ayuda](https://docs.catalyst.zoho.com/es/pipelines/help/catalyst-pipelines.yaml/implementation) para aprender cómo configurar variables globalmente desde la consola.

### Fragmento de código YAML para Image

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

```yaml
images:
  testImage1:
    image: node:18
    registry: my.private.registry.com
    auth:
      username: ameliab
      password: zylker@123
  testImage2:
    image: node:20
    auth:
      username: ameliab
      password: zylker@123

```

El fragmento de código anterior ilustra lo siguiente:

* Se definen dos images en el pipeline (`testImage1` y `testImage2`).
* La `testImage1` utiliza las dependencias de node18 desde la URL del registro definida. Se han agregado las credenciales de autenticación para el registro en la palabra clave `auth`.
* Por defecto, dado que no se especifica el registro, la `testimage2` utiliza las dependencias de **node20** desde [Dockerhub](https://hub.docker.com/).

### Configuración global

También puedes definir la image a nivel de pipeline, si es necesario. Esta configuración de image será accesible para todos los stages y jobs. Puedes configurar una image a nivel de pipeline de la siguiente manera:

```json
 pipeline-image: image1
```