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á.
# Tutorial: conectar-se a um sandbox usando SSH
Este tutorial mostra como se conectar a uma CodeBuild sandbox usando um cliente SSH.
Para concluir este tutorial, você deve primeiramente:
+ Certifique-se de ter um AWS CodeBuild projeto existente.
+ Configure as permissões apropriadas do IAM configuradas para a função CodeBuild do seu projeto.
+ Instale e configure AWS CLI em sua máquina local.
## Etapa 1: iniciar um sandbox
**Para iniciar uma CodeBuild sandbox no console**
1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).
1. No painel de navegação, selecione **Projetos de compilação**. Escolha o projeto de compilação e selecione **Depurar compilação**.
![\[A página de detalhes do projeto de compilação no console.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/project-debug-build.png)
1. Na guia **Cliente SSH**, escolha **Iniciar sandbox**.
![\[A guia “Cliente SSH” no console com o botão “Iniciar sandbox”.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/ssh-client-sandbox.png)
1. O processo de inicialização do sandbox pode levar algum tempo. Você pode se conectar ao sandbox quando o status mudar para `RUN_SANDDBOX`.
![\[A conexão do sandbox via SSH depois que o status muda para “RUN_SANDBOX”.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/run-sandbox.png)
## Etapa 2: modificar a configuração de SSH local
Se estiver se conectando ao sandbox pela primeira vez, você precisará realizar um processo de configuração único usando as seguintes etapas:
**Como modificar a configuração SSH local no console**
1. Encontre os comandos de configuração do sistema operacional.
1. Abra o terminal local e, depois, copie e execute os comandos fornecidos para baixar e executar o script a fim de definir a configuração de SSH local. Por exemplo, se o sistema operacional for o macOS, use o seguinte comando:
![\[Os comandos do macOS para conexão SSH com a CodeBuild sandbox no console.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/modify-ssh-macOS.png)
1. O script de configuração adiciona as configurações necessárias para se conectar aos sandboxes. Você recebe uma solicitação para aceitar essas alterações.
1. Após a configuração bem-sucedida, uma nova entrada de configuração SSH para CodeBuild sandbox será criada.
![\[Uma conexão de sandbox via SSH bem-sucedida.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/ssh-terminal-success.png)
## Etapa 3: conectar-se ao sandbox
**Como modificar a configuração SSH local no console**
1. Configure a AWS CLI autenticação e garanta que seu AWS CLI usuário tenha a `codebuild:StartSandboxConnection` permissão. Consulte mais informações em [Autenticação usando credenciais de usuário do IAM para a AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-authentication-user.html) no *Guia do usuário da AWS Command Line Interface versão 1*.
1. Conecte-se ao sandbox com o seguinte comando:
```
ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1::sandbox/
```
**nota**
Para solucionar falhas de conexão, use o sinalizador `-v` para habilitar a saída detalhada. Por exemplo, .`ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1::sandbox/`
Consulte mais orientações sobre solução de problemas em [Solução de problemas de conexão SSH do AWS CodeBuild sandbox](sandbox-troubleshooting.md).
## Etapa 4: analise seus resultados
Depois da conexão, é possível depurar falhas de compilação, testar comandos de compilação, experimentar alterações na configuração e verificar as dependências e variáveis de ambiente com o sandbox.