Creación de un proyecto de compilación (consola)

Abra el iconoAWS CodeBuildConsola dehttps://console.aws.amazon.com/codesuite/codebuild/home.

Si aparece una página de información de CodeBuild, elija.Crear un proyecto de compilación. De lo contrario, en el panel de navegación, expandaBuild, eligeProyectos de compilacióny luego seleccioneCrear un proyecto de compilación.

Elija Create build project (Crear proyecto de compilación).

Rellene las siguientes secciones. Una vez completado, seleccioneCrear un proyecto de compilaciónen la parte inferior de la página.

Configuración de proyectos

Project name (Nombre de proyecto)

Escriba un nombre para este proyecto de compilación. Los nombres de los proyectos de compilación debe ser únicos en cada cuenta de AWS.

Descripción

Introduzca una descripción opcional del proyecto de compilación para ayudar a otros usuarios a entender para qué se utiliza este proyecto.

Crear insignias de

(Opcional) SeleccioneHabilitar insigniasPara convertir el estado de compilación del proyecto en visible e incrustable. Para obtener más información, consulte Ejemplo de insignias de compilación.

nota

Crear insignia no se aplica si el proveedor de código fuente es Amazon S3.

Habilitar límite de compilación simultánea

(Opcional) Si desea limitar el número de compilaciones simultáneas de este proyecto, siga estos pasos:

1. SelectRestringir el número de compilaciones simultáneas que este proyecto puede iniciar.

2. EnLímite de compilación simultánea, introduzca el número máximo de versiones simultáneas que están permitidas para este proyecto. Este límite no puede ser superior al límite de compilación simultáneo establecido para la cuenta. Si intenta introducir un número mayor que el límite de la cuenta, se muestra un mensaje de error.

Las nuevas versiones solo se inician si el número actual de versiones es menor o igual a este límite. Si el recuento de versiones actual cumple con este límite, las nuevas versiones se limitan y no se ejecutan.

Información adicional

(Opcional) En Tags (Etiquetas), escriba el nombre y el valor de las etiquetas que desea que usen los servicios compatibles de AWS. Use Add row para añadir una etiqueta. Puede añadir hasta 50 etiquetas.

Source

Proveedor de origen

Elegir el tipo de proveedor de código fuente. Utilice las siguientes listas para realizar las selecciones apropiadas para el proveedor de código fuente:

nota

CodeBuild no admite Bitbucket Server.

Amazon S3

Bucket

Elija el nombre del bucket de entrada que contiene el código fuente.

Clave de objeto de S3 o carpeta de S3

Introduzca el nombre del archivo ZIP o la ruta a la carpeta que contiene el código fuente. Incluya una barra diagonal (/) para descargarlo todo en el bucket de S3.

Versión de origen

Introduzca el ID de versión del objeto que representa la compilación del archivo de entrada. Para obtener más información, consulte Ejemplo de versión de origen con AWS CodeBuild.

CodeCommit

Repositorio

Elegir el repositorio que desea utilizar.

Tipo de referencia

SeleccionarCrear ramificaciones,Etiqueta Git, o bienID de confirmaciónpara especificar la versión del código fuente. Para obtener más información, consulte Ejemplo de versión de origen con AWS CodeBuild.

Profundidad del clon de Git

Elija crear un clon superficial con un historial truncado en el número de confirmaciones especificado. Si desea un clon completo, elija Full (Completo).

Submódulos de Git

Seleccione Use Git submodules (Usar submódulos de Git) si desea incluir submódulos de Git en el repositorio.

Bitbucket

Repositorio

SeleccionarConnect mediante OAuthorConnect con una contraseña de aplicación de Bitbuckety siga las instrucciones para conectarse (o volver a conectarse) a Bitbucket.

Seleccione un repositorio público o un repositorio de su cuenta.

Versión de origen

Introduzca una ramificación, ID de confirmación, etiqueta o referencia y un ID de confirmación. Para obtener más información, consulteEjemplo de versión de origen con AWS CodeBuild

