Cambiar la configuración de un proyecto de compilación (consola) - AWS CodeBuild

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cambiar la configuración de un proyecto de compilación (consola)

Para cambiar la configuración de un proyecto de compilación, realice el siguiente procedimiento:

  1. Abra el iconoAWS CodeBuildConsola de enhttps://console.aws.amazon.com/codesuite/codebuild/home.

  2. En el panel de navegación, elija Build projects.

  3. Realice alguna de las siguientes acciones:

    • Elija el enlace del proyecto de compilación que desea cambiar y, a continuación, seleccione Build details (Detalles de compilación).

    • Seleccione el botón de opción situado junto al proyecto de compilación que desea cambiar, elija View details (Ver detalles) y, a continuación, elija Build details (Detalles de compilación).

Puede modificar las siguientes secciones:

Configuración del proyecto

En el navegadorConfiguración del proyectosección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

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

Seleccione Enable build badge (Habilitar insignia de compilación) para 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 origen es Amazon S3.

Habilitar límite de compilación simultánea

Si desea limitar el número de compilaciones simultáneas de este proyecto, realice los pasos siguientes:

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

  2. EnLímite de compilaciones simultáneas, introduzca el número máximo de compilaciones 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.

Activar el acceso a compilación

Para que los resultados de compilación de su proyecto estén disponibles para el público, incluidos los usuarios sin acceso a unAWScuenta, seleccioneActivar el acceso a compilacióny confirme que desea que los resultados de la compilación sean públicos. Las siguientes propiedades se utilizan para proyectos de compilación pública:

Función de servicio de compilación pública

SelectNuevo rol de serviciosi quieres tenerCodeBuildcree un nuevo rol de servicio para usted, oRol de servicio existentesi desea utilizar un rol de servicio existente.

El rol de servicio de compilación pública permiteCodeBuildpara leer elCloudWatchRegistra y descarga los artefactos de Amazon S3 para las compilaciones del proyecto. Esto es necesario para que los registros de compilación y artefactos del proyecto estén disponibles para el público.

Rol de servicio

Introduzca el nombre del nuevo rol de servicio o de un rol de servicio existente.

Para que los resultados de compilación de su proyecto sean privados, clarosActivar el acceso a compilación.

Para obtener más información, consulte Proyectos de compilación pública enAWS CodeBuild.

aviso

Debe tenerse en cuenta lo siguiente al hacer públicos los resultados de compilación de su proyecto:

  • Todos los resultados de compilación, registros y artefactos de un proyecto, incluidas las compilaciones que se ejecutaron cuando el proyecto era privado, están disponibles para el público.

  • Todos los registros y artefactos de compilación están disponibles para el público. Es posible que se hayan emitido variables de entorno, código fuente y otra información confidencial en los registros y artefactos de compilación. Debe tener cuidado con la información que se genera en los registros de compilación. Algunas prácticas recomendadas son:

    • No almacene valores confidenciales, especialmenteAWSidentificadores de clave de acceso y claves de acceso secretas de en variables de entorno. Le recomendamos que utilice un almacén de parámetros Amazon EC2 Systems Manager oAWS Secrets Managerpara almacenar valores sensibles.

    • SeguirPrácticas recomendadas para utilizar webhookspara limitar qué entidades pueden desencadenar una compilación y no almacenar la especificación de compilación en el propio proyecto, para garantizar que sus webhooks sean lo más seguros posible.

  • Un usuario malintencionado puede utilizar compilaciones públicas para distribuir artefactos maliciosos. Recomendamos que los administradores del proyecto revisen todas las solicitudes de extracción para verificar que la solicitud de extracción sea un cambio legítimo. También te recomendamos que valides cualquier artefacto con sus sumas de comprobación para asegurarte de que se están descargando los artefactos correctos.

Información adicional

ParaEtiquetas, introduzca el nombre y el valor de las etiquetas que desea admitirAWSservicios para usar. Use Add row para añadir una etiqueta. Puede añadir hasta 50 etiquetas.

Fuente

En el navegadorFuentesección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

Proveedor de origen

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

