Anulaciones de etiquetas admitidas con el ejecutor de GitHub Actions alojado en CodeBuild
En el YAML del flujo de trabajo de GitHub Actions, puede proporcionar una variedad de anulaciones de etiquetas que modifiquen la compilación del ejecutor autoalojado. Cualquier compilación no reconocida por CodeBuild se ignorará, pero no generará ningún error en la solicitud de webhook. Por ejemplo, el siguiente YAML de flujo de trabajo incluye anulaciones para imagen, tamaño de instancia, flota y buildspec:
name: Hello World on: [push] jobs: Hello-World-Job: runs-on: - codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }} image:${{ matrix.os }} instance-size:${{ matrix.size }} fleet:myFleet buildspec-override:true strategy: matrix: include: - os: arm-3.0 size: small - os: linux-5.0 size: large steps: - run: echo "Hello World!"
nota
Si el trabajo de flujo de trabajo está pendiente en GitHub, consulte Solución de problemas del webhook y Uso de etiquetas personalizadas para enrutar trabajos
codebuild- (obligatorio)<project-name>-${{github.run_id}}-${{github.run_attempt}}
Ejemplo::
codebuild-fake-project-${{ github.run_id }}-${{ github.run_attempt }}-
Obligatorio para todos los YAML de flujo de trabajo de GitHub Actions.
<project name>debe coincidir con el nombre del proyecto para el que está configurado el webhook del ejecutor autoalojado.
image:<environment-type>-<image-identifier>
Ejemplo::
image:arm-3.0-
Anula la imagen y el tipo de entorno utilizados al iniciar la compilación del ejecutor autoalojado con una imagen seleccionada. Para obtener más información sobre los valores admitidos, consulte Imágenes de computación compatibles con el ejecutor de GitHub Actions alojado en CodeBuild.
Para anular la imagen y el tipo de entorno utilizados con una imagen personalizada, utilice
image:custom-<environment-type>-<custom-image-identifier>Ejemplo::
image:custom-arm-public.ecr.aws/codebuild/amazonlinux-aarch64-standard:3.0nota
Si la imagen personalizada se encuentra en un registro privado, consulte Configuración de una credencial de registro privada para ejecutores autoalojados.
instance-size:<instance-size>
Ejemplo::
instance-size:medium-
Anula el tipo de instancia utilizado al iniciar la compilación del ejecutor autoalojado. Para obtener más información sobre los valores admitidos, consulte Imágenes de computación compatibles con el ejecutor de GitHub Actions alojado en CodeBuild.
fleet:<fleet-name>
Ejemplo::
fleet:myFleet-
Anula la configuración de flota establecida en el proyecto para usar la flota especificada. Para obtener más información, consulte Ejecución de compilaciones en flotas de capacidad reservada.
buildspec-override:<boolean>
Ejemplo::
buildspec-override:true-
Permite que la compilación ejecute comandos buildspec en las fases
INSTALL,PRE_BUILDyPOST_BUILDsi está establecido entrue.
Anulación de una sola etiqueta (heredado)
CodeBuild permite proporcionar varias anulaciones en una sola etiqueta de las formas que se indican a continuación:
-
Para anular la configuración del entorno en una compilación de computación de Amazon EC2 o Lambda, utilice la sintaxis siguiente:
runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>-<image-identifier>-<instance-size> -
Para anular la configuración de la flota en una compilación de computación de Amazon EC2, utilice la sintaxis siguiente:
runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name> -
Para anular tanto la flota como la imagen utilizadas para la compilación, utilice la sintaxis siguiente:
runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-image-<image-version>-fleet-<fleet-name> -
Para ejecutar comandos buildspec durante la compilación, se puede agregar
-with-buildspeccomo sufijo a la etiqueta:runs-on: codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}-<image>-<image-version>-<instance-size>-with-buildspec -
Si lo desea, puede proporcionar una anulación del tamaño de la instancia sin anular la imagen. En el caso de las compilaciones de Amazon EC2, puede excluir tanto el tipo de entorno como el identificador de imagen. En el caso de las compilaciones de Lambda, puede excluir el identificador de imagen.