# Conceitos básicos do CodeCatalyst e do AWS Toolkit for JetBrains
<a name="codecatalyst-setup"></a>

Para começar a trabalhar com o CodeCatalyst no JetBrains Gateway, conclua os procedimentos a seguir.

**Topics**
+ [Como instalar o JetBrains Gateway](#codecatalyst-setup-jbgateway)
+ [Como instalar o kit de ferramentas da AWS para JetBrains Gateway](#codecatalyst-setup-toolkit)
+ [Como criar uma conta do CodeCatalyst e um ID do AWS Builder](#codecatalyst-setup-id)
+ [Como conectar o JetBrains Gateway ao CodeCatalyst](#codecatalyst-setup-connect)

## Como instalar o JetBrains Gateway
<a name="codecatalyst-setup-jbgateway"></a>

Antes de integrar o kit de ferramentas da AWS às suas contas do CodeCatalyst, verifique se você está usando um versionamento atual do JetBrains Gateway. Para baixar o versionamento mais recente do JetBrains Gateway, escolha a distribuição do JetBrains Gateway que você deseja nos links a seguir:
+ [JetBrains Gateway para Linux](https://download.jetbrains.com/product?code=GW&latest&distribution=linux)
+ [JetBrains Gateway para Windows]( https://download.jetbrains.com/product?code=GW&latest&distribution=windows)
+ [JetBrains Gateway para macOS](https://download.jetbrains.com/product?code=GW&latest&distribution=mac)
+ [JetBrains Gateway para macOS Apple Silicon](https://download.jetbrains.com/product?code=GW&latest&distribution=macM1)

## Como instalar o kit de ferramentas da AWS para JetBrains Gateway
<a name="codecatalyst-setup-toolkit"></a>

Para conectar o JetBrains à sua conta do CodeCatalyst, você deve instalar o versionamento mais recente da extensão do kit de ferramentas. Você pode encontrar o versionamento mais recente e concluir a instalação do kit de ferramentas diretamente do **Marketplace de plug-ins** do JetBrains. 

Para instalar o plug-in do kit de ferramentas da AWS por meio do **Marketplace de plug-ins** do JetBrains, conclua as seguintes etapas:

1. Na tela principal do JetBrains Gateway, escolha o ícone **Configurações ou preferências**, localizado no canto inferior esquerdo da aplicação. 

1. Escolha **Configurações ou preferências** para abrir a visualização **Configurações ou preferências**. 

1. Na visualização **Configurações ou preferências**, escolha **Plug-ins** para abrir a visualização **Plug-ins**.
**nota**  
A visualização **Plug-ins** pode abrir na visualização do **Marketplace** ou em **Instalado**.   
Se esta for a primeira vez que você instala o kit de ferramentas da AWS para JetBrains Gateway, selecione a visualização **Marketplace de plug-ins** para continuar.
Se você tiver um versionamento anterior do kit de ferramentas da AWS para JetBrains Gateway, atualize-o na visualização **Instalado**.

1. Na visualização do **Marketplace**, insira o texto `AWS Toolkit` e escolha a entrada do plug-in do **kit de ferramentas da AWS** quando ela aparecer.

1. Escolha **Instalar** para baixar e instalar o **kit de ferramentas da AWS para JetBrains Gateway **.
**nota**  
O JetBrains Gateway exibe o status do progresso do download e da instalação. Depois que o kit de ferramentas for instalado com sucesso, o explorador **Conexões** do JetBrains Gateway se atualiza com o ícone de plug-in do **Amazon CodeCatalyst**.

## Como criar uma conta do CodeCatalyst e um ID do AWS Builder
<a name="codecatalyst-setup-id"></a>

Além de instalar o versionamento mais recente do AWS Toolkit for JetBrains, você deve ter um ID do AWS Builder e uma conta do CodeCatalyst ativos para se conectar ao JetBrains Gateway. Se você não tiver um ID do AWS Builder ou uma conta do CodeCatalyst ativos, consulte a seção [Setting up with CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) no Guia do usuário do *CodeCatalyst*.

**nota**  
Um ID do AWS Builder é diferente das suas credenciais da AWS. AWS As credenciais são necessárias para a maioria dos Serviços da AWS acessíveis no kit de ferramentas da AWS. Um ID do AWS Builder é necessário para criar uma nova conta do CodeCatalyst e trabalhar em uma conta existente do CodeCatalyst. Isso inclui trabalhar com todos os atributos do CodeCatalyst disponíveis no kit de ferramentas da AWS.

## Como conectar o JetBrains Gateway ao CodeCatalyst
<a name="codecatalyst-setup-connect"></a>

Para conectar o JetBrains Gateway à sua conta do CodeCatalyst, conclua as etapas a seguir.

1. No explorador **Conexões** do JetBrains Gateway, escolha o plug-in **Amazon CodeCatalyst** para abrir a visualização do plug-in **Amazon CodeCatalyst**.

1. Na visualização do plugin **CodeCatalyst**, escolha **Fazer login com ID do AWS Builder** para abrir o prompt **Login da AWS obrigatório**.

1. No prompt **Login da AWS obrigatório**, escolha **Abrir o navegador** para abrir a tela de login do console do CodeCatalyst em seu navegador de preferência.

1. Insira seu ID do AWS Builder no campo fornecido e siga as instruções para continuar.

1. Quando solicitado, escolha **Permitir** para confirmar a conexão entre o JetBrains e sua conta do CodeCatalyst. Quando o processo de conexão estiver concluído, o CodeCatalyst exibirá uma confirmação indicando que é seguro fechar o navegador.

1. No JetBrains Gateway, a visualização do plug-in **CodeCatalyst** é atualizada para a visualização **Ambientes de desenvolvimento**.