Profundidad del clon de Git

Seleccione Git clone depth (Profundidad del clon de Git) para crear un clon superficial con un historial truncado en el número de confirmaciones especificado. Si desea un clon completo, elija Full (Completo).

Submódulos de Git

Seleccione Use Git submodules (Usar submódulos de Git) si desea incluir submódulos de Git en el repositorio.

Estado de la compilación

SelectInformar de los estados de compilación al proveedor de origen cuando se inician y finalizan las compilacionessi desea que el estado del inicio y finalización de la compilación se registre en el proveedor de origen.

Para poder informar del estado de compilación al proveedor de origen, el usuario asociado al proveedor de origen debe tener acceso de escritura al repositorio. Si el usuario no tiene acceso de escritura, el estado de compilación no se puede actualizar. Para obtener más información, consulte Acceso al proveedor de origen.

ParaContexto de estado, escriba el valor que se va a utilizar para elnameen el estado de confirmación de Bitbucket. Para obtener más información, consulte la compilación en la documentación de la API de Bitbucket.

ParaURL de destino, escriba el valor que se va a utilizar para elurlen el estado de confirmación de Bitbucket. Para obtener más información, consulte la compilación en la documentación de la API de Bitbucket.

El estado de una compilación activada por un webhook se registra siempre en el proveedor de origen. Para que el estado de una compilación iniciada desde la consola o una llamada a la API se informe al proveedor de origen, debe seleccionar esta configuración.

Si las compilaciones de tu proyecto se activan mediante un webhook, debes enviar una nueva confirmación al repositorio para que surta efecto un cambio en esta configuración.

EnEventos de webhooks de origen principal, seleccioneVolver a compilar cada vez que se envíe un cambio de código a este repositoriosi desea que CodeBuild compilar el código fuente cada vez que se envíe un cambio de código al repositorio. Para obtener más información acerca de los webhooks y los grupos de filtros de, consulte.Eventos de webhooks de Bitbucket.

GitHub

Repositorio

SeleccionarConnect mediante OAuthorConnect con un token de acceso personal de GitHuby siga las instrucciones para conectarse (o volver a conectarse) a GitHub y autorizar el acceso aAWS CodeBuild.

Elija un repositorio público o un repositorio de su cuenta.

Versión de origen

Introduzca una ramificación, ID de confirmación, etiqueta o referencia y un ID de confirmación. Para obtener más información, consulteEjemplo de versión de origen con AWS CodeBuild

Profundidad del clon de Git

Seleccione Git clone depth (Profundidad del clon de Git) para crear un clon superficial con un historial truncado en el número de confirmaciones especificado. Si desea un clon completo, elija Full (Completo).

Submódulos de Git

Seleccione Use Git submodules (Usar submódulos de Git) si desea incluir submódulos de Git en el repositorio.

Estado de la compilación

SelectInformar de los estados de compilación al proveedor de origen cuando se inician y finalizan las compilacionessi desea que el estado del inicio y finalización de la compilación se registre en el proveedor de origen.

Para poder informar del estado de compilación al proveedor de origen, el usuario asociado al proveedor de origen debe tener acceso de escritura al repositorio. Si el usuario no tiene acceso de escritura, el estado de compilación no se puede actualizar. Para obtener más información, consulte Acceso al proveedor de origen.

ParaContexto de estado, escriba el valor que se va a utilizar para elcontexten el estado de confirmación de GitHub. Para obtener más información, consulte Crear un estado de confirmación en la guía para desarrolladores de GitHub.

ParaURL de destino, escriba el valor que se va a utilizar para eltarget_urlen el estado de confirmación de GitHub. Para obtener más información, consulte Crear un estado de confirmación en la guía para desarrolladores de GitHub.

El estado de una compilación activada por un webhook se registra siempre en el proveedor de origen. Para que el estado de una compilación iniciada desde la consola o una llamada a la API se informe al proveedor de origen, debe seleccionar esta configuración.

