Images
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 por defecto. Puedes definir las images requeridas para el pipeline utilizando la clave images.
Propiedades de una Image
| Clave | Valor | Es obligatorio |
|---|---|---|
| Nombre de la variable de Image | El nombre de la variable de image utilizado para acceder a la image | Sí |
| image | El nombre de la image | Sí |
| registry | La URL desde la cual se debe obtener la image. | No |
| auth | Contiene las claves username y password. | Sí |
| auth | Contiene las claves username y password. | Sí |
| username | La credencial de nombre de usuario de la cuenta del registro especificado. | Sí |
| password | La credencial de contraseña de la cuenta del registro especificado. | Sí |
-
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.
-
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.
-
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.
-
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 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 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:
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.
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:
pipeline-image: image1Última actualización 2026-03-30 13:40:30 +0530 IST
Yes
No
Thank you for your feedback!
Send your feedback to us