Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH - Amazon CodeCatalyst

Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH

Você pode se conectar ao seu Ambiente de Desenvolvimento usando SSH para realizar ações sem limitações, como encaminhamento de portas, upload e download de arquivos e uso de outros IDEs.

nota

Se você quiser continuar usando o SSH por um longo período após fechar a guia ou janela do IDE, defina um tempo limite alto para seu Ambiente de Desenvolvimento para que ele não pare devido à inatividade no IDE.

Pré-requisitos

  • Você precisa de um dos seguintes sistemas operacionais:

    • Windows 10 ou mais recente e OpenSSH habilitado

    • macOS e Bash versão 3 ou superior

    • Linux com yum, dpkg ou gerenciadores de pacotes rpm e Bash versão 3 ou superior

  • Você também precisa da AWS CLI versão 2.9.4 ou superior.

Para se conectar a um Ambiente de Desenvolvimento usando SSH

  1. Abra o console do CodeCatalyst em https://codecatalyst.aws/.

  2. Navegue até o projeto em que deseja se conectar a um Ambiente de Desenvolvimento usando SSH.

  3. No painel de navegação, selecione Código.

  4. Selecione Ambientes de desenvolvimento.

  5. Escolha um Ambiente de Desenvolvimento em execução ao qual você deseja se conectar usando SSH.

  6. Selecione Conectar via SSH, escolha o sistema operacional desejado e faça o seguinte:

    • Caso ainda não tenha feito isso, cole e execute o primeiro comando no terminal especificado. O comando baixa um script e executa as seguintes modificações em seu ambiente local para que você possa se conectar ao seu Ambiente de Desenvolvimento usando SSH:

      • Instala o plug-in do gerenciador de sessão para a AWS CLI

      • Modifica o AWS Config local e adiciona um perfil do CodeCatalyst para que você possa realizar o login do SSO. Para ter mais informações, consulte Configuração para usar o AWS CLI com o CodeCatalyst.

      • Modifica sua configuração SSH local e adiciona a configuração necessária para se conectar ao seu Ambiente de Desenvolvimento usando SSH.

      • Adiciona um script no diretório ~/.aws/codecatalyst-dev-env usado pelo cliente SSH para se conectar ao seu Ambiente de Desenvolvimento. Esse script chama a API StartDevEnvironmentSession do CodeCatalyst e usa o plug-in do AWS Systems Manager Session Manager para estabelecer uma sessão do AWS Systems Manager com seu Ambiente de Desenvolvimento, que é usado pelo cliente SSH local para se conectar com segurança ao Ambiente de Desenvolvimento remoto.

    • Faça login no Amazon CodeCatalyst usando o SSO da AWS usando o segundo comando. Esse comando solicita e recupera credenciais para que o script no diretório ~/.aws/codecatalyst-dev-env possa chamar a API StartDevEnvironmentSession do CodeCatalyst. Esse comando deve ser executado sempre que suas credenciais expirarem. Ao executar o último comando no modal(ssh<destination>), você receberá um erro se suas credenciais expirarem ou se você não tiver realizado o login do SSO conforme as instruções nesta etapa.

    • Conecte-se ao Ambiente de Desenvolvimento especificado usando SSH usando o terceiro comando. Este comando tem a seguinte estrutura:

      ssh codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>

      Você também pode usar esse comando para realizar outras ações permitidas pelo cliente SSH, como encaminhamento de porta ou upload e download de arquivos:

      • Encaminhamento de portas:

        ssh -L <local-port>:127.0.0.1:<remote-port> codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>

      • Upload de um arquivo para o diretório inicial em seu Ambiente de Desenvolvimento:

        scp -O </path-to-local-file> codecatalyst-dev-env=<space-name>=<project-name>=<dev-environment-id>:</path-to-remote-file-or-directory>