Si las compilaciones de tu proyecto se activan mediante un webhook, debes enviar una nueva confirmación al repositorio para que surta efecto un cambio en esta configuración.

EnEventos de webhooks de origen principal, seleccioneVolver a compilar cada vez que se envíe un cambio de código a este repositoriosi desea que CodeBuild compilar el código fuente cada vez que se envíe un cambio de código al repositorio. Para obtener más información acerca de los webhooks y los grupos de filtros de, consulte.Eventos de webhooks de GitHub.

GitHub Enterprise Server

Token de acceso personal de GitHub Enterprise

ConsulteEjemplo de GitHub Enterprise ServerPara obtener información sobre cómo copiar un token de acceso personal en el portapapeles. Pegue el token en el campo de texto y seleccione Save Token (Guardar token).

nota

Solo tiene que introducir y guardar el token de acceso personal una vez. CodeBuild utiliza este token en todos los proyectos futuros.

Versión de origen

Introduzca una solicitud de extracción, ramificación, ID de confirmación, etiqueta o referencia y un ID de confirmación. Para obtener más información, consulte Ejemplo de versión de origen con AWS CodeBuild.

Profundidad del clon de Git

Seleccione Git clone depth (Profundidad del clon de Git) para crear un clon superficial con un historial truncado en el número de confirmaciones especificado. Si desea un clon completo, elija Full (Completo).

Submódulos de Git

Seleccione Use Git submodules (Usar submódulos de Git) si desea incluir submódulos de Git en el repositorio.

Estado de la compilación

SelectInformar de los estados de compilación al proveedor de origen cuando se inician y finalizan las compilacionessi desea que el estado del inicio y finalización de la compilación se registre en el proveedor de origen.

Para poder informar del estado de compilación al proveedor de origen, el usuario asociado al proveedor de origen debe tener acceso de escritura al repositorio. Si el usuario no tiene acceso de escritura, el estado de compilación no se puede actualizar. Para obtener más información, consulte Acceso al proveedor de origen.

ParaContexto de estado, escriba el valor que se va a utilizar para elcontexten el estado de confirmación de GitHub. Para obtener más información, consulte Crear un estado de confirmación en la guía para desarrolladores de GitHub.

ParaURL de destino, escriba el valor que se va a utilizar para eltarget_urlen el estado de confirmación de GitHub. Para obtener más información, consulte Crear un estado de confirmación en la guía para desarrolladores de GitHub.

El estado de una compilación activada por un webhook se registra siempre en el proveedor de origen. Para que el estado de una compilación iniciada desde la consola o una llamada a la API se informe al proveedor de origen, debe seleccionar esta configuración.

Si las compilaciones de tu proyecto se activan mediante un webhook, debes enviar una nueva confirmación al repositorio para que surta efecto un cambio en esta configuración.

SSL inseguro

Seleccione Enable insecure SSL (Habilitar SSL no seguro) para omitir las advertencias de SSL al conectarse al repositorio del proyecto de GitHub Enterprise.

EnEventos de webhooks de origen principal, seleccioneVolver a compilar cada vez que se envíe un cambio de código a este repositoriosi desea que CodeBuild compilar el código fuente cada vez que se envíe un cambio de código al repositorio. Para obtener más información acerca de los webhooks y los grupos de filtros de, consulte.Eventos de webhooks de GitHub.

Environment

Imagen de entorno

Aplique alguna de las siguientes acciones:

• Para usar una imagen de Docker administrada por AWS CodeBuild, elija Managed image (Imagen administrada) y después elija una opción en Operating system (Sistema operativo), Runtime (Tiempo de ejecución), Image (Imagen) e Image version (Versión de imagen). Realice una selección en Environment type (Tipo de entorno) si está disponible.