nota

CodeBuildno es compatible con 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

Elija el repositorio que desee utilizar.

Tipo de referencia

ElegirRama,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 si desea 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

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

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 registren 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 utilizará para el archivonameen 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 utilizará para el archivourlen 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 quieresCodeBuildpara compilar el código fuente cada vez que se envíe un cambio de código a este repositorio. Para obtener más información acerca de los grupos de filtros y enlaces de, consulte.Eventos de webhooks de Bitbucket.

GitHub
Repositorio

ElegirConnect mediante OAuthoConnect con unGitHubtoken de acceso personaly siga las instrucciones para conectarse (o volver a conectarse) aGitHuby 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 registren 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 utilizará para el archivocontexten elGitHubEstado de confirmación. Para obtener más información, consulteCreación de un estado de confirmaciónen laGitHubguía para desarrolladores.

ParaURL de destino, escriba el valor que se utilizará para el archivotarget_urlen elGitHubEstado de confirmación. Para obtener más información, consulteCreación de un estado de confirmaciónen laGitHubguía para desarrolladores.

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 quieresCodeBuildpara compilar el código fuente cada vez que se envíe un cambio de código a este repositorio. Para obtener más información acerca de los grupos de filtros y enlaces de, consulte.eventos de webhooks de GitHub.

GitHub Enterprise Server
GitHubToken de acceso personal empresarial

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. CodeBuildutiliza 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 registren 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 utilizará para el archivocontexten elGitHubEstado de confirmación. Para obtener más información, consulteCreación de un estado de confirmaciónen laGitHubguía para desarrolladores.

ParaURL de destino, escriba el valor que se utilizará para el archivotarget_urlparámetro enGitHubEstado de confirmación. Para obtener más información, consulteCreación de un estado de confirmaciónen laGitHubguía para desarrolladores.

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

SelectHabilitar SSL insegurapara pasar por alto las advertencias de SSL al conectarse a suGitHubRepositorio de proyectos empresariales.

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

Entorno

En el navegadorEntornosección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

Imagen de entorno

Para cambiar la imagen de compilación, elijaImagen de anulacióny realice una de las siguientes operaciones:

  • 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, eligeBRAZO,Linux,GPU 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, utilizarRepositorio de Amazon ECRyImagen de Amazon ECRpara elegir la imagen de Docker en suAWSaccount.

  • Para usar una imagen privada de Docker, elija.Imagen personalizada. ParaTipo de entorno, eligeBRAZO,Linux,GPU 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

CodeBuildanula elENTRYPOINTpara imágenes de Docker personalizadas.

Privilegiado

SelectPrivilegiadoú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 porCodeBuildcon soporte 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

Realice alguna de las siguientes acciones:

  • Si no dispone deCodeBuildrol de servicio, elijaNuevo rol de servicio. Escriba un nombre para el nuevo rol en el campo Role Name.

  • Si tienes unCodeBuildrol de servicio, elijaRol de servicio existente. EnARN de rol, seleccione el rol de servicio.

nota

Cuando utiliza la consola para crear un proyecto de compilación, puede crear unCodeBuildservicio 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 del cualCodeBuilddetiene 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:

  • En VPC, elija el ID de VPC que usa CodeBuild.

  • ParaSubredes de la VPC, elija las subredes que incluyen recursos queCodeBuildUsos.

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

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

Computación

Elija una de las opciones disponibles.

Variables de entorno

Introduzca el nombre y el valor y, a continuación, elija el tipo de cada variable de entorno que se va a usar en las compilaciones.

nota

CodeBuildestablece 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,AWSclave de acceso secreta de o contraseña como parámetro en el almacén de parámetros Amazon EC2 Systems Manager oAWS Secrets Manager.

Si utiliza el almacén de parámetros Amazon EC2 Systems Manager, paraTipo, eligeParámetro. En Name (Nombre), escriba un identificador al que haga referencia CodeBuild. 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), ingrese LOGIN_PASSWORD. En Value, ingrese /CodeBuild/dockerLoginPassword.

importante

