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.
# Solución de problemas AWS CodeBuild de conexión SSH en entornos aislados
Usa la información de este tema para ayudarte a identificar, diagnosticar y solucionar los problemas de conexión SSH CodeBuild en entornos aislados.
**Topics**
+ [`StartSandboxConnection``InvalidInputException`error al usar SSH en un entorno sandbox CodeBuild](#sandbox-troubleshooting.invalid-input)
+ [Error: «No se encuentran las credenciales» cuando se utiliza SSH en CodeBuild un entorno sandbox](#sandbox-troubleshooting.credentials)
+ [`StartSandboxConnection``AccessDeniedException`error al usar SSH en un CodeBuild entorno sandbox](#sandbox-troubleshooting.access-denied)
+ [Error: «ssh: no se ha podido resolver el nombre de host» cuando se utiliza SSH en un entorno aislado CodeBuild](#sandbox-troubleshooting.hostname)
## `StartSandboxConnection``InvalidInputException`error al usar SSH en un entorno sandbox CodeBuild
**Problema:** al intentar conectarse a un entorno CodeBuild sandbox mediante el comando`ssh codebuild-sandbox-ssh=`, es posible que se produzca un `InvalidInputException` error como el siguiente:
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts:::assumed-role//AWSCodeBuild-
is not authorized to perform: ssm:StartSession on resource.
```
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for
sandbox : codebuild: is not connected.
```
**Causa posible:**
+ Falta el agente de Systems Manager de Amazon EC2: la imagen de compilación no tiene el agente de SSM instalado o configurado correctamente.
+ Permisos insuficientes: el rol de servicio CodeBuild del proyecto carece de los permisos de SSM necesarios.
**Solución recomendada:** si utiliza 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 y desinstalación manual de SSM Agent en instancias de Amazon EC2 para Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) en **. 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/7.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.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.
1. Asegúrese de que el rol de servicio de su CodeBuild proyecto tenga los siguientes permisos y, a continuación, reinicie el entorno sandbox:
```
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:StartSession"
],
"Resource": [
"arn:aws:codebuild:region:account-id:build/*",
"arn:aws:ssm:region::document/AWS-StartSSHSession"
]
}
```
## Error: «No se encuentran las credenciales» cuando se utiliza SSH en CodeBuild un entorno sandbox
**Problema:** al intentar conectarse a un entorno CodeBuild aislado mediante el comando`ssh codebuild-sandbox-ssh=`, es posible que aparezca el siguiente error de credenciales:
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Causa posible:** AWS las credenciales no se configuraron correctamente en su entorno local.
**Solución recomendada:** configure sus AWS CLI credenciales siguiendo la documentación oficial: [Configuración de los ajustes de la Guía del AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) *usuario de la interfaz de línea de AWS comandos para la versión 2*.
## `StartSandboxConnection``AccessDeniedException`error al usar SSH en un CodeBuild entorno sandbox
**Problema:** al intentar conectarse a un entorno CodeBuild sandbox mediante el comando`ssh codebuild-sandbox-ssh=`, puede aparecer el siguiente error de permiso:
```
An error occurred (AccessDeniedException) when calling the StartSandboxConnection
operation:
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource:
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action
```
**Causa posible:** sus AWS credenciales carecen de los CodeBuild permisos necesarios para realizar esta operación.
**Solución recomendada:** asegúrese de que el usuario o rol de IAM asociado a sus AWS CLI credenciales tenga los siguientes permisos:
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Error: «ssh: no se ha podido resolver el nombre de host» cuando se utiliza SSH en un entorno aislado CodeBuild
**Problema:** al intentar conectarse a un entorno CodeBuild sandbox mediante el comando`ssh codebuild-sandbox-ssh=`, aparece el siguiente error de resolución del nombre de host:
```
ssh: Could not resolve hostname
```
**Causa posible:** este error suele producirse cuando el script de conexión de CodeBuild espacio aislado requerido no se ha ejecutado correctamente en el entorno local.
**Solución recomendada:**
1. Descargue el script de conexión CodeBuild de sandbox.
1. Ejecute el script en el terminal para establecer la configuración de SSH necesaria.
1. Vuelva a intentar la conexión de SSH con el entorno de pruebas.