• Para usar otra imagen de Docker, elija Custom image (Imagen personalizada). ParaTipo de entorno, eligeARM,Linux,GPU de Linux, o bienWindows. Si elige Other registry (Otro registro), para External registry URL (URL de registro externo), introduzca el nombre y etiqueta de la imagen de Docker en Docker Hub, usando el formato docker repository/docker image name. Si eligeAmazon ECR, useRepositorio de Amazon ECRyImagen de Amazon ECRpara elegir la imagen de Docker en suAWSaccount.

• Para utilizar una imagen privada de Docker, elijaImagen personalizada. ParaTipo de entorno, eligeARM,Linux,GPU de Linux, o bienWindows. En Image registry (Registro de imagen), elija Other registry (Otro registro) y, a continuación, introduzca el ARN de las credenciales para su imagen de Docker privada. Secrets Manager debe crear las credenciales. Para obtener más información, consulte ¿Qué es AWS Secrets Manager? en la Guía del usuario de AWS Secrets Manager.

nota

CodeBuild anula elENTRYPOINTpara imágenes de Docker personalizadas.

Privilegiado

(Opcional) SeleccionePrivilegiadoúnicamente si tiene previsto usar este proyecto de compilación para compilar imágenes de Docker y la imagen del entorno de compilación que eligió no es una de las proporcionadas por CodeBuild con compatibilidad con Docker. De lo contrario, todas las compilaciones asociadas que intenten interactuar con el daemon de Docker producirán un error. También debe iniciar el daemon de Docker para que las compilaciones puedan interactuar con él. Una forma de hacer esto es inicializar el daemon de Docker en la fase install de la especificación de compilación ejecutando los siguientes comandos de compilación. No ejecute estos comandos si eligió una imagen del entorno de compilación proporcionada por CodeBuild compatible con Docker.

nota

De forma predeterminada, los contenedores Docker no permiten el acceso a ningún dispositivo. El modo privilegiado otorga acceso al contenedor Docker de un proyecto de compilación a todos los dispositivos. Para obtener más información, consulte la sección sobre privilegios en tiempo de ejecución y capacidades de Linux en el sitio web de Docker Docs.

- nohup /usr/local/bin/dockerd --host=unix:///var/run/docker.sock --host=tcp://127.0.0.1:2375 --storage-driver=overlay2 &
- timeout 15 sh -c "until docker info; do echo .; sleep 1; done"

Rol de servicio

Aplique alguna de las siguientes acciones:

• Si no tiene un rol de servicio CodeBuild, elija.Nuevo rol de servicio. Escriba un nombre para el nuevo rol en el campo Role Name.

• Si dispone de un rol de servicio CodeBuild, elijaRol de servicio existente. EnARN de rol, seleccione el rol de servicio.

nota

Cuando utiliza la consola de para crear un proyecto de compilación, puede crear un rol de servicio de CodeBuild al mismo tiempo. De forma predeterminada, el rol funciona solamente con ese proyecto de compilación. Si utiliza la consola para asociar este rol de servicio a otro proyecto de compilación, el rol se actualizará para que funcione con el otro proyecto de compilación. Un rol de servicio puede funcionar con hasta diez proyectos de compilación.

Configuración adicional

Timeout (Tiempo de espera)

Especifique un valor entre 5 minutos y 8 horas después de los cuales CodeBuild detendrá la compilación si no se ha completado. Si hours y minutes se dejan en blanco, se usará el valor predeterminado de 60 minutos.

VPC

Si desea que CodeBuild funcione con su VPC:

• ParaVPC:, elija el ID de VPC que utiliza CodeBuild.

• ParaSubredes de la VPC, elija las subredes que incluyen recursos usados por CodeBuild.

• ParaGrupos de seguridad de la VPC, elija los grupos de seguridad que usa CodeBuild para permitir el acceso a los recursos de las VPC.

Para obtener más información, consulte UsarAWS CodeBuildAmazon Virtual Private Cloud.

Computación

Elegir una de las opciones disponibles.

Variables de entorno

Escriba el nombre y el valor de las variables de entorno que se van a usar y seleccione su tipo.

nota