Si utiliza el almacén de parámetros Amazon EC2 Systems Manager, le recomendamos que almacene los parámetros con nombres de parámetro que comiencen por/CodeBuild/(por ejemplo,/CodeBuild/dockerLoginPassword). Puede utilizar elCodeBuildconsola 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 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 /CodeBuild/ al principio del nombre del parámetro cuando este se almacena. 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 Amazon EC2 Systems Manager, el rol de servicio del proyecto de compilación debe permitir lassm:GetParametersaction. Si anteriormente seleccionó New service role (Nuevo rol de servicio), CodeBuild incluirá automáticamente 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 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 eligeNuevo rol de servicio, el rol de servicio incluye permisos para descifrar todos los parámetros en el/CodeBuild/espacio de nombres 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 de .

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 usas Secrets Manager, paraTipo, eligeSecrets Manager. En Name (Nombre), escriba un identificador al que haga referencia CodeBuild. 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 empiecen 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 anteriormente seleccionó New service role (Nuevo rol de servicio), CodeBuild incluirá automáticamente 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 eligeNuevo rol de servicio, el rol de servicio incluye permisos para descifrar todos los secretos en el/CodeBuild/espacio de nombres en Secrets Manager.

BuildSpec

En el navegadorBuildSpecsección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

Especificaciones de compilación

Realice 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 denominado buildspec.yml en el directorio raíz del código fuente. Si el archivo buildspec utiliza un nombre o ubicación diferente, introduzca su ruta desde la raíz de origen enNombre de especificación de compilación(por ejemplo,buildspec-two.ymloconfiguration/buildspec.yml. Si el archivo buildspec está en un bucket de S3, debe estar en el mismoAWSRegió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.ymlarchivo al directorio raíz del código fuente, agregue los comandos al archivo y, a continuación, elijaUse el archivo 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

En el navegadorConfiguración Batchsección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración. Para obtener más información, consulte Compilación Batch enAWS CodeBuild.

Puede modificar las propiedades siguientes:

Función de servicio por lotes

Proporciona el rol de servicio para las compilaciones por lotes.

Elija una de las siguientes opciones:

  • Si no dispone de un rol de servicio por lotes, elija.Nuevo rol de servicio. EnRol de servicio, especifique un nombre para el nuevo rol.

  • Si dispone de un rol de servicio por lotes, elija.Rol 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. Este nuevo rol es obligatorioCodeBuilddebe 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.

  • CodeBuildlas compilaciones por lotes 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ómputos permitidos para lote

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 de tiempo máxima que dura la compilación por lotes.

Combinar artefactos

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 bienGitHubEnterprise yInformar de los estados de compilación al proveedor de origen cuando se inician y finalizan las compilacionesse selecciona enFuente.

Compilaciones agregadas

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

Compilaciones individuales

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

Artifacts

En el navegadorArtifactssección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

Type

Realice 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, elija.Amazon 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

Realice alguna de las siguientes acciones:

  • Para utilizar elClave administrada por AWSAmazon S3 en 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, escriba el ARN de la clave administrada por el cliente. 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, elija.Amazon 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é, escriba 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.

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.

Registros

En el navegadorRegistrossección, elijaEditar. Cuando se hayan completado los cambios, elijaConfiguración de actualizacionespara guardar la nueva configuración.

Puede modificar las propiedades siguientes:

Elija los registros que desea crear. Puedes crear AmazonCloudWatchRegistros, registros de Amazon S3 o ambos.

CloudWatch

Si quieres AmazonCloudWatchRegistros de registros:

CloudWatchRegistros de

Seleccione registros de CloudWatch.

Group name

Ingrese el nombre de su AmazonCloudWatchGrupo de registros de registros.

Nombre de transmisión

Ingrese a AmazonCloudWatchRegistra el nombre del flujo de registros.

S3

Si quieres registros de Amazon S3:

Registros de S3

Seleccione registros de S3.

Bucket

Elija el nombre del bucket de S3 para los registros.

Prefijo de ruta

Ingrese el prefijo de los registros.

Deshabilitar el cifrado de registros de S3

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