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á.
# Escreva e modifique o código com Dev Environments em CodeCatalyst
Ambientes de desenvolvimento são ambientes de desenvolvimento baseados em nuvem. Na Amazon CodeCatalyst, você usa Dev Environments para trabalhar no código armazenado nos repositórios de origem do seu projeto. Ao criar um Ambiente de Desenvolvimento, você tem várias opções:
+ Crie um ambiente de desenvolvimento específico do projeto CodeCatalyst para trabalhar no código com um ambiente de desenvolvimento integrado (IDE) compatível.
+ Crie um Ambiente de Desenvolvimento vazio, clone o código de um repositório de origem e trabalhe nesse código com um IDE compatível.
+ Criar um Ambiente de Desenvolvimento em um IDE e clonar um repositório de origem no Ambiente de Desenvolvimento
Um *devfile* é um arquivo YAML de padrão aberto que padroniza seus ambientes de desenvolvimento. Em outras palavras, esse arquivo codifica as ferramentas de desenvolvimento necessárias para seu Ambiente de Desenvolvimento. Como resultado, você pode configurar rapidamente um Ambiente de Desenvolvimento, alternar entre projetos e replicar a configuração do Ambiente de Desenvolvimento entre os membros da equipe. Os Ambientes de Desenvolvimento minimizam o tempo gasto criando e mantendo um Ambiente de Desenvolvimento local, porque eles usam um devfile que configura todas as ferramentas necessárias para codificar, testar e depurar em um determinado projeto.
**Importante**
Os ambientes de desenvolvimento podem executar scripts por meio de devfiles que têm acesso às suas CodeCatalyst credenciais. Inspecione o repositório antes de abrir recursos não confiáveis.
As ferramentas do projeto e as bibliotecas de aplicações incluídas no Ambiente de Desenvolvimento são definidas pelo devfile no repositório de origem do projeto. Se você não tiver um devfile no seu repositório de origem, aplica CodeCatalyst automaticamente um devfile padrão. Esse devfile padrão inclui ferramentas para as linguagens e estruturas de programação usadas com mais frequência. Se seu projeto foi criado usando um blueprint, um devfile será criado automaticamente pelo. CodeCatalyst Para ter mais informações sobre o devfile, consulte [https://devfile.io](https://devfile.io).
Depois de criar um Ambiente de Desenvolvimento, somente você pode acessá-lo. Em seu Ambiente de Desenvolvimento, você pode visualizar e trabalhar no código do seu repositório de origem em um IDE compatível.
Por padrão, um Ambiente de Desenvolvimento é configurado para ter um processador de 2 núcleos, 4 GB de RAM e 16 GB de armazenamento persistente. Se você tiver permissões de administrador do espaço, poderá alterar o nível de cobrança do seu espaço para usar diferentes opções de configuração do Ambiente de Desenvolvimento e gerenciar os limites de computação e armazenamento.
**Topics**
+ [Criar um Ambiente de Desenvolvimento](devenvironment-create.md)
+ [Interromper um Ambiente de Desenvolvimento](devenvironment-stop.md)
+ [Retomar um Ambiente de Desenvolvimento](devenvironment-resume.md)
+ [Edição de um Ambiente de Desenvolvimento](devenvironment-edit.md)
+ [Excluir um Ambiente de Desenvolvimento](devenvironment-delete.md)
+ [Estabelecer conexão com um Ambiente de Desenvolvimento usando SSH](devenvironment-connect-ssh.md)
+ [Configuração de um devfile para um Ambiente de Desenvolvimento](devenvironment-devfile.md)
+ [Associar uma conexão VPC a um Ambiente de Desenvolvimento](devenvironment-using-vpc.md)
+ [Cotas para ambientes de desenvolvimento em CodeCatalyst](devenvironment-limits.md)
# Criar um Ambiente de Desenvolvimento
Você pode criar um Ambiente de Desenvolvimento de várias maneiras:
+ Crie um ambiente de desenvolvimento CodeCatalyst com um repositório de CodeCatalyst origem ou um repositório de [origem vinculado nas páginas](source-repositories-link.md) **Visão geral**, **Ambientes de desenvolvimento** ou repositórios de **origem**
+ Crie um ambiente de desenvolvimento vazio CodeCatalyst que não esteja conectado a um repositório de origem na página Ambientes de desenvolvimento
+ Criar um Ambiente de Desenvolvimento no IDE de sua escolha e clonar qualquer repositório de origem no Ambiente de Desenvolvimento
**Importante**
Os ambientes de desenvolvimento não estão disponíveis para usuários em espaços em que o Active Directory é usado como provedor de identidade. Para obter mais informações, consulte [Não consigo criar um ambiente de desenvolvimento quando estou conectado CodeCatalyst usando uma conta de login único](devenvironments-troubleshooting.md#troubleshoot-create-dev-env-idprovider).
Você pode criar um Ambiente de Desenvolvimento por ramificação de um repositório. Um projeto pode ter vários repositórios. Os ambientes de desenvolvimento que você cria só podem ser gerenciados com sua CodeCatalyst conta, mas você pode abrir o ambiente de desenvolvimento e trabalhar nele com qualquer um dos ambientes compatíveis IDEs. Você deve ter o AWS Toolkit instalado para usar os ambientes de desenvolvimento no IDE. Para obter mais informações, consulte [Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento](#devenvironment-supported-ide). Por padrão, os Ambientes de Desenvolvimento são criados com um processador de 2 núcleos, 4 GB de RAM e 16 GB de armazenamento persistente.
**nota**
Se você criou um Ambiente de Desenvolvimento associado a um repositório de origem, a coluna **Recurso** sempre mostra a ramificação especificada ao criar esse Ambiente de Desenvolvimento. Isso se aplica mesmo se você criar outra ramificação, alternar para outra ramificação no Ambiente de Desenvolvimento ou clonar um repositório adicional. Se você criou um Ambiente de Desenvolvimento vazio, a coluna **Recurso** ficará em branco.
## Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento
Você pode usar Dev Environments com os seguintes ambientes de desenvolvimento integrados compatíveis (IDEs):
+ [AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)
+ [JetBrains IDEs](https://www.jetbrains.com/help)
+ [IntelliJ IDEA Ultimate](https://www.jetbrains.com/help/idea/getting-started.html)
+ [GoLand](https://www.jetbrains.com/help/go/getting-started.html)
+ [PyCharmProfissional](https://www.jetbrains.com/help/pycharm/getting-started.html)
+ [Visual Studio Code](https://code.visualstudio.com/docs)
## Criando um ambiente de desenvolvimento em CodeCatalyst
Para começar a trabalhar com o Dev Environment in CodeCatalyst, autentique-se e faça login com seu [ID do AWS Builder](id-how-to-sign-in.md) ou [SSO](sign-in-sso.md).
**Como criar um Ambiente de Desenvolvimento com uma nova ramificação**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja criar um Ambiente de Desenvolvimento.
1. No painel de navegação, execute uma das seguintes opções:
+ Selecione **Visão geral** e navegue até a seção **Meus ambientes de desenvolvimento**.
+ Selecione **Código** e, depois, escolha **Ambientes de Desenvolvimento**.
+ Selecione **Código**, **Repositórios de origem** e selecione o repositório para o qual você deseja criar um Ambiente de Desenvolvimento.
1. Escolha **Criar ambiente de desenvolvimento**.
1. Selecione um IDE compatível no menu suspenso. Consulte [Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento](#devenvironment-supported-ide) para obter mais informações.
1. Escolha **Clonar um repositório**.
1. Execute um destes procedimentos:
1. Escolha o repositório a ser clonado, selecione **Trabalhar na ramificação existente** e, depois, escolha uma ramificação no menu suspenso **Ramificação existente**.
**nota**
Se você escolher um repositório de terceiros, deverá trabalhar em uma ramificação existente.
1. Escolha o repositório a ser clonado, selecione **Trabalhar em uma nova ramificação**, insira um nome de ramificação no campo **Nome da ramificação** e escolha uma ramificação a partir da qual criar a nova ramificação no menu **Criar ramificação**.
**nota**
Se você criar um Ambiente de Desenvolvimento na página **Repositórios de origem** ou em um repositório de origem específico, não precisará escolher um repositório. O Ambiente de Desenvolvimento será criado no repositório de origem que você escolheu na página **Repositórios de origem**.
1. (Opcional) Em **Alias - opcional**, insira um alias para o Ambiente de Desenvolvimento.
1. (Opcional) Escolha o botão de edição da **configuração do Ambiente de Desenvolvimento** para editar a configuração de computação, armazenamento ou tempo limite do Ambiente de Desenvolvimento.
1. (Opcional) Em **Amazon Virtual Private Cloud (Amazon VPC) - opcional**, selecione uma conexão VPC que você gostaria de associar ao seu Ambiente de Desenvolvimento no menu suspenso.
Se uma VPC padrão for definida para seu espaço, seus ambientes de desenvolvimento serão executados conectados a essa VPC. Você pode substituir isso associando uma conexão VPC diferente. Além disso, observe que os ambientes de desenvolvimento conectados à VPC não são compatíveis com AWS Toolkit.
Se a conexão VPC que você deseja usar não estiver listada, talvez seja porque ela inclui uma Conta da AWS conexão que não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
**nota**
Quando você cria um ambiente de desenvolvimento com uma conexão VPC, uma nova interface de rede é criada dentro da VPC. CodeCatalyst interage com essa interface usando a função VPC associada. Além disso, certifique-se de que seu bloco IPv4 CIDR **não** esteja configurado para o intervalo de endereços `172.16.0.0/12` IP.
1. Escolha **Criar**. Enquanto seu Ambiente de Desenvolvimento estiver sendo criado, a coluna de status do Ambiente de Desenvolvimento exibirá **Iniciando** e a coluna de status exibirá **Executando** após a criação do Ambiente de Desenvolvimento.
**Para criar um Ambiente de Desenvolvimento vazio**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja criar um Ambiente de Desenvolvimento.
1. No painel de navegação, execute uma das seguintes opções:
+ Selecione **Visão geral** e navegue até a seção **Meus ambientes de desenvolvimento**.
+ Selecione **Código** e, depois, escolha **Ambientes de Desenvolvimento**.
1. Escolha **Criar ambiente de desenvolvimento**.
1. Selecione um IDE compatível no menu suspenso. Consulte [Ambientes de desenvolvimento integrados compatíveis para ambientes de desenvolvimento](#devenvironment-supported-ide) para obter mais informações.
1. Selecione **Criar um ambiente de desenvolvimento vazio**.
1. (Opcional) Em **Alias - opcional**, insira um alias para o Ambiente de Desenvolvimento.
1. (Opcional) Escolha o botão de edição da **configuração do Ambiente de Desenvolvimento** para editar a configuração de computação, armazenamento ou tempo limite do Ambiente de Desenvolvimento.
1. (Opcional) Em **Amazon Virtual Private Cloud (Amazon VPC) - opcional**, selecione uma conexão VPC que você gostaria de associar ao seu Ambiente de Desenvolvimento no menu suspenso.
Se uma VPC padrão for definida para seu espaço, seus ambientes de desenvolvimento serão executados conectados a essa VPC. Você pode substituir isso associando uma conexão VPC diferente. Além disso, observe que os ambientes de desenvolvimento conectados à VPC não são compatíveis com AWS Toolkit.
Se a conexão VPC que você deseja usar não estiver listada, talvez seja porque ela inclui uma Conta da AWS conexão que não é permitida em seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
**nota**
Quando você cria um ambiente de desenvolvimento com uma conexão VPC, uma nova interface de rede é criada dentro da VPC. CodeCatalyst interage com essa interface usando a função VPC associada. Além disso, certifique-se de que seu bloco IPv4 CIDR **não** esteja configurado para o intervalo de endereços `172.16.0.0/12` IP.
1. Escolha **Criar**. Enquanto seu Ambiente de Desenvolvimento estiver sendo criado, a coluna de status do Ambiente de Desenvolvimento exibirá **Iniciando** e a coluna de status exibirá **Executando** após a criação do Ambiente de Desenvolvimento.
**nota**
A criação e a abertura de um Ambiente de Desenvolvimento pela primeira vez podem levar de um a dois minutos.
**nota**
Depois que o Ambiente de Desenvolvimento for aberto no IDE, talvez seja necessário alterar o diretório para o repositório de origem antes de confirmar e enviar as alterações em seu código.
## Criação de um Ambiente de Desenvolvimento em um IDE
Você pode usar ambientes de desenvolvimento para trabalhar rapidamente no código armazenado nos repositórios de origem do seu projeto. Ambientes de desenvolvimento aumentam sua velocidade de desenvolvimento porque você pode começar a programar imediatamente em um Ambiente de Desenvolvimento em nuvem totalmente funcional e específico do projeto com um Ambiente de Desenvolvimento integrado (IDE) compatível.
Para obter informações sobre como trabalhar com CodeCatalyst um IDE, consulte a documentação a seguir.
+ [Amazon CodeCatalyst para JetBrains IDEs](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-service.html)
+ [Amazon CodeCatalyst para VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-service.html)
+ [Amazon CodeCatalyst para AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/ide-toolkits-cloud9.html)
# Interromper um Ambiente de Desenvolvimento
O diretório `/projects` de um Ambiente de Desenvolvimento armazena os arquivos que são extraídos do repositório de origem e do devfile que é usado para configurar o Ambiente de Desenvolvimento. O diretório `/home`, que fica vazio na criação do Ambiente de Desenvolvimento, armazena os arquivos que você cria enquanto usa seu Ambiente de Desenvolvimento. Tudo nos diretórios `/projects` e `/home` de um Ambiente de Desenvolvimento é armazenado de forma persistente, então você pode parar de trabalhar em um Ambiente de Desenvolvimento se precisar mudar para outro Ambiente de Desenvolvimento, repositório ou projeto.
**Atenção**
Um ambiente de desenvolvimento não atingirá o tempo limite se alguma instância, incluindo navegadores da Web, shells remotos e IDEs, permanecer conectada. Portanto, feche todas as instâncias conectadas para evitar custos adicionais.
Um Ambiente de Desenvolvimento vai parar automaticamente se ficar inativo pelo tempo selecionado nos campos **Tempo limite** quando ele foi criado. Você pode interromper o Ambiente de Desenvolvimento antes que ele fique ocioso. Se você escolher **Sem tempo limite** ao criar seu Ambiente de Desenvolvimento, o Ambiente de Desenvolvimento não será interrompido automaticamente. Em vez disso, ele será executado continuamente.
**Atenção**
Se você interromper um Ambiente de Desenvolvimento associado a uma conexão VPC excluída, ele não poderá ser retomado.
**Como interromper um Ambiente de Desenvolvimento na página Ambientes de desenvolvimento**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja interromper um Ambiente de Desenvolvimento.
1. No painel de navegação, selecione **Código**.
1. Selecione **Ambientes de desenvolvimento**.
1. Marque o botão de seleção do Ambiente de Desenvolvimento que você deseja interromper.
1. No menu **Ações**, selecione **Parar**.
**nota**
O uso da computação é cobrado somente enquanto o Ambiente de Desenvolvimento está em execução, mas o uso do armazenamento é cobrado por todo o tempo em que o Ambiente de Desenvolvimento existe. Interrompa seu Ambiente de Desenvolvimento quando ele não estiver em uso para interromper o faturamento de computação.
# Retomar um Ambiente de Desenvolvimento
O diretório `/projects` de um Ambiente de Desenvolvimento armazena os arquivos que são extraídos do repositório de origem e do devfile que é usado para configurar o Ambiente de Desenvolvimento. O diretório `/home`, que fica vazio na criação do Ambiente de Desenvolvimento, armazena os arquivos que você cria enquanto usa seu Ambiente de Desenvolvimento. Tudo nos diretórios `/projects` e `/home` de um Ambiente de Desenvolvimento é armazenado de forma persistente, para que você possa parar de trabalhar nele se precisar mudar para outro Ambiente de Desenvolvimento, repositório ou projeto e continuar trabalhando nele posteriormente.
Um Ambiente de Desenvolvimento vai parar automaticamente se ficar inativo pelo tempo selecionado nos campos **Tempo limite** quando ele foi criado. Você deve fechar a guia do AWS Cloud9 navegador para que o Dev Environment fique ocioso.
**nota**
O Ambiente de Desenvolvimento ainda está disponível e em execução mesmo se você excluir a ramificação com a qual o criou. Se você quiser continuar trabalhando em um Ambiente de Desenvolvimento do qual excluiu a ramificação, crie uma nova ramificação e envie suas alterações para ela.
**Para retomar um Ambiente de Desenvolvimento na página de visão geral**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja retomar um Ambiente de Desenvolvimento e navegue até a seção **Meus ambientes de desenvolvimento**.
1. Selecione **Retomar em (IDE)**.
+ Para JetBrains IDEs, escolha JetBrains Gateway-EAP quando solicitado a **Escolher um aplicativo para abrir** o link -gateway. JetBrains Quando solicitado, selecione **Abrir link** para confirmar.
+ Para o IDE do VS Code, escolha VS Code quando solicitado a **Escolher uma aplicação para abrir o link do VS Code**. Selecione **Abrir link** para confirmar.
**Para retomar um Ambiente de Desenvolvimento no repositório de origem**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja retomar um Ambiente de Desenvolvimento.
1. No painel de navegação, selecione **Código**.
1. Selecione **Repositórios de origem**.
1. Escolha o repositório de origem que contém o Ambiente de Desenvolvimento que você deseja retomar.
1. Escolha o nome da ramificação para ver um menu suspenso de suas ramificações e, depois, escolha sua ramificação.
1. Selecione **Retomar Ambiente de Desenvolvimento**.
+ Para JetBrains IDEs, escolha **Abrir link** para confirmar quando solicitado a opção **Permitir que este site abra o link JetBrains -gateway com JetBrains o** Gateway? .
+ Para o IDE do VS Code, escolha **Abrir link** para confirmar quando solicitado a **Permitir que este site abra o link do VS Code com o Visual Studio Code?**.
**Para retomar um Ambiente de Desenvolvimento na página Ambientes de desenvolvimento**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja retomar um Ambiente de Desenvolvimento.
1. No painel de navegação, selecione **Código**.
1. Selecione **Ambientes de desenvolvimento**.
1. Na coluna **IDE**, selecione **Retomar em (IDE)** para o Ambiente de Desenvolvimento.
+ Para JetBrains IDEs, escolha **Abrir link** para confirmar quando solicitado a opção **Permitir que este site abra o link JetBrains -gateway com JetBrains o** Gateway? .
+ Para o IDE do VS Code, escolha **Abrir link** para confirmar quando solicitado a **Permitir que este site abra o link do VS Code com o Visual Studio Code?**.
**nota**
A retomada de um Ambiente de Desenvolvimento pode levar alguns minutos.
# Edição de um Ambiente de Desenvolvimento
Enquanto seu IDE está em execução, você pode editar o Ambiente de Desenvolvimento. Se você editar o tempo limite de computação ou inatividade, seu Ambiente de Desenvolvimento será reiniciado depois que você salvar as alterações.
**Como editar um Ambiente de Desenvolvimento**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja editar um Ambiente de Desenvolvimento.
1. No painel de navegação, selecione **Código**.
1. Selecione **Ambientes de desenvolvimento**.
1. Escolha o Ambiente de Desenvolvimento que você deseja editar.
1. Escolha **Editar**.
1. Faça as alterações desejadas no tempo limite de computação ou inatividade.
1. Escolha **Salvar**.
# Excluir um Ambiente de Desenvolvimento
Quando terminar de trabalhar no conteúdo armazenado em seu Ambiente de Desenvolvimento, você poderá excluí-lo. Crie um Ambiente de Desenvolvimento para trabalhar em novos conteúdos. Se você excluir seu Ambiente de Desenvolvimento, o conteúdo persistente será excluído permanentemente. Antes de excluir o Ambiente de Desenvolvimento, confirme e envie suas alterações de código para o repositório de origem original do Ambiente de Desenvolvimento. Depois de excluir seu Ambiente de Desenvolvimento, o faturamento de computação e armazenamento do Ambiente de Desenvolvimento será interrompido.
Depois de excluir seu Ambiente de Desenvolvimento, pode demorar alguns minutos até que a cota de armazenamento seja atualizada. Se você atingiu a cota de armazenamento, não poderá criar um Ambiente de Desenvolvimento durante esse período.
**Importante**
A exclusão de um Ambiente de Desenvolvimento não pode ser desfeita. Depois de excluir um Ambiente de Desenvolvimento, não é mais possível recuperá-lo.
**Como excluir um Ambiente de Desenvolvimento**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto em que deseja excluir um Ambiente de Desenvolvimento.
1. No painel de navegação, selecione **Código**.
1. Selecione **Ambientes de desenvolvimento**.
1. Escolha o Ambiente de Desenvolvimento que você deseja excluir.
1. Escolha **Excluir**.
1. Digite **delete** para confirmar a exclusão do Ambiente de Desenvolvimento.
1. Escolha **Excluir**.
**nota**
Antes de excluir uma conexão VPC em seu espaço, remova o Ambiente de Desenvolvimento associado a essa VPC.
Mesmo se você excluir um Ambiente de Desenvolvimento, talvez não exclua a interface de rede na VPC. Limpe seus recursos conforme necessário. Se ocorrer um erro ao excluir um Ambiente de Desenvolvimento conectado à VPC, você deverá [desconectar](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#detach_eni) sua conexão obsoleta e [excluí-la](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#delete_eni) depois de confirmar que ela não está sendo usada.
# 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 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), 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===
```
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 :127.0.0.1: codecatalyst-dev-env===
```
+ Upload de um arquivo para o diretório inicial em seu Ambiente de Desenvolvimento:
```
scp -O codecatalyst-dev-env===:
```
# Configuração de um devfile para um Ambiente de Desenvolvimento
Um *devfile* é um padrão aberto que ajuda você a personalizar seus ambientes de desenvolvimento em toda a sua equipe. Um devfile é um arquivo YAML que codifica as ferramentas de desenvolvimento necessárias. Ao configurar um devfile, você pode pré-determinar as ferramentas de projeto e as bibliotecas de aplicativos de que precisa e a Amazon as CodeCatalyst instala em seu ambiente de desenvolvimento para você. O devfile é específico do repositório para o qual foi criado, e você pode criar um devfile separado para cada repositório. Seu Ambiente de Desenvolvimento oferece suporte a comandos e eventos e fornece uma imagem padrão de devfile universal.
Se você criar um projeto usando o esquema vazio, poderá criar um devfile manualmente. Se você criar um projeto usando um blueprint diferente, CodeCatalyst cria um devfile automaticamente. O diretório `/projects` de um Ambiente de Desenvolvimento armazena os arquivos que são extraídos do repositório de origem e do devfile. O diretório `/home`, que está vazio quando você cria um Ambiente de Desenvolvimento pela primeira vez, armazena os arquivos criados enquanto usa o Ambiente de Desenvolvimento. Tudo nos diretórios `/projects` e `/home` de um Ambiente de Desenvolvimento é armazenado de forma persistente.
**nota**
A pasta `/home` só será alterada se você alterar o nome do devfile ou o nome do componente devfile. Se você alterar o nome do devfile ou do componente devfile, o conteúdo do diretório `/home` será substituído e os dados do diretório `/home` anterior não poderão ser recuperados.
Se você criar um Ambiente de Desenvolvimento com um repositório de origem que não contenha um devfile na raiz ou criar um Ambiente de Desenvolvimento sem um repositório de origem, um devfile universal padrão será aplicado automaticamente ao repositório de origem. A mesma imagem devfile universal padrão é usada para todos IDEs. CodeCatalyst atualmente suporta a versão 2.0.0 do devfile. Para ter mais informações sobre o devfile, consulte [Esquema Devfile - Versão 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
**nota**
Você só pode incluir imagens de contêiner público em seu devfile.
Os ambientes de desenvolvimento conectados à VPC oferecem suporte apenas às seguintes imagens de devfile:
+ Imagem universal
+ Imagens privadas do Amazon ECR, se o repositório estiver na mesma região da VPC
**Topics**
+ [Edição do repositório devfile para um Ambiente de Desenvolvimento](devenvironment-devfile-moving.md)
+ [Recursos do Devfile suportados pelo CodeCatalyst](#devenvironment-devfile-support)
+ [Exemplo de um devfile para um Ambiente de Desenvolvimento](#devenvironment-devfile-example)
+ [Solução de problemas de um repositório devfile usando o modo de recuperação](#devenvironment-devfile-recovery)
+ [Especificar imagens de devfile universais para um Ambiente de Desenvolvimento](devenvironment-universal-image.md)
+ [Comandos Devfile](devenvironment-devfile-commands.md)
+ [Eventos do Devfile](devenvironment-devfile-events.md)
+ [Componentes do Devfile](devenvironment-devfile-components.md)
# Edição do repositório devfile para um Ambiente de Desenvolvimento
Use o procedimento a seguir para editar o repositório devfile para um Ambiente de Desenvolvimento.
## Editando um devfile de repositório para um ambiente de desenvolvimento no CodeCatalyst
**Para editar o repositório devfile**
1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Navegue até o projeto que contém o repositório de origem para o qual você deseja editar o devfile.
1. No painel de navegação, selecione **Código**.
1. Selecione **Repositórios de origem**.
1. Escolha o repositório de origem que contém o devfile que você deseja editar.
1. Na lista de arquivos, escolha o arquivo `devfile.yaml`.
1. Escolha **Editar**.
1. Edite o devfile.
1. Selecione **Confirmar** ou crie uma solicitação pull para que um membro da equipe possa revisar e aprovar as alterações.
**nota**
Se editar o devfile, você precisará reiniciar o devfile para que as alterações sejam implementadas. Isso pode ser feito executando `/aws/mde/mde start --location devfile.yaml`. Se houver algum problema ao iniciar o devfile, ele entrará no modo de recuperação. No entanto, se você editar um devfile associado a um Ambiente de Desenvolvimento conectado à VPC, precisará reiniciar o Ambiente de Desenvolvimento para que as alterações entrem em vigor.
Você pode revisar qual devfile está sendo usado executando `/aws/mde/mde status`. O campo de localização tem o caminho do devfile em relação à pasta `/projects` do ambiente.
```
{
"status": "STABLE",
"location": "devfile.yaml"
}
```
Você também pode mover o devfile padrão em `/projects/devfile.yaml` para o seu repositório de código-fonte. Para atualizar a localização do devfile, use o seguinte comando: `/aws/mde/mde start --location repository-name/devfile.yaml`.
## Edição do repositório devfile para um Ambiente de Desenvolvimento em um IDE
Para alterar a configuração de um Ambiente de Desenvolvimento, você deve editar o devfile. Recomendamos que você edite o devfile em um IDE compatível e, em seguida, atualize seu ambiente de desenvolvimento, mas você também pode editar o devfile a partir da raiz do repositório de origem em. CodeCatalyst Se você editar o devfile em um IDE compatível, confirme e envie suas alterações para o repositório de origem ou crie uma solicitação pull para que um membro da equipe possa revisar e aprovar as edições no devfile.
+ [Editando o arquivo de desenvolvimento do repositório para um ambiente de desenvolvimento no AWS Cloud9](https://docs.aws.amazon.com/cloud9/latest/user-guide/devenvironment-cloud9.title.html#ide-toolkits-edit-devfile-cloud9)
+ [Edição do repositório devfile para um Ambiente de Desenvolvimento no VS Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/codecatalyst-devenvironment.html#codecatalyst-devenvironment-devfile)
+ [Editando o arquivo de desenvolvimento do repositório para um ambiente de desenvolvimento no JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/codecatalyst-overview.html#codecatalyst-overview-default)
## Recursos do Devfile suportados pelo CodeCatalyst
CodeCatalyst suporta os seguintes recursos do devfile na versão 2.0.0. Para ter mais informações sobre o devfile, consulte [Esquema Devfile - Versão 2.0.0](https://devfile.io/docs/2.0.0/devfile-schema).
| Recurso | Tipo |
| --- | --- |
| `exec` | Command |
| `postStart` | Event |
| `container` | Componente |
| `args` | Propriedades do componente |
| `env` | Propriedades do componente |
| `mountSources` | Propriedades do componente |
| `volumeMounts` | Propriedades do componente |
## Exemplo de um devfile para um Ambiente de Desenvolvimento
Veja a seguir um exemplo de um devfile simples.
```
schemaVersion: 2.0.0
metadata:
name: al2
components:
- name: test
container:
image: public.ecr.aws/amazonlinux/amazonlinux:2
mountSources: true
command: ['sleep', 'infinity']
- name: dockerstore
commands:
- id: setupscript
exec:
component: test
commandLine: "chmod +x script.sh"
workingDir: /projects/devfiles
- id: executescript
exec:
component: test
commandLine: "/projects/devfiles/script.sh"
- id: yumupdate
exec:
component: test
commandLine: "yum -y update --security"
events:
postStart:
- setupscript
- executescript
- yumupdate
```
Os logs de inicialização, comandos e eventos do devfile são capturados e armazenados em `/aws/mde/logs`. Para depurar o comportamento do devfile, inicie seu Ambiente de Desenvolvimento usando um devfile ativo e acesse os logs.
## Solução de problemas de um repositório devfile usando o modo de recuperação
Se houver algum problema ao iniciar seu devfile, ele entrará no modo de recuperação para que você ainda possa se conectar ao ambiente e corrigir o devfile. No modo de recuperação, a execução de `/aws/mde/mde status` não conterá a localização do devfile.
```
{
"status": "STABLE"
}
```
Você pode verificar o erro nos logs em `/aws/mde/logs`, corrigir o devfile e tentar executar `/aws/mde/mde start` novamente.
# Especificar imagens de devfile universais para um Ambiente de Desenvolvimento
A *imagem universal* padrão inclui as linguagens de programação mais usadas e as ferramentas relacionadas que podem ser usadas em seu IDE. Se nenhuma imagem for especificada, CodeCatalyst fornece essa imagem e contém ferramentas que são mantidas pelo CodeCatalyst. Para permanecer notificado sobre o lançamento de novas imagens, consulte [Assinatura de notificações de imagem universal com o SNS](#devenvironment-universal-notifications).
A Amazon oferece suporte CodeCatalyst ativo às seguintes imagens de devfile:
| Versão da imagem | Identificador da imagem |
| --- | --- |
| Universal image 4.0 | public.ecr.aws/aws-mde/universal-image:4.0 |
| Universal image 5.0 | public.ecr.aws/aws-mde/universal-image:5.0 |
**nota**
Você também pode usar `public.ecr.aws/aws-mde/universal-image:latest` para ter a imagem mais recente, que atualmente é `public.ecr.aws/aws-mde/universal-image:5.0`.
CodeCatalyst desativou as imagens a seguir. Ainda é possível usar essas imagens, mas elas não serão armazenadas em cache no host de criação e resultarão em tempos de inicialização do Ambiente de Desenvolvimento mais altos.
| Versão da imagem | Identificador da imagem | Data da substituição |
| --- | --- | --- |
| Universal image 1.0 | public.ecr.aws/aws-mde/universal-image:1.0 | 16 de agosto de 2024 |
| Universal image 2.0 | public.ecr.aws/aws-mde/universal-image:2.0 | 16 de agosto de 2024 |
| Universal image 3.0 | public.ecr.aws/aws-mde/universal-image:3.0 | 30 de julho de 2025 |
**nota**
Se você estiver usando AWS Cloud9, o preenchimento automático não funcionará para PHP, Ruby e CSS após a atualização para. `universal-image:3.0`
**Topics**
+ [Assinatura de notificações de imagem universal com o SNS](#devenvironment-universal-notifications)
+ [Versões de runtime da imagem universal 4.0](#devenvironment-universal-runtimes-4.0)
+ [Versões de tempo de execução do Universal Image 5.0](#devenvironment-universal-runtimes-5.0)
## Assinatura de notificações de imagem universal com o SNS
CodeCatalyst fornece um serviço universal de notificação por imagem. Você pode usá-lo para assinar um tópico do Amazon Simple Notification Service (SNS) que notifica você quando atualizações CodeCatalyst universais de imagens forem lançadas. Para ter mais informações sobre tópicos do SNS, consulte [O que é o Amazon Simple Notification Service?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html).
Sempre que novas imagens universais são lançadas, enviamos notificações aos assinantes; esta seção descreve como assinar atualizações CodeCatalyst universais de imagens.
**Exemplo de mensagem**
```
{
"Type": "Notification",
"MessageId": "123456789",
"TopicArn": "arn:aws:sns:us-east-1:1234657890:universal-image-updates",
"Subject": "New Universal Image Release",
"Message": {
"v1": {
"Message": "A new version of the Universal Image has been released. You are now able to launch new DevEnvironments using this image.",
"image ": {
"release_type": "MAJOR VERSION",
"image_name": "universal-image",
"image_version": "2.0",
"image_uri": "public.ecr.aws/amazonlinux/universal-image:2.0"
}
}
},
"Timestamp": "2021-09-03T19:05:57.882Z",
"UnsubscribeURL": "example url"
}
```
**Para assinar atualizações de imagens CodeCatalyst universais usando o console do Amazon SNS**
1. Abra o console do Amazon SNS no [Painel](https://console.aws.amazon.com/sns/v2/home).
1. Na barra de navegação, escolha seu Região da AWS.
1. No painel de navegação, escolha **Subscriptions (Assinaturas)** e, depois, selecione **Create subscription (Criar assinatura)**.
1. Em **ARN do tópico**, insira `arn:aws:sns:us-east-1:089793673375:universal-image-updates`.
1. Em **Protocol (Protocolo)**, selecione **Email**.
1. No **Endpoint**, forneça um endereço de e-mail. O endereço de e-mail será usado para receber notificações.
1. Selecione **Criar assinatura**.
1. Você receberá um e-mail de confirmação com o assunto "AWS Notificação - Confirmação de assinatura”. Abra o e-mail e selecione **Confirmar assinatura**.
**Para cancelar a assinatura de atualizações de imagens CodeCatalyst universais usando o console do Amazon SNS**
1. Abra o console do Amazon SNS no [Painel](https://console.aws.amazon.com/sns/v2/home).
1. Na barra de navegação, escolha seu Região da AWS.
1. No painel de navegação, selecione **Assinaturas** e selecione a assinatura da qual você deseja cancelar a assinatura.
1. Escolha **Ações** e escolha **Excluir assinaturas**.
1. Escolha **Excluir**.
## Versões de runtime da imagem universal 4.0
A tabela a seguir lista os runtimes para `universal-image:4.0`.
**Versões do runtime de `universal-image:4.0`**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/devenvironment-universal-image.html)
## Versões de tempo de execução do Universal Image 5.0
A tabela a seguir lista os runtimes disponíveis para `universal-image:5.0`.
**Versões do runtime de `universal-image:5.0`**
| Nome do runtime | Versão | Versão secundária mais recente e principal específica |
| --- | --- | --- |
| aws cli | 2,25 | `aws-cli: 2.x` |
| docker compose | 2.34 | `docker-compose: 2.x` |
| dotnet | 8.0 | `dotnet: 8.x` |
| golang | 1,24 | `golang: 1.x` |
| java | corretto21 | `java: corretto21.x` |
| nodejs | 22,0 | `nodejs: 22.x` |
| php | 8.3.16 | `php: 8.x` |
| python | 3.12 | `python: 3.x` |
| ruby | 3.4.2 | `ruby: 3.x` |
| terraform | 1.10.5 | `terraform: 1.x` |
# Comandos Devfile
Atualmente, CodeCatalyst só suporta `exec` comandos em seu devfile. Para ter mais informações, consulte [Adicionar comandos](https://devfile.io/docs/2.0.0/adding-commands) na documentação do Devfile.io.
O exemplo a seguir mostra como especificar comandos `exec` no devfile.
```
commands:
- id: setupscript
exec:
component: test
commandLine: "chmod +x script.sh"
workingDir: /projects/devfiles
- id: executescript
exec:
component: test
commandLine: "./projects/devfiles/script.sh"
- id: updateyum
exec:
component: test
commandLine: "yum -y update --security"
```
Depois de se conectar ao Ambiente de Desenvolvimento, você pode executar comandos definidos por meio do terminal.
```
/aws/mde/mde command
/aws/mde/mde command executescript
```
Para comandos de longa execução, você pode usar o sinalizador de streaming `-s` para gerar a execução do comando em tempo real.
```
/aws/mde/mde -s command
```
**nota**
`command-id` deve estar em letras minúsculas.
## Parâmetros de execução suportados por CodeCatalyst
CodeCatalyst suporta os seguintes `exec` parâmetros na versão 2.0.0 do devfile.
+ `commandLine`
+ `component`
+ `id`
+ `workingDir`
# Eventos do Devfile
Atualmente, CodeCatalyst só oferece suporte a `postStart` eventos em seu devfile. Para obter mais informações, consulte a [postStartObject](https://devfile.io/docs/2.0.0/adding-event-bindings#post-start-object)documentação do Devfile.io.
O exemplo a seguir mostra como adicionar vinculações de eventos `postStart` ao devfile.
```
commands:
- id: executescript
exec:
component: test
commandLine: "./projects/devfiles/script.sh"
- id: updateyum
exec:
component: test
commandLine: "yum -y update --security"
events:
postStart:
- updateyum
- executescript
```
Após a inicialização, seu Ambiente de Desenvolvimento executará os comandos `postStart` especificados na ordem em que foram definidos. Se um comando falhar, o Ambiente de Desenvolvimento continuará em execução e a saída da execução será armazenada nos logs em `/aws/mde/logs`.
# Componentes do Devfile
Atualmente, CodeCatalyst só oferece suporte a `container` componentes em seu devfile. Para ter mais informações, consulte [Adicionar componentes](https://devfile.io/docs/2.0.0/adding-components) na documentação do Devfile.io.
O exemplo a seguir mostra como adicionar um comando de inicialização ao contêiner no devfile.
```
components:
- name: test
container:
image: public.ecr.aws/amazonlinux/amazonlinux:2
command: ['sleep', 'infinity']
```
**nota**
Quando o contêiner tem um comando de entrada de curta duração, você deve incluir `command: ['sleep', 'infinity']` para manter o contêiner em execução.
CodeCatalyst também oferece suporte às seguintes propriedades em seu componente de contêiner: `args` `env``mountSources`,, `volumeMounts` e.
# Associar uma conexão VPC a um Ambiente de Desenvolvimento
Uma *conexão VPC* é um CodeCatalyst recurso que contém todas as configurações necessárias para que seu fluxo de trabalho acesse uma VPC. Os administradores do espaço podem adicionar suas próprias conexões de VPC no console da CodeCatalyst Amazon em nome dos membros do espaço. Ao adicionar uma conexão VPC, os membros do espaço podem executar ações de fluxo de trabalho e criar ambientes de desenvolvimento que sigam as regras de rede e possam acessar recursos na VPC associada.
**Importante**
Ambientes de desenvolvimento com uma conexão VPC não oferecem suporte a [repositórios de origem de terceiros](source-repositories-link.md) vinculados a. CodeCatalyst
Você só pode associar um Ambiente de Desenvolvimento a uma conexão VPC após a criação do Ambiente de Desenvolvimento. Não é possível alterar a conexão VPC associada ao Ambiente de Desenvolvimento depois de criá-la. Se quiser usar uma conexão VPC diferente, você precisa excluir o Ambiente de Desenvolvimento atual e criar outro.
**nota**
Os ambientes de desenvolvimento só podem ser associados a uma conexão VPC com uma AWS conta que tenha acesso ao seu projeto. Para obter mais informações, consulte [Configuração de conexões de contas restritas a projetos](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-accounts-restriction.html) no *Amazon CodeCatalyst * Administrator Guide.
Observe que os ambientes de desenvolvimento utilizam vários AWS recursos e serviços na criação. Isso significa que os Dev Environments se conectam aos seguintes AWS serviços:
+ Amazon CodeCatalyst
+ AWS SSM
+ AWS KMS
+ Amazon ECR
+ Amazon CloudWatch
+ Amazon ECS
**nota**
AWS Toolkit não oferece suporte à criação de ambientes de desenvolvimento com uma conexão VPC associada. Observe também que, se você usar um IDE diferente AWS Cloud9, poderá ter tempos de carregamento de cerca de cinco minutos.
Você deve ter o perfil de **Administrador do espaço** ou **Usuário avançado** para gerenciar conexões VPC no nível do espaço. Para obter mais informações sobre VPCs, consulte [Gerenciando a Amazon VPCs CodeCatalyst no](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.html) *Guia do CodeCatalyst Administrador*.
# Cotas para ambientes de desenvolvimento em CodeCatalyst
A tabela a seguir descreve cotas e limites para ambientes de desenvolvimento na Amazon CodeCatalyst. Para obter mais informações sobre cotas na Amazon CodeCatalyst, consulte[Cotas para o CodeCatalyst](quotas.md).
| | |
| --- |--- |
| Número de horas de Ambiente de Desenvolvimento por mês | As horas do Ambiente de Desenvolvimento são afetadas pelos limites gerais de armazenamento do seu espaço. Para obter mais informações, consulte [Preços](https://codecatalyst.aws/explore/pricing) e [Solucionar problemas com Ambientes de Desenvolvimento](devenvironments-troubleshooting.md). |
| Quantidade de armazenamento do Ambiente de Desenvolvimento por espaço | O armazenamento do Ambiente de Desenvolvimento é afetado pelos limites gerais de armazenamento do seu espaço. Para obter mais informações, consulte [Preços](https://codecatalyst.aws/explore/pricing) e [Solucionar problemas com Ambientes de Desenvolvimento](devenvironments-troubleshooting.md). |
| Quantidade de computação do Ambiente de Desenvolvimento | A computação do Ambiente de Desenvolvimento é afetada pelos limites gerais de armazenamento do seu espaço. Para obter mais informações, consulte [Preços](https://codecatalyst.aws/explore/pricing) e [Solucionar problemas com Ambientes de Desenvolvimento](devenvironments-troubleshooting.md). |