Trabalhar em Ambientes de Desenvolvimento e no VS Code

Você pode iniciar um ambiente de computação virtual do VS Code, conhecido como Ambiente de Desenvolvimento, no kit de ferramentas para VS Code. Ambientes de Desenvolvimento são ambientes personalizáveis de desenvolvimento em nuvem que você pode copiar e compartilhar entre diferentes membros da equipe em seu espaço.

As seções a seguir descrevem como configurar os Ambientes de Desenvolvimento local e remotamente, bem como recursos básicos que podem ser acessados no kit de ferramentas para VS Code quando ele é iniciado em um Ambiente de Desenvolvimento. Para obter mais informações sobre Ambientes de Desenvolvimento, consulte Dev Environments no guia do CodeCatalyst.

Configurar o Ambiente de Desenvolvimento com devfiles

Você pode definir as ferramentas e bibliotecas de aplicações específicas do projeto que são instaladas no Ambiente de Desenvolvimento no devfile do Ambiente de Desenvolvimento. A especificação devfile é um padrão aberto que você escreve no documento YAML.

Você pode editar o devfile local e remotamente no VS Code. O processo é semelhante à criação ou edição de qualquer arquivo compatível com o VS Code. Você também pode editar o Devfile diretamente no CodeCatalyst, no repositório de origem do projeto. Para obter instruções sobre como editar o devfile no CodeCatalyst, consulte a seção Configuring your Dev Environment do guia do CodeCatalyst.

Importante

Se você editar o Devfile do VS Code, esteja ciente do seguinte:

• Alterar o nome do devfile ou o nome do componente devfile substitui o conteúdo do diretório raiz. Todo o conteúdo anterior é perdido e irrecuperável.

• Se você criar um Ambiente de Desenvolvimento sem um devfile na pasta raiz ou um Ambiente de Desenvolvimento que não esteja associado a um repositório de origem, um devfile com configurações padrão será gerado para o Ambiente de Desenvolvimento quando você o criar.

• Para obter instruções sobre como definir e configurar o Devfile, consulte a documentação Adding Commands no site Devfile.io.

Para editar o Devfile em uma instância local do VS Code:

1. No VS Code, localize o arquivo devfile.yaml e abra-o no editor do VS Code.

2. Faça as alterações no documento e salve.

3. Confirme as alterações e, em seguida, envie para o repositório de origem.

4. Na próxima vez em que você iniciar o Ambiente de Desenvolvimento, a configuração será atualizada para corresponder às especificações definidas no Devfile.

Conectar as credenciais do AWS IAM ao Ambiente de Desenvolvimento

Para acessar todos os serviços do kit de ferramentas para VS Code em um Ambiente de Desenvolvimento, você precisa conectar as credenciais do AWS IAM ao Ambiente de Desenvolvimento. Para conectar as credenciais do IAM ao Ambiente de Desenvolvimento, faça o seguinte:

1. No EXPLORER do kit de ferramentas para VS Code, em seu Ambiente de Desenvolvimento, selecione Selecionar credenciais do IAM para visualizar recursos para abrir a caixa de diálogo Alternar conexão.

2. Escolha as credenciais do IAM que deseja usar na lista ou selecione Adicionar novas conexões para adicionar novas credenciais.

3. Selecione uma destas opções e siga as instruções para criar uma conexão:

   • Usar um e-mail pessoal para se cadastrar e fazer login usando o ID do builder AWS: cria um novo ID do builder AWS para uso pessoal. Essa opção é compatível apenas com uso de serviços exclusivos do ID do builder AWS, como o CodeCatalyst.

   • Conectar-se usando o Centro de Identidade do AWS IAMAWS: permite fazer login no portal de acesso do IAM de sua empresa. Essa opção está disponível apenas por meio de uma empresa que tenha acesso ao Centro de Identidade do IAM. Os recursos e serviços da AWS acessíveis nessa conta são gerenciados pela empresa proprietária da conta.

   • Usar as credenciais do IAM: permite trabalhar usando serviços e recursos do kit de ferramentas da AWS para VS Code. O uso dessa opção por si só não é compatível com o uso de serviços exclusivos do ID do builder AWS, como o CodeCatalyst.

4. Depois que as credenciais do IAM forem conectadas com êxito ao kit de ferramentas para VS Code no Ambiente de Desenvolvimento, o AWS Explorer será atualizado com serviços e recursos da AWS.

Trabalhar com o kit de ferramentas para VS Code em Ambientes de Desenvolvimento

Depois de abrir ou criar um Ambiente de Desenvolvimento no VS Code, você poderá trabalhar usando o kit de ferramentas para VS Code, da mesma forma que faria em uma instância local do VS Code. Os Ambientes de Desenvolvimento que executam o VS Code são configurados para instalar automaticamente o kit de ferramentas da AWS e conectar-se ao ID do builder AWS.

Interromper um ambiente de desenvolvimento

Para interromper o Ambiente de Desenvolvimento atual:

1. No kit de ferramentas para VS Code, expanda o explorador de FERRAMENTAS DO DESENVOLVEDOR.

2. Expanda o CodeCatalyst e selecione Interromper o Ambiente de Desenvolvimento.

3. Quando solicitado pelo VS Code, confirme que você deseja interromper o Ambiente de Desenvolvimento. Quando o Ambiente de Desenvolvimento for interrompido com êxito, o VS Code fechará a conexão remota e retornará para uma instância de desenvolvimento local.

Abrir as configurações do ambiente de desenvolvimento

Para abrir as configurações do Ambiente de Desenvolvimento atual:

1. No kit de ferramentas para VS Code, expanda o explorador de FERRAMENTAS DO DESENVOLVEDOR.

2. Expanda o CodeCatalyst e selecione Abrir configurações para exibir as Configurações do Ambiente de Desenvolvimento do Ambiente de Desenvolvimento atual.

3. Na visualização Configurações do Ambiente de Desenvolvimento, as seções a seguir contêm opções para o Ambiente de Desenvolvimento:

   • Alias: visualize e altere o alias atribuído ao Ambiente de Desenvolvimento.

   • Status: veja o status atual do Ambiente de Desenvolvimento e o projeto ao qual ele está atribuído e interrompa o ambiente.

   • Devfile: veja o nome e a localização do Devfile para o Ambiente de Desenvolvimento. Para abrir o Devfile, selecione o botão Abrir no editor.

   • Configurações de computação: altere o tamanho e a duração do tempo limite padrão para o Ambiente de Desenvolvimento.

   nota

   Não é possível alterar a quantidade de espaço de armazenamento atribuída ao Ambiente de Desenvolvimento depois que ele é criado.

Configurar o Ambiente de Desenvolvimento

Para abrir o Ambiente de Desenvolvimento devfile e configurar o Ambiente de Desenvolvimento atual, siga as etapas abaixo. Para obter informações mais detalhadas sobre a edição de devfiles, consulte os recursos relacionados na seção Configurar o Ambiente de Desenvolvimento com devfiles deste guia.

1. No kit de ferramentas para VS Code, expanda o explorador de FERRAMENTAS DO DESENVOLVEDOR.

2. Expanda o CodeCatalyst e selecione Abrir devfile para abrir o devfile.yaml em uma nova janela do editor, dentro do Ambiente de Desenvolvimento atual.