Como trabalhar com o Amazon CodeCatalyst no JetBrains Gateway

Você pode iniciar um ambiente de computação virtual, conhecido como ambiente de desenvolvimento, do JetBrains. Ambientes de desenvolvimento são ambientes personalizáveis de desenvolvimento em nuvem que você pode copiar e compartilhar entre diferentes membros da equipe no seu espaço. Para obter mais informações sobre ambientes de desenvolvimento e como você pode acessá-los no CodeCatalyst, consulte a seção Dev Environments no Guia do usuário do Amazon CodeCatalyst.

As seções a seguir descrevem como criar, abrir e trabalhar com ambientes de desenvolvimento usando o JetBrains Gateway.

Como abrir um ambiente de desenvolvimento

Para abrir um ambiente de desenvolvimento existente usando o JetBrains Gateway, conclua as etapas a seguir.

1. No explorador Conexões, escolha o plug-in Amazon CodeCatalyst.

2. No corpo do assistente Desenvolvimento remoto, navegue até o espaço principal e o projeto do ambiente de desenvolvimento que você deseja abrir.

3. Escolha o ambiente de desenvolvimento que você deseja abrir.

4. Confirme o processo de abertura do seu ambiente de desenvolvimento para continuar.

   nota

   O JetBrains exibe o progresso em uma nova janela de status. Quando o processo de abertura estiver concluído, seu ambiente de desenvolvimento será aberto em uma nova janela.

Criar um ambiente de desenvolvimento

Para criar um novo ambiente de desenvolvimento:

1. No explorador Conexões, escolha o plug-in CodeCatalyst.

2. Na seção de cabeçalho do assistente Desenvolvimento remoto, escolha o link Criar um ambiente de desenvolvimento para abrir a visualização Novo ambiente de desenvolvimento do CodeCatalyst.

3. Na visualização Novo ambiente de desenvolvimento do CodeCatalyst, use os campos a seguir para configurar suas preferências do ambiente de desenvolvimento.

   • IDE: selecione seu IDE do JetBrains de preferência para iniciar em seu ambiente de desenvolvimento.

   • Projeto CodeCatalyst: escolha um espaço e um projeto do CodeCatalyst para seu ambiente de desenvolvimento.

   • Alias do ambiente de desenvolvimento: insira um nome alternativo para seu ambiente de desenvolvimento.

   • Computação: escolha a configuração de hardware virtual para seu ambiente de desenvolvimento.

   • Armazenamento persistente: escolha a quantidade de armazenamento persistente para seu ambiente de desenvolvimento.

   • Tempo limite de inatividade: escolha o tempo de inatividade do sistema a decorrer antes que seu ambiente de desenvolvimento entre em espera.

4. Para escolher seu ambiente de desenvolvimento, escolha Criar ambiente de desenvolvimento.

   nota

   Quando você escolhe Criar um ambiente de desenvolvimento, a visualização Novo ambiente de desenvolvimento é fechada e o processo para criar seu ambiente de desenvolvimento é iniciado. O processo pode levar vários minutos e você não pode usar outros recursos do JetBrains Gateway até que seu ambiente de desenvolvimento seja criado.

   O JetBrains exibe o progresso em uma nova janela de status e, quando o processo é concluído, seu ambiente de desenvolvimento é aberto em uma nova janela.

Como criar um ambiente de desenvolvimento em um repositório de terceiros

Você pode criar ambientes de desenvolvimento em um repositório de terceiros vinculando-se ao repositório como fonte.

A vinculação a um repositório de terceiros como fonte é tratada no nível do projeto no CodeCatalyst. Para obter instruções e detalhes adicionais sobre como conectar um repositório de terceiros ao seu ambiente de desenvolvimento, consulte o tópico Linking a source repository no Guia do usuário do Amazon CodeCatalyst.

Como configurar as definições do ambiente de desenvolvimento

Para alterar as configurações de um ambiente de desenvolvimento existente do JetBrains Gateway, conclua as etapas a seguir.

nota

Não é possível alterar a quantidade de espaço de armazenamento atribuída ao seu ambiente de desenvolvimento após ele ser criado.

1. No explorador Conexões, escolha o plug-in Amazon CodeCatalyst.

2. No corpo do assistente Desenvolvimento remoto, navegue até o espaço principal e o projeto do ambiente de desenvolvimento que você deseja configurar.

3. Escolha o ícone Configurações, ao lado do ambiente de desenvolvimento que você deseja configurar, para abrir as definições Configurar o ambiente de desenvolvimento:.

