Tutorial: conectar-se a um sandbox usando SSH - AWS CodeBuild
Etapa 1: iniciar um sandboxEtapa 2: modificar a configuração de SSH localEtapa 3: conectar-se ao sandboxEtapa 4: revisar os resultados

Tutorial: conectar-se a um sandbox usando SSH

Esse tutorial mostra como se conectar a um sandbox do CodeBuild usando um cliente SSH.

Para concluir este tutorial, você deve primeiramente:

  • Você deve ter um projeto do AWS CodeBuild existente.

  • Configure as permissões apropriadas do IAM configuradas para o perfil de projeto do CodeBuild.

  • Instale e configure a AWS CLI na máquina local.

Etapa 1: iniciar um sandbox

Como iniciar um sandbox do CodeBuild no console

  1. Abra o console do AWS CodeBuild em https://console.aws.amazon.com/codesuite/codebuild/home.

  2. 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.

  3. Na guia Cliente SSH, escolha Iniciar sandbox.

    A guia “Cliente SSH” no console com o botão “Iniciar sandbox”.

  4. 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”.

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.

  2. 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 o sandbox do CodeBuild no console.

  3. 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.

  4. Após a configuração ser bem-sucedida, uma nova entrada de configuração SSH para o sandbox do CodeBuild será criada.

    Uma conexão de sandbox via SSH bem-sucedida.

Etapa 3: conectar-se ao sandbox

Como modificar a configuração SSH local no console

  1. Configure a autenticação da AWS CLI e garanta que o usuário da AWS CLI tenha a permissão codebuild:StartSandboxConnection. Consulte mais informações em Autenticação usando credenciais de usuário do IAM para a AWS CLI no Guia do usuário da AWS Command Line Interface versão 1.

  2. Conecte-se ao sandbox com o seguinte comando:

    ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>
    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:<account-id>:sandbox/<sandbox-id>.

    Consulte mais orientações sobre solução de problemas em Solucionar problemas de conexão SSH do sandbox do AWS CodeBuild.

Etapa 4: revisar os 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.