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.
# Depuración de compilaciones con Administrador de sesiones
En AWS CodeBuild, puedes pausar una compilación en ejecución y, a continuación, usar el Administrador de AWS Systems Manager sesiones para conectarte al contenedor de compilación y ver su estado.
**nota**
Esta característica no está disponible en entornos Windows.
**Topics**
+ [Requisitos previos](#ssm.prerequisites)
+ [Pausar la compilación](#ssm-pause-build)
+ [Iniciar la compilación](#ssm-start-build)
+ [Conectarse al contenedor de compilación](#ssm-connect)
+ [Reanudar la compilación](#ssm-resume-build)
## Requisitos previos
Para permitir el uso de Session Manager con la sesión de compilación, es necesario habilitar la conexión de sesión para la compilación. Hay dos prerrequisitos:
+ CodeBuild Las imágenes seleccionadas estándar de Linux ya tienen el agente SSM instalado y el agente ContainerMode SSM activado.
Si va a utilizar una imagen personalizada para la compilación, haga lo siguiente:
1. Instalar el SSM Agent de . Para obtener más información, consulte [Instalación manual de SSM Agent en instancias EC2 de Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) en la Guía del usuario de AWS Systems Manager . La versión de SSM Agent debe ser 3.0.1295.0 o posterior.
1. Copie el archivo [https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/5.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/5.0/amazon-ssm-agent.json) en el directorio de la imagen. `/etc/amazon/ssm/` De este modo se habilita Modo de contenedor en SSM Agent.
**nota**
Las imágenes personalizadas requieren el agente SSM más actualizado para que esta función funcione según lo esperado.
+ El rol de CodeBuild servicio debe tener la siguiente política de SSM:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
}
]
}
```
------
Puede hacer que la CodeBuild consola asocie automáticamente esta política a su función de servicio al iniciar la compilación. Como alternativa, puede adjuntar la política al rol de servicio manualmente.
+ Si tiene habilitada la **auditoría y el registro de la actividad de la sesión** en las preferencias de Systems Manager, la función de CodeBuild servicio también debe tener permisos adicionales. Los permisos varían según el lugar donde se almacenen los registros.
CloudWatch Registros
Si utiliza CloudWatch los registros para almacenar los registros, añada el siguiente permiso a la función CodeBuild de servicio:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "logs:DescribeLogGroups",
"Resource": "arn:aws:logs:us-east-1:111122223333:log-group:*:*"
},
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Resource": "arn:aws:logs:us-east-1:111122223333:log-group:MyLogGroup:*"
}
]
}
```
Amazon S3
Si utiliza Amazon S3 para almacenar sus registros, añada el siguiente permiso al rol CodeBuild de servicio:
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetEncryptionConfiguration",
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
Para obtener más información, consulte [Actividad de auditoría y registro de sesión](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-logging-auditing.html) en la *Guía del usuario de AWS Systems Manager *.
## Pausar la compilación
Para pausar la compilación, inserte el comando **codebuild-breakpoint** en cualquiera de las fases de compilación del archivo de especificación de compilación. La compilación se pausará en este punto, lo que permite conectar con el contenedor de compilación y ver el contenedor en su estado actual.
Por ejemplo, añada lo siguiente a las fases de compilación del archivo de especificación de compilación.
```
phases:
pre_build:
commands:
- echo Entered the pre_build phase...
- echo "Hello World" > /tmp/hello-world
- codebuild-breakpoint
```
Este código crea el archivo `/tmp/hello-world` y, a continuación, detiene la compilación en este punto.
## Iniciar la compilación
Para permitir el uso de Session Manager con la sesión de compilación, es necesario habilitar las conexiones de sesión para la compilación. Para hacerlo, al iniciar la compilación, siga estos pasos:
1. Abra la AWS CodeBuild consola en [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. En el panel de navegación, elija **Proyectos de compilación**. Elija el proyecto de compilación y, a continuación, elija **Iniciar compilación con anulaciones**.
1. Seleccione **Advanced build overrides (Sustitución avanzada de compilaciones)**.
1. En la sección **Entorno**, elija la opción **Habilitar la conexión de sesión**. Si no se selecciona esta opción, se ignoran todos los comandos de **codebuild-breakpoint** y **codebuild-resume**.
1. Realice los demás cambios que desee y elija **Iniciar compilación**.
1. Monitoriza el estado de la compilación en la consola. Cuando la sesión esté disponible, el enlace al **AWS Session Manager** aparecerá en la sección **Estado de compilación**.
## Conectarse al contenedor de compilación
Es posible conectarse al contenedor de compilación de una de las dos formas siguientes:
CodeBuild consola
En un navegador web, abra el enlace de **AWS Session Manager** para conectarse al contenedor de compilación. Se abre una sesión de terminal que le permite explorar y controlar el contenedor de compilación.
AWS CLI
Su máquina local debe tener instalado el complemento de Session Manager para realizar este procedimiento. Para obtener más información, consulte [Instalación del complemento Session Manager para la AWS CLI](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) en la Guía del AWS Systems Manager usuario.
1. Llame a la API de **batch-get-builds** con el ID de compilación para obtener información sobre la compilación, incluido el identificador de destino de la sesión. El nombre de la propiedad del identificador de destino de la sesión varía según el tipo de salida del comando `aws`. Por eso se añade `--output json` al comando.
```
aws codebuild batch-get-builds --ids --region --output json
```
1. Copie el valor de la propiedad `sessionTarget`. El nombre de la propiedad `sessionTarget` puede variar en función del tipo de salida del comando `aws`. Por eso se añade `--output json` al comando en el paso anterior.
1. Utilice el comando siguiente para conectarse al contenedor de compilación.
```
aws ssm start-session --target --region
```
Para este ejemplo, comprueba que el archivo `/tmp/hello-world` exista y contiene el texto `Hello World`.
## Reanudar la compilación
Después de examinar el contenedor de compilación, ejecute el comando **codebuild-resume** desde el intérprete de comandos del contenedor.
```
$ codebuild-resume
```