A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

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

# Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH
<a name="devenvironment-connect-ssh"></a>

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.<a name="devenvironment-connect-ssh-steps"></a>

**Para se conectar a um Ambiente de Desenvolvimento usando SSH**

1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).

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

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

1. Selecione **Ambientes de desenvolvimento**.

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

1. 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ões para o AWS CLI](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
     + Modifica seu local AWS Config e adiciona um CodeCatalyst perfil para que você possa realizar o login do SSO. Para obter mais informações, consulte [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md).
     + 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 [CodeCatalyst StartDevEnvironmentSession API](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) e usa o AWS Systems Manager Session Manager plug-in para estabelecer uma AWS Systems Manager sessão com seu ambiente de desenvolvimento, que é usada pelo cliente SSH local para se conectar com segurança ao ambiente de desenvolvimento remoto.
   + Faça login na Amazon CodeCatalyst usando o AWS SSO usando o segundo comando. [Esse comando solicita e recupera credenciais para que o script no `~/.aws/codecatalyst-dev-env` diretório possa chamar CodeCatalyst StartDevEnvironmentSession a API.](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html) 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>
       ```