4. No menu de definições Configurar o ambiente de desenvolvimento:, configure seu ambiente de desenvolvimento alterando as seguintes opções:

   • Alias do ambiente de desenvolvimento: campo opcional para especificar um nome alternativo para seu ambiente de desenvolvimento.

   • IDE: escolha o IDE do JetBrains que você deseja iniciar dentro do seu ambiente de desenvolvimento.

   • Computação: escolha a configuração de hardware virtual para seu ambiente de desenvolvimento.

   • Tempo limite de inatividade: escolha o tempo de inatividade do sistema a decorrer antes que seu ambiente de desenvolvimento entre em espera.

Como pausar um ambiente de desenvolvimento

A atividade no seu ambiente de desenvolvimento é armazenada de forma persistente. Isso significa que você pode pausar e retomar seu ambiente de desenvolvimento sem perder seu trabalho.

Para pausar seu ambiente de desenvolvimento, conclua as etapas a seguir.

1. No explorador Conexões, escolha o plug-in Amazon CodeCatalyst.

2. No corpo do assistente Desenvolvimento remoto, navegue até o espaço principal e o projeto do ambiente de desenvolvimento que você deseja pausar.

3. Escolha o ícone Pausar ao lado do seu ambiente de desenvolvimento ativo para abrir a caixa de diálogo Confirmar a pausa.

4. Escolha Sim para fechar a caixa de diálogo Confirmar a pausa e iniciar o processo de pausa.

   nota

   O JetBrains exibe o progresso do processo de pausa em uma nova janela de status. Quando o ambiente de desenvolvimento for interrompido, o ícone Pausar será removido da interface do usuário.

Retomar um ambiente de desenvolvimento

A atividade no seu ambiente de desenvolvimento é armazenada de forma persistente. Isso significa que você pode retomar um ambiente de desenvolvimento pausado sem perder seu trabalho anterior.

Para retomar um ambiente de desenvolvimento pausado, conclua as etapas a seguir.

1. No explorador Conexões, escolha o plug-in Amazon CodeCatalyst.

2. No corpo do assistente Desenvolvimento remoto, navegue até o espaço principal e o projeto do ambiente de desenvolvimento que você deseja retomar.

3. Escolha o ambiente de desenvolvimento que você deseja retomar.

   nota

   O JetBrains exibe o progresso do processo de retomada em uma nova janela de status. Quando o ambiente de desenvolvimento for retomado, um ícone Pausar será adicionado ao lado do ícone Configurações do ambiente de desenvolvimento.

Excluir um ambiente de desenvolvimento

Para excluir seu ambiente de desenvolvimento, conclua as seguintes etapas:

1. No explorador Conexões, escolha o plug-in Amazon CodeCatalyst.

2. No corpo do assistente Desenvolvimento remoto, navegue até o espaço principal e o projeto do ambiente de desenvolvimento que você deseja excluir.

3. Escolha o botão de ícone X ao lado do seu ambiente de desenvolvimento para abrir a caixa de diálogo Confirmar a exclusão.

4. Escolha Sim para fechar a caixa de diálogo e excluir seu ambiente de desenvolvimento.

   Importante

   Depois de escolher Sim, seu ambiente de desenvolvimento será excluído e não poderá ser recuperado. Antes de excluir um ambiente de desenvolvimento, confirme e envie suas alterações de código para o repositório de origem original. Caso contrário, suas alterações não salvas serão perdidas permanentemente.

   Depois que um ambiente de desenvolvimento for excluído, as atualizações do assistente Desenvolvimento remoto e o ambiente de desenvolvimento não estarão mais listados em seus recursos.

Como configurar os padrões do ambiente de desenvolvimento

Você pode definir as configurações padrão do ambiente de desenvolvimento no devfile do seu ambiente de desenvolvimento. A especificação do devfile é um padrão aberto, que você pode atualizar em um documento YAML.

Para obter mais informações sobre como definir e configurar seu devfile, consulte devfile.io.

Para abrir e editar seu devfile na sua instância do ambiente de desenvolvimento do JetBrains Gateway, conclua as etapas a seguir.

1. Na Barra de navegação no seu ambiente de desenvolvimento ativo do JetBrains, expanda o nó Ambiente de desenvolvimento do Amazon CodeCatalyst para abrir o menu Detalhes do status do back-end.

2. Escolha a aba Configurar o ambiente de desenvolvimento e, em seguida, escolha Abrir Devfile para abrir seu devfile no Editor do JetBrains.

3. Em Editor, faça alterações em seu devfile e salve seu trabalho.

4. Ao salvar suas alterações, o nó Ambiente de desenvolvimento do Amazon CodeCatalyst exibe um alerta indicando que seu ambiente de desenvolvimento requer uma reconstrução.

5. Expanda o nó Ambiente de desenvolvimento do Amazon CodeCatalyst e escolha o nó Reconstruir o ambiente de desenvolvimento na aba Configurar o ambiente de desenvolvimento.