# Como trabalhar com o Amazon CodeCatalyst no JetBrains Gateway
<a name="codecatalyst-overview"></a>

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](https://docs.aws.amazon.com/codecatalyst/latest/userguide/codecatalyst/latest/userguide/devenvironment.html) 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.

**Topics**
+ [Como abrir um ambiente de desenvolvimento](#codecatalyst-overview-open)
+ [Criar um ambiente de desenvolvimento](#codecatalyst-overview-creating)
+ [Como criar um ambiente de desenvolvimento em um repositório de terceiros](#codecatalyst-overview-creating-source-repo)
+ [Como configurar as definições do ambiente de desenvolvimento](#codecatalyst-overview-configure)
+ [Como pausar um ambiente de desenvolvimento](#codecatalyst-overview-pause)
+ [Retomar um ambiente de desenvolvimento](#codecatalyst-overview-resume)
+ [Excluir um ambiente de desenvolvimento](#codecatalyst-overview-delete)
+ [Como configurar os padrões do ambiente de desenvolvimento](#codecatalyst-overview-default)

## Como abrir um ambiente de desenvolvimento
<a name="codecatalyst-overview-open"></a>

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

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

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

1. 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
<a name="codecatalyst-overview-creating"></a>

Para criar um novo ambiente de desenvolvimento:

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

1. 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**.

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

1. 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
<a name="codecatalyst-overview-creating-source-repo"></a>

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](https://docs.aws.amazon.com/codecatalyst/latest/userguide/source-repositories-link.html) no *Guia do usuário do Amazon CodeCatalyst*.

## Como configurar as definições do ambiente de desenvolvimento
<a name="codecatalyst-overview-configure"></a>

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

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

1. 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:**.

1. 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 name="codecatalyst-overview-pause"></a>

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

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

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

1. 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 name="codecatalyst-overview-resume"></a>

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

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

1. 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
<a name="codecatalyst-overview-delete"></a>

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

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

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

1. 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**.

1. 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
<a name="codecatalyst-overview-default"></a>

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](https://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**.

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

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

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

1. 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**.