As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Solução de problemas de conexão SSH do AWS CodeBuild sandbox
Use as informações deste tópico para ajudá-lo a identificar, diagnosticar e resolver problemas de conexão SSH do CodeBuild sandbox.
**Topics**
+ [`StartSandboxConnection``InvalidInputException`erro quando o SSH entra no ambiente CodeBuild sandbox](#sandbox-troubleshooting.invalid-input)
+ [Erro: “Não é possível localizar as credenciais” quando o SSH entra no ambiente sandbox CodeBuild](#sandbox-troubleshooting.credentials)
+ [`StartSandboxConnection``AccessDeniedException`erro quando o SSH entra no ambiente CodeBuild sandbox](#sandbox-troubleshooting.access-denied)
+ [Erro: “ssh: não foi possível resolver o nome do host” quando o SSH está no ambiente sandbox CodeBuild](#sandbox-troubleshooting.hostname)
## `StartSandboxConnection``InvalidInputException`erro quando o SSH entra no ambiente CodeBuild sandbox
**Problema:** ao tentar se conectar a um ambiente CodeBuild sandbox usando o comando`ssh codebuild-sandbox-ssh=`, você pode encontrar um `InvalidInputException` erro como:
```
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.
```
**Possível causa:**
+ Agente do Amazon EC2 Systems Manager ausente: a imagem de compilação não tem o SSM Agent devidamente instalado ou configurado.
+ Permissões insuficientes: a função de serviço do CodeBuild projeto não tem as permissões SSM necessárias.
**Solução recomendada:** se você estiver usando uma imagem personalizada para a compilação, faça o seguinte.
1. Instalar o SSM Agent do . Consulte mais informações em [Instalar e desinstalar manualmente o SSM Agent em instâncias do Amazon EC2 para Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) no **. A versão do SSM Agent deve ser `3.0.1295.0` ou posterior.
1. Copie o arquivo, [ 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) para o diretório na sua imagem. `/etc/amazon/ssm/` Isso habilita o **Modo de contêiner** no SSM Agent.
1. Certifique-se de que a função de serviço do seu CodeBuild projeto tenha as seguintes permissões e reinicie o ambiente 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"
]
}
```
## Erro: “Não é possível localizar as credenciais” quando o SSH entra no ambiente sandbox CodeBuild
**Problema:** ao tentar se conectar a um ambiente CodeBuild sandbox usando o comando`ssh codebuild-sandbox-ssh=`, você pode encontrar o seguinte erro de credenciais:
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Possível causa:** AWS as credenciais não foram configuradas corretamente em seu ambiente local.
**Solução recomendada:** configure suas AWS CLI credenciais seguindo a documentação oficial: [Definindo as configurações do Guia do usuário da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) *interface de linha de AWS comando para a versão 2*.
## `StartSandboxConnection``AccessDeniedException`erro quando o SSH entra no ambiente CodeBuild sandbox
**Problema:** ao tentar se conectar a um ambiente de CodeBuild sandbox usando o comando`ssh codebuild-sandbox-ssh=`, você pode encontrar o seguinte erro de permissão:
```
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 possível:** suas AWS credenciais não têm as CodeBuild permissões necessárias para realizar essa operação.
**Solução recomendada:** certifique-se de que o usuário ou a função do IAM associada às suas AWS CLI credenciais tenha as seguintes permissões:
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Erro: “ssh: não foi possível resolver o nome do host” quando o SSH está no ambiente sandbox CodeBuild
**Problema:** ao tentar se conectar a um ambiente de CodeBuild sandbox usando o comando`ssh codebuild-sandbox-ssh=`, você encontra o seguinte erro de resolução de nome de host:
```
ssh: Could not resolve hostname
```
**Possível causa:** Esse erro geralmente ocorre quando o script de conexão de CodeBuild sandbox necessário não foi executado corretamente em seu ambiente local.
**A solução recomendada:**
1. Baixe o script de conexão do CodeBuild sandbox.
1. Execute o script no terminal para estabelecer a configuração SSH necessária.
1. Tente estabelecer novamente a conexão SSH com o ambiente de sandbox.