DocumentaciónAEMGuía del usuario

Variables de canalización en Cloud Manager configuring-pipeline-variables

Última actualización: 6 de noviembre de 2025
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Admin
  • Developer

El proceso de compilación utiliza variables de configuración específicas que no se almacenan en el repositorio de Git. O bien, debe ajustarlas entre ejecuciones de canalización en la misma rama. Cloud Manager permite administrar estas configuraciones como variables de canalización.

Acerca de las variables de canalización pipeline-variables

Con Cloud Manager puede configurar variables de canalización de varias formas diferentes.

Las variables se almacenan como texto sin formato o se cifran en reposo. Las variables están disponibles en el entorno de compilación como una variable de entorno, a la que se puede hacer referencia desde el archivo pom.xml u otras secuencias de comandos de compilación.

Adición de una variable de canalización a través de Cloud Manager ui

Las variables de canalización se pueden configurar y administrar a través de la interfaz de usuario de Cloud Manager. Simplifican la administración de la canalización, especialmente cuando se requieren diferentes configuraciones en diferentes pasos.

Debe tener permisos para editar la canalización y agregar, editar y eliminar variables de canalización.

Si se está ejecutando una canalización, la administración de variables está bloqueada.

Para agregar una variable de canalización mediante Cloud Manager:

  1. Cuando administre sus canalizaciones, haga clic en Puntos suspensivos - Icono de más de la canalización para la cual desea crear variables de canalización.

  2. En el menú desplegable, haga clic en Ver/Editar variables.

    Ver/Editar variables de canalización

  3. En el cuadro de diálogo Configuración de variables, escriba los detalles en la primera fila de la tabla.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Campo Descripción
    Nombre

    Un nombre único de la variable de configuración. Identifica la variable específica que se utiliza en la canalización. Debe cumplir las siguientes convenciones de nomenclatura:

    • Las variables solo pueden contener caracteres alfanuméricos y el guion bajo (_).
    • Los nombres deben estar en mayúsculas.
    • Hay un límite de 200 variables por canalización.
    • Cada nombre debe tener 100 caracteres o menos.
    • Cada string debe tener menos de 2048 caracteres.
    • Cada valor de la variable de tipo secretString debe tener 500 caracteres o menos.
    Valor El valor que contiene la variable.
    Paso aplicado

    Obligatorio. El paso en la canalización al que se aplica la variable:

    • Compilación: la variable se aplica durante el proceso de compilación.
    • Prueba funcional: la variable se usa durante el paso de prueba funcional.
    • Pruebas de IU - La variable se usa durante la fase de pruebas de IU.
    • Implementar: La variable se usa durante el paso de implementación. Por ejemplo, utilice esta variable para canalizaciones de Edge Delivery Services.
    Tipo Seleccione si la variable es texto sin formato o cifrada como secreto.

    Agregar variable

  4. Haga clic en Agregar.

    Añada variables adicionales según sea necesario.

  5. Haga clic en Guardar.

Editar una variable de canalización edit-ui

  1. Al administrar sus canalizaciones, haga clic en Puntos suspensivos - Icono de más de la canalización para la cual desea editar las variables de canalización.

  2. En el menú desplegable, haga clic en Ver/Editar variables.

    Ver/Editar variables de canalización

  3. En el cuadro de diálogo Configuración de variables, haga clic en Puntos suspensivos - Icono de más de la variable que desea cambiar.

  4. En el menú desplegable, haga clic en Editar.

    Editar variable

  5. Actualice el valor de la variable según sea necesario.

    Solo se puede cambiar el valor de la variable.

  6. Realice una de las siguientes acciones:

    • Haga clic en Aplicar - Icono de marca de verificación para aplicar el cambio.
    • Haga clic en Deshacer icono para revertir el cambio.

  7. Haga clic en Guardar.

Eliminar una variable de canalización delete-ui

  1. Al administrar sus canalizaciones, haga clic en Puntos suspensivos - Icono de más de la canalización para la cual desea eliminar variables de canalización.

  2. En el menú desplegable, haga clic en Ver/Editar variables.

    Ver/Editar variables de canalización

  3. En el cuadro de diálogo Configuración de variables, haga clic en Puntos suspensivos - Icono de más de la variable que desea quitar y, a continuación, haga clic en Eliminar.

Establecer variables de canalización mediante la CLI de Cloud Manager cli

Este comando de CLI (interfaz de línea de comandos) configura variables.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

Este comando enumera las variables.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Cuando se utiliza en un archivo de Maven pom.xml, suele ser útil vincular estas variables a las propiedades de Maven mediante una sintaxis similar al siguiente ejemplo:

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>
recommendation-more-help
experience-manager-cloud-service-help-main-toc