Tutorial: Uso de variables a nivel de canalización

En este tutorial, crearás una canalización en la que añadirás una variable a nivel de canalización y ejecutarás una acción de CodeBuild creación que generará el valor de la variable.

importante

Como parte de la creación de una canalización, se utilizará un depósito de artefactos de S3 proporcionado por el cliente CodePipeline para crear artefactos. (Es diferente del bucket que se usa para una acción de origen de S3). Si el depósito de artefactos de S3 está en una cuenta diferente a la de tu canalización, asegúrate de que el depósito de artefactos de S3 pertenezca a una Cuentas de AWS persona segura y fiable.

Requisitos previos

Antes de empezar, debe hacer lo siguiente:

• Crea un repositorio. CodeCommit

• Añada un archivo .txt al repositorio.

Paso 1: Crear la canalización y compilar el proyecto

En esta sección, debe crear una canalización con las siguientes acciones:

• Una etapa de origen con una conexión a tu CodeCommit repositorio.

• Una etapa de creación con una acción de AWS CodeBuild creación.

Para crear una canalización con el asistente

1. Inicia sesión en la CodePipeline consola en https://console.aws.amazon.com/codepipeline/.

2. En la página Bienvenido, Introducción o en la página Canalizaciones, elija Crear canalización.

3. En la página Paso 1: elección de la opción de creación, en Opciones de creación, seleccione la opción Crear una canalización personalizada. Elija Next (Siguiente).

4. En Paso 2: elegir la configuración de la canalización, en Nombre de la canalización, escriba MyVariablesPipeline.

5. En Tipo de canalización, mantenga la selección predeterminada en V2. Los tipos de canalización difieren en características y precio. Para obtener más información, consulte Tipos de canalización.

6. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

   nota

   Si opta por utilizar su función de CodePipeline servicio actual, asegúrese de haber añadido el permiso de codeconnections:UseConnection IAM a su política de función de servicio. Para obtener instrucciones sobre la función de CodePipeline servicio, consulte Añadir permisos a la función de CodePipeline servicio.

7. En Variables, seleccione Añadir variable. En Name (Nombre), escriba timeout. En Predeterminado, escriba 1000. En la descripción, introduzca la siguiente descripción: Timeout.

   Esto creará una variable en la que podrá declarar el valor cuando comience la ejecución de la canalización. Los nombres de las variables deben coincidir con [A-Za-z0-9@\-_]+ y pueden ser cualquier cosa excepto una cadena vacía.

8. Para Configuración avanzada deje los valores predeterminados. En Artifact store (Almacén de artefactos), elija Default location (Ubicación predeterminada) para utilizar el almacén de artefactos predeterminado, como el bucket de artefacto de Amazon S3 que se estableció como predeterminado, para la canalización en la región que seleccionó para esta.

   nota

   Este no es el bucket de origen para su código fuente. Este es el almacén de artefactos de la canalización. Cada canalización debe tener su propio almacén de artefactos independiente, como un bucket de S3.

   Elija Next (Siguiente).

9. En la página Paso 3: agregar la etapa de origen, agregue una etapa de origen:

   1. En Source provider (Proveedor de código fuente), elija AWS CodeCommit.

   2. En Nombre del repositorio y Nombre de la ramificación, elija su repositorio y ramificación.

   Elija Next (Siguiente).

10. En el paso 4: Agregar una etapa de compilación, agregue una etapa de compilación:

    1. En Build provider (Proveedor de compilación), elija AWS CodeBuild. En el campo Region (Región) conserve el valor predeterminado de la región de la canalización.

    2. Elija Crear proyecto.

    3. En Project name (Nombre de proyecto), escriba un nombre para este proyecto de compilación.

    4. En Environment image (Imagen de entorno), elija Managed image (Imagen administrada). En Operating system (Sistema operativo), elija Ubuntu.

    5. En Runtime, elija Standard (Estándar). En Imagen, escoja: 5.0. aws/codebuild/standard

    6. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

       nota

       Anote el nombre de su función de servicio. CodeBuild Necesitará el nombre del rol para el paso final de este tutorial.

    7. En Buildspec, para Build specifications (Especificaciones de la compilación), elija Insert build commands (Insertar comandos de compilación). Elija Cambiar a editor y pegue lo siguiente en Comandos de compilación: En la especificación de compilación, se utilizará la variable de cliente $CUSTOM_VAR1 para generar la variable de canalización en el registro de compilación. En el siguiente paso, creará la variable de salida $CUSTOM_VAR1 como variable de entorno.

       version: 0.2
       #env:
         #variables:
            # key: "value"
            # key: "value"
         #parameter-store:
            # key: "value"
            # key: "value"
         #git-credential-helper: yes
       phases:
         install:
           #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
           #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
           runtime-versions:
             nodejs: 12
           #commands:
             # - command
             # - command
         #pre_build:
           #commands:
             # - command
             # - command
         build:
           commands:
             - echo $CUSTOM_VAR1
         #post_build:
           #commands:
             # - command
             # - command
       artifacts:
         files:
            - '*'
           # - location
         name: $(date +%Y-%m-%d)
         #discard-paths: yes
         #base-directory: location
       #cache:
         #paths:
           # - paths

    8. Selecciona Continuar a CodePipeline. Esto vuelve a la CodePipeline consola y crea un CodeBuild proyecto que utiliza los comandos de compilación para la configuración. El proyecto de compilación usa un rol de servicio para administrar Servicio de AWS los permisos. Es posible que este paso tarde un par de minutos.

    9. En Variables de entorno (opcional), para crear una variable de entorno como variable de entrada para la acción de creación que resolverá la variable a nivel de canalización, elija Añadir variable de entorno. Esto creará la variable especificada en la especificación de compilación como $CUSTOM_VAR1. En Name (Nombre), escriba CUSTOM_VAR1. En Valor, escriba #{variables.timeout}. En Tipo, elija Plaintext.

       El #{variables.timeout} valor de la variable de entorno se basa en el espacio de nombres de la variable a nivel de canalización variables y en la variable a nivel de canalización timeout creada para la canalización en el paso 7.

    10. Elija Next (Siguiente).

11. En el paso 5: Añadir la fase de prueba, seleccione Omitir fase de prueba y, a continuación, acepte el mensaje de advertencia seleccionando Omitir de nuevo.

    Elija Next (Siguiente).

12. En la página Paso 6: Añadir fase de despliegue, seleccione Omitir fase de despliegue y, a continuación, acepte el mensaje de advertencia seleccionando Omitir de nuevo. Elija Next (Siguiente).

13. En el paso 7: Revisar, selecciona Crear canalización.

Paso 2: Publicar los cambios y ver los registros

1. Después de que la canalización se ejecute correctamente, en la etapa de implementación, elija Ver detalles.

   En la página de detalles, elija la pestaña Registros. Vea el resultado de la CodeBuild compilación. Los comandos muestran el valor de la variable introducida.

2. En el panel de navegación de la izquierda, elija Historial.

   Elija la ejecución reciente y, a continuación, elija la pestaña Variables. Vea el valor resuelto de la variable de canalización.