CodeBuild establece la variable de entorno para suAWSRegión automáticamente. Debe definir las siguientes variables de entorno, si no las ha agregado a su archivo buildspec.yml:

• AWS_ACCOUNT_ID

• IMAGE_REPO_NAME

• IMAGE_TAG

Los usuarios de la consola y de AWS CLI pueden ver las variables de entorno. Si no le preocupa que la variable de entorno esté visible, establezca los campos Name y Value, y después establezca Type en Plaintext.

Le recomendamos que almacene una variable de entorno con un valor confidencial, como unAWSID de clave de acceso, unAWSclave de acceso secreta o contraseña como parámetro en el almacén de parámetros Amazon EC2 Systems Manager oAWS Secrets Manager.

Si utiliza Amazon EC2 Systems Manager, enTipo, eligeParámetro. ParaNombre, escriba un identificador para CodeBuild al que haga referencia. ParaValor, escriba el nombre del parámetro tal como está almacenado en el almacén de parámetros Amazon EC2 Systems Manager. Utilizando el parámetro denominado /CodeBuild/dockerLoginPassword como ejemplo, en Type (Tipo), seleccione Parameter (Parámetro). En Name (Nombre) escriba LOGIN_PASSWORD. En Value (Valor), escriba /CodeBuild/dockerLoginPassword.

importante

Si utiliza el almacén de parámetros de Amazon EC2 Systems Manager, le recomendamos que almacene los parámetros con nombres de parámetros que comiencen por/CodeBuild/(por ejemplo,/CodeBuild/dockerLoginPassword). Puede utilizar la consola de CodeBuild para crear un parámetro en Amazon EC2 Systems Manager. Seleccione Create a parameter (Crear parámetro) y siga las instrucciones del cuadro de diálogo. (En ese cuadro de diálogo, paraClave de KMS, puede especificar el ARN de unAWS KMSclave en tu cuenta. Amazon EC2 Systems Manager utiliza esta clave para cifrar el valor del parámetro durante el almacenamiento y descifrarlo durante la recuperación). Si usa la consola de CodeBuild para crear un parámetro, la consola asigna al principio del nombre del parámetro con/CodeBuild/ya que se está almacenando. Para obtener más información, consulteAlmacén de parámetros de Administrador de sistemasyTutorial de la consola del almacén de parámetros de Systems Manageren laGuía del usuario de Amazon EC2 Systems Manager.

Si el proyecto de compilación hace referencia a parámetros almacenados en el almacén de parámetros de Amazon EC2 Systems Manager, el rol de servicio del proyecto de compilación debe permitir lassm:GetParametersaction. Si eligióNuevo rol de servicioanteriormente, CodeBuild incluye esta acción en el rol de servicio predeterminado del proyecto de compilación. Sin embargo, si seleccionó Existing service role (Rol de servicio existente), deberá incluir esta acción en el rol de servicio por separado.

Si el proyecto de compilación hace referencia a parámetros almacenados en el almacén de parámetros de Amazon EC2 Systems Manager con nombres de parámetros que no empiezan por/CodeBuild/y eligióNuevo rol de servicio, debe actualizar ese rol de servicio para permitir el acceso a nombres de parámetros que no empiezan por/CodeBuild/. Esto es así porque el rol de servicio permite el acceso únicamente a los nombres de parámetro que empiezan por /CodeBuild/.

Si eligióNuevo rol de servicio, el rol de servicio incluye permisos para descifrar todos los parámetros en el/CodeBuild/namespace en el almacén de parámetros Amazon EC2 Systems Manager.

Las variables de entorno que defina reemplazan las variables de entorno existentes. Por ejemplo, si la imagen de Docker ya contiene una variable de entorno denominada MY_VAR con un valor de my_value y establece una variable de entorno denominada MY_VAR con un valor de other_value, my_value se reemplaza por other_value. Asimismo, si la imagen de Docker ya contiene una variable de entorno denominada PATH con un valor de /usr/local/sbin:/usr/local/bin y establece una variable de entorno denominada PATH con un valor de $PATH:/usr/share/ant/bin, /usr/local/sbin:/usr/local/bin se reemplaza por el valor literal $PATH:/usr/share/ant/bin.

No establezca variables de entorno con un nombre que empiece por CODEBUILD_. Este prefijo se reserva para uso interno.

Si se define una variable de entorno con el mismo nombre en varios lugares, el valor se determina de la siguiente manera:

• El valor de la llamada a la operación de inicio de la compilación tiene la máxima prioridad.

• El valor de la definición del proyecto de compilación es el siguiente en orden de prioridad.

• El valor en la declaración de especificación de compilación es el que menos prioridad tiene.

Si utilizas Secrets Manager, paraTipo, eligeSecrets Manager. ParaNombre, escriba un identificador para CodeBuild al que haga referencia. En Value (Valor), introduzca un reference-key utilizando el patrón secret-id:json-key:version-stage:version-id. Para obtener información, consulte Secrets Manager reference-key in the buildspec file.

importante

Si utiliza Secrets Manager, le recomendamos que almacene secretos con nombres que comiencen por/CodeBuild/(por ejemplo,/CodeBuild/dockerLoginPassword). Para obtener más información, consulte ¿Qué es AWS Secrets Manager? en la Guía del usuario de AWS Secrets Manager.

Si el proyecto de compilación hace referencia a secretos almacenados en Secrets Manager, el rol de servicio del proyecto de compilación debe permitir lasecretsmanager:GetSecretValueaction. Si eligióNuevo rol de servicioanteriormente, CodeBuild incluye esta acción en el rol de servicio predeterminado del proyecto de compilación. Sin embargo, si seleccionó Existing service role (Rol de servicio existente), deberá incluir esta acción en el rol de servicio por separado.

Si tu proyecto de compilación hace referencia a secretos almacenados en Secrets Manager con nombres secretos que no empiezan por/CodeBuild/y eligióNuevo rol de servicio, debe actualizar el rol de servicio para permitir el acceso a nombres secretos que no empiezan por/CodeBuild/. Esto es así porque el rol de servicio permite el acceso únicamente a nombres secretos que empiezan por/CodeBuild/.

Si eligióNuevo rol de servicio, el rol de servicio incluye permisos para descifrar todos los secretos en el/CodeBuild/espacio de nombres en Secrets Manager.

Buildspec

Especificaciones de compilación

Aplique alguna de las siguientes acciones:

• Si el código fuente incluye un archivo de especificación de compilación, elija Use a buildspec file (Usar un archivo buildspec). De forma predeterminada, CodeBuild busca un archivo llamadobuildspec.ymlEn el directorio raíz del código fuente. Si su archivo buildspec usa un nombre o ubicación diferente, escriba su ruta desde la raíz de origen enNombre de la especificación de compilación(por ejemplo,buildspec-two.ymlorconfiguration/buildspec.yml. Si el archivo buildspec está en un bucket de S3, debe estar en el mismoAWSLa región como proyecto de compilación. Especifique el archivo buildspec utilizando su ARN (por ejemplo,arn:aws:s3:::my-codebuild-sample2/buildspec.yml).

• Si el código fuente no incluye un archivo de especificación de compilación o si desea ejecutar comandos de compilación diferentes de los especificados para la fase build en el archivo buildspec.yml del directorio raíz de código fuente, elija Insert build commands (Insertar comandos de compilación). En Build commands (Comandos de compilación), escriba los comandos que desea ejecutar en la fase build. En caso de que haya varios comandos, separe cada comando con && (por ejemplo, mvn test && mvn package). Para ejecutar comandos en otras fases, o si tiene una larga lista de comandos para elbuildfase, añadir unbuildspec.ymlal directorio raíz del código fuente, agregue los comandos al archivo y, a continuación, elijaUse el buildspec.yml en el directorio raíz del código fuente.

Para obtener más información, consulte la Referencia de la especificación de compilación.

Configuración Batch

Puede ejecutar un grupo de compilaciones como una sola operación. Para obtener más información, consulte Compilaciones Batch enAWS CodeBuild.

Definición de configuración de lotes

Seleccione esta opción para permitir compilaciones por lotes en este proyecto.

Rol de servicio de Batch

Proporciona el rol de servicio para las compilaciones por lotes.

Elija una de las siguientes opciones:

• Si no tiene un rol de servicio por lotes, elijaNuevo rol de servicio. EnRol de servicio, especifique un nombre para el nuevo rol.

• Si dispone de un rol de servicio por lotes, elijaRol de servicio existente. EnRol de servicio, seleccione el rol de servicio.

Las compilaciones Batch introducen un nuevo rol de seguridad en la configuración de lotes. Se requiere este nuevo rol, ya que CodeBuild debe poder llamar alStartBuild,StopBuild, yRetryBuildacciones en su nombre para ejecutar compilaciones como parte de un lote. Los clientes deben utilizar un nuevo rol, y no el mismo rol que usan en su compilación, por dos razones:

• Dar el rol de compilaciónStartBuild,StopBuild, yRetryBuildlos permisos permitirían que una sola compilación inicie más compilaciones a través de la especificación de compilación.

• Las compilaciones por lotes de CodeBuild proporcionan restricciones que restringen el número de compilaciones y tipos de cómputo que se pueden utilizar para las compilaciones del lote. Si el rol de compilación tiene estos permisos, es posible que las compilaciones mismas puedan eludir estas restricciones.

Tipos de cómputo permitidos para lotes

Seleccione los tipos de cómputo permitidos para el lote. Selecciona todo lo que corresponda.

Número máximo de compilaciones permitidas por lotes

Escriba el número máximo de compilaciones permitidas en el lote. Si un lote supera este límite, el lote fallará.

Tiempo de espera del lote

Introduzca la cantidad máxima de tiempo que dura la compilación por lotes.

CombineArtifactos

SelectCombina todos los artefactos del lote en una única ubicaciónpara que todos los artefactos del lote se combinen en una única ubicación.

Modo de informe por lotes

Seleccione el modo de informe de estado de compilación deseado para las compilaciones por lotes.

nota

Este campo solo está disponible cuando el origen del proyecto es Bitbucket, GitHub o GitHub Enterprise, yInformar de los estados de compilación al proveedor de origen cuando se inician y finalizan las compilacionesse selecciona enFuente.

Builds agregadas

Seleccione esta opción para combinar los estados de todas las compilaciones del lote en un único informe de estado.

Builds individuales

Seleccione esta opción para que los estados de compilación de todas las compilaciones del lote se informen por separado.

Artifacts

Type

Aplique alguna de las siguientes acciones:

• Si no desea crear ningún artefacto de salida de la compilación, elija No artifacts. por ejemplo, si solo va a ejecutar pruebas de compilación o si desea insertar una imagen de Docker en un repositorio de Amazon ECR.

• Para almacenar la salida de la compilación en un bucket de S3, elijaAmazon S3y, a continuación, haga lo siguiente:

  • Si desea utilizar su nombre de proyecto para el archivo ZIP o carpeta de salida de la compilación, deje en blanco Name (Nombre). De lo contrario, escriba el nombre. (Si desea producir un archivo ZIP y desea que el archivo ZIP tenga una extensión de archivo, asegúrese de incluirlo detrás del nombre del archivo ZIP).

  • Seleccione Enable semantic versioning (Habilitar control semántico de versiones) si desea que el nombre especificado en el archivo buildspec invalide cualquier nombre especificado en la consola. El nombre en un archivo buildspec se calcula en tiempo de compilación y utiliza el lenguaje de comandos Shell. Por ejemplo, puede adjuntar una fecha y una hora al nombre del artefacto para que siempre sea único. Los nombres de artefactos únicos impiden que los artefactos se sobrescriban. Para obtener más información, consulte Sintaxis de buildspec.

  • En Bucket name (Nombre del bucket), seleccione el nombre del bucket de salida.

  • Si eligió Insert build commands (Insertar comandos de compilación) anteriormente en este procedimiento, en Output files (Archivos de salida), escriba las ubicaciones de los archivos de la compilación que desea incluir en el archivo ZIP o carpeta de salida de la compilación. Si hay varias ubicaciones, separe cada una de las ubicaciones con una coma (por ejemplo, appspec.yml, target/my-app.jar). Para obtener más información, consulte la descripción de files en Sintaxis de buildspec.

  • Si no desea que los artefactos de compilación se cifren, seleccione Remove artifacts encryption (Quitar cifrado de artefactos),

Para cada conjunto de artefactos secundarios que desee:

1. Para Source identifier (Identificador de artefacto), escriba un valor que tenga como máximo 128 caracteres, únicamente de tipo alfanumérico y guiones bajos.

2. Elija Add artifact (Añadir artefacto).

3. Siga los pasos anteriores para configurar los artefactos secundarios.

4. Elija Save artifact (Guardar artefacto).

Configuración adicional

Clave de cifrado

(opcional) Realice una de las operaciones siguientes:

• Para utilizar el Clave administrada por AWS para Amazon S3 de su cuenta para cifrar los artefactos de salida de la compilación, dejeClave de cifradoen blanco. Esta es la opción predeterminada.

• Para utilizar una clave administrada por el cliente para cifrar los artefactos de salida de la compilación, enClave de cifrado, especifique el ARN de la clave KMS. Utilice el formato arn:aws:kms:region-ID:account-ID:key/key-ID.

Tipo de caché

En Cache type (Tipo de caché), seleccione una de las opciones siguientes:

• Si no desea usar una memoria caché, elija No cache.

• Si desea utilizar una caché de Amazon S3, elijaAmazon S3y, a continuación, haga lo siguiente:

  • En Bucket, elija el nombre del bucket de S3 donde se almacena la caché.

  • (Opcional) ParaPrefijo de ruta de caché, especifique un prefijo de ruta de Amazon S3. El valor Cache path prefix (Prefijo de ruta de caché) es similar a un nombre de directorio. Le permite almacenar la caché en el mismo directorio en un bucket.

    importante

    No añada una barra (/) al final del prefijo de ruta.

• Si desea utilizar una caché local, seleccione Local y elija uno o varios modos de caché local.

  nota

  El modo Docker layer cache (Caché de capas de Docker) solo está disponible para Linux. Si lo selecciona, el proyecto deberá ejecutarse en modo con privilegios. LaARM_CONTAINERyLINUX_GPU_CONTAINERtipos de entorno yBUILD_GENERAL1_2XLARGEel tipo de cómputo no admite el uso de una caché local.

El uso de memoria caché ahorra mucho tiempo de compilación, ya que algunas partes reutilizables del entorno de compilación se almacenan en ella y se usan en las distintas compilaciones. Para obtener información acerca de cómo especificar una caché en el archivo de especificación de compilación, consulte Sintaxis de buildspec. Para obtener más información acerca del almacenamiento en caché, consulte Almacenamiento en caché de compilaciones de AWS CodeBuild.

Logs

Elija los registros que desea crear. Puede crear Amazon CloudWatch Logs, registros Amazon S3 o ambos.

CloudWatch

Si desea registros de Amazon CloudWatch Logs:

CloudWatch Logs

SelectCloudWatch Logs.

Group name

Escriba el nombre del grupo de registros de Amazon CloudWatch Logs.

Nombre de transmisión

Introduzca el nombre del flujo de registro de Amazon CloudWatch Logs.

S3

Si quieres registros de Amazon S3:

Registros de S3

Seleccione registros de S3.

Bucket

Seleccione el nombre del bucket de S3 para los registros.

Prefijo de la ruta

Escriba el prefijo de los registros.

Deshabilitar el cifrado de registros de S3

Seleccione si no quiere que los registros de S3 se cifren.