

 AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

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

# Trabalhando com o AWS Toolkit
<a name="toolkit-welcome"></a>

Você pode navegar e interagir Serviços da AWS usando o AWS Toolkit por meio da janela do AWS Explorer.

## Por que usar o AWS kit de ferramentas?
<a name="toolkit-why"></a>

O AWS Toolkit é uma extensão para o ambiente de desenvolvimento AWS Cloud9 integrado (IDE). Você pode acessar e trabalhar com uma ampla variedade de Serviços da AWS por meio dessa extensão. O AWS kit de ferramentas substitui a funcionalidade fornecida pelo plug-in Lambda para. AWS Cloud9 Para obter mais informações, consulte [Desativando AWS o kit de ferramentas](#disable-toolkit).

**Importante**  
AWS O suporte do kit de ferramentas é um recurso integrado do. AWS Cloud9 Atualmente, você não pode personalizar o AWS Cloud9 IDE com extensões de terceiros.

**Atenção**  
Se você estiver usando o Mozilla Firefox como seu navegador preferido com AWS Cloud9 IDE, há uma configuração de cookie de terceiros que impede que o AWS Cloud9 webview e os AWS kits de ferramentas funcionem corretamente no navegador. Como solução alternativa para esse problema, você deve garantir que não tenha bloqueado *os cookies* na seção *Privacidade e Segurança* das configurações do seu navegador, conforme exibido na imagem abaixo.  

![Exibir as configurações de cookies para o Firefox](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/firefox-workaround.png)


No momento, o seguinte Serviços da AWS e os recursos podem ser acessados por meio da extensão AWS Toolkit:
+ [AWS Executor de aplicativos](using-apprunner.md)
+ [API Gateway](api-gateway-toolkit.md)
+ [CloudFormation pilhas](cloudformation-toolkit.md)
+ [CloudWatch Logs](cloudwatch-logs-toolkit.md)
+ [AWS Lambda](lambda-toolkit.md)
+ [Recursos](more-resources.md)
+ [Buckets e objetos do Amazon S3](s3-toolkit.md)
+ [AWS Serverless Application Model applications](serverless-apps-toolkit.md)
+ [Step Functions e máquinas de estado](bulding-stepfunctions.md)
+ [Documentos de automação do Systems Manager](systems-manager-automation-docs.md)
+ [Trabalhando com o Amazon ECR no IDE AWS Cloud9](ecr.md)
+ [AWS IoT](iot-start.md)
+ [Como trabalhar com o Amazon Elastic Container Service](ecs.md)
+ [Amazon EventBridge](eventbridge.md)
+ [Trabalhando com AWS Cloud Development Kit (AWS CDK)](cdk-explorer.md)

## Habilitando o AWS kit de ferramentas
<a name="access-toolkit"></a>

Se o AWS kit de ferramentas não estiver disponível em seu ambiente, você poderá ativá-lo na guia **Preferências**.<a name="enabling-toolkit"></a>

**Para ativar o AWS kit de ferramentas**

1. Selecione **AWS Cloud9**, **Preferences** (Preferências) na barra de menu. 

1. Na guia **Preferences** (Preferências), no painel de navegação lateral, escolha **AWS Settings** (Configurações da ). 

1. No painel **Recursos da AWS **, habilite o **Kit de ferramentas da AWS **, de modo que ele exiba uma marca de seleção em um fundo verde. 

   Quando você ativa o AWS Toolkit, o ambiente de desenvolvimento integrado (IDE) é atualizado para mostrar a configuração atualizada de **Ativar kit de AWS ferramentas**. A opção Kit de ferramentas da AWS ao lado do IDE abaixo da opção **Ambiente** também aparece.

**Importante**  
Se a instância EC2 do seu AWS Cloud9 ambiente não tiver acesso à Internet (ou seja, não for permitido tráfego de saída), uma mensagem poderá ser exibida após você habilitar o AWS Toolkit e reiniciar o IDE. Esta mensagem indica que as dependências exigidas pelo Kit de ferramentas da AWS não puderam ser baixadas. Se for esse o caso, você também não poderá usar o AWS Toolkit.   
Para corrigir esse problema, crie um endpoint da VPC para o Amazon S3. Isso concede acesso a um bucket do Amazon S3 em seu Região da AWS que contém as dependências necessárias para manter seu IDE atualizado.  
Para obter mais informações, consulte [Configurar endpoints de VPC para o Amazon S3 para baixar as dependências](ec2-ssm.md#configure-s3-endpoint).



## Gerenciando credenciais de acesso para AWS o Toolkit
<a name="credentials-for-toolkit"></a>

AWS O kit de ferramentas interage com uma ampla variedade de. Serviços da AWS Para gerenciar o controle de acesso, certifique-se de que a entidade do IAM do seu serviço AWS Toolkit tenha as permissões necessárias para essa variedade de serviços. Para começar rapidamente, use [ credenciais temporárias gerenciadas pela AWS](security-iam.md#auth-and-access-control-temporary-managed-credentials) para obter a permissão necessária. Essas credenciais gerenciadas funcionam concedendo acesso ao seu ambiente EC2 Serviços da AWS em nome de uma AWS entidade, como um usuário do IAM.

No entanto, se você lançou a instância EC2 do seu ambiente de desenvolvimento em uma **sub-rede privada**, as credenciais temporárias AWS gerenciadas não estão disponíveis para você. Portanto, como alternativa, você pode permitir que o AWS Toolkit acesse o seu Serviços da AWS criando manualmente seu próprio conjunto de credenciais. Esse conjunto é chamado de *perfil*. Os perfis apresentam credenciais de longo prazo chamadas chaves de acesso. É possível obter essas chaves de acesso no console do IAM.<a name="manual-credentials"></a>

**Crie um perfil para fornecer credencial de acesso ao Toolkit AWS**

1. Para obter suas chaves de acesso (consistindo em um *ID de chave de acesso* e uma *chave de acesso secreta*), acesse o console do IAM em [ https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam).

1. Selecione **Users** (Usuários) na barra de navegação e escolha o nome do usuário da AWS (não a caixa de seleção).

1. Escolha a guia **Security Credentials** (Credenciais de segurança) e selecione **Create access key** (Criar chave de acesso).
**nota**  
Se já tiver uma chave de acesso, mas não conseguir acessar a chave secreta, torne a chave antiga inativa e crie uma nova.

1. Na caixa de diálogo que mostra o ID da chave de acesso e a chave de acesso secreta, escolha **Download .csv file** (Baixar o arquivo.csv) para armazenar essas informações em um lugar seguro.

1. Depois de baixar suas chaves de acesso, inicie um AWS Cloud9 ambiente e inicie uma sessão de terminal escolhendo **Janela**, **Novo Terminal**. 

1. Na janela do terminal, execute o comando a seguir.

   ```
   aws configure --profile toolkituser
   ```

   Neste caso, `toolkituser` é o nome do perfil que está sendo usado, mas você pode escolher o seu.

1. Na linha de comando, insira o `AWS Access Key ID`e `AWS Secret Access Key` que você baixou anteriormente do console do IAM.
   + Para`Default region name`, especifique um Região da AWS (por exemplo,`us-east-1`). 
   + Para `Default output format`, especifique um formato de arquivo (por exemplo, `json`). 
**nota**  
Para obter informações sobre as opções de configuração de um perfil, consulte [Conceitos básicos](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) no *Guia do usuário da AWS Command Line Interface *.

1. Depois de criar seu perfil, inicie o AWS Toolkit, acesse o [**menu AWS Toolkit**](toolkit-navigation.md#toolkit-menu) e escolha **Connect** to. AWS

1. No campo **Selecionar um perfil de AWS credencial**, escolha o perfil que você acabou de criar no terminal (por exemplo,`profile:toolkituser`).

Se o perfil selecionado contiver credenciais de acesso válidas, o painel **AWS Explorer** será atualizado para exibir as Serviços da AWS que você pode acessar agora.

### Usar uma função do IAM para conceder permissões às aplicações em execução nas instâncias do EC2
<a name="ec2-instance-credentials"></a>

Em vez disso, você pode também usar uma função do IAM para gerenciar as credenciais temporárias para as aplicações que são executadas em uma instância do EC2. A função fornece permissões temporárias que os aplicativos podem usar quando fazem chamadas para outros AWS recursos. Quando você executa uma instância do EC2, você especifica uma função do IAM para associar à instância. As aplicações executadas na instância podem usar as credenciais temporárias fornecidas pela função quando fizerem solicitações da API em relação aos Serviços da AWS.

Depois de criar a função, atribua essa função e sua permissão associada à instância criando um *perfil da instância*. O perfil da instância está associado à ela e pode fornecer as credenciais temporárias da função para uma aplicação que é executada na instância.

Para obter mais informações, consulte [Use um perfil do IAM para conceder permissões a aplicações em execução em instâncias do Amazon EC2](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html#roles-usingrole-ec2instance-get-started) no *Guia do usuário do IAM*.

## Identificação dos AWS componentes do kit de ferramentas
<a name="ui-components"></a>

A captura de tela a seguir mostra três componentes principais da interface do usuário do kit de AWS ferramentas.

![Captura de tela rotulada mostrando os principais componentes da interface do usuário do kit de ferramentas AWS](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/toolkit-UI-overview-labelled.png)


1. AWS Janela **Explorer**: usada para interagir com os Serviços da AWS que podem ser acessados por meio do Toolkit. Você pode alternar entre mostrar e ocultar o **AWS Explorer** usando a AWS opção no lado esquerdo do ambiente de desenvolvimento integrado (IDE). Para obter mais informações sobre como usar esse componente de interface e acessar Serviços da AWS outros Regiões da AWS, consulte[Usando o AWS Explorer para trabalhar com serviços e recursos em várias regiões](toolkit-navigation.md#working-with-aws-explorer).

1. Menu do **kit de ferramentas**: usado para gerenciar conexões AWS, personalizar a exibição da janela do **AWS Explorer**, criar e implantar aplicativos sem servidor, trabalhar com GitHub repositórios e acessar a documentação. Para obter mais informações, consulte [Acessando e usando o menu AWS Toolkit](toolkit-navigation.md#toolkit-menu).

1. AWS Painel **de configuração**: usado para personalizar o comportamento com o Serviços da AWS qual você interage usando o Kit de ferramentas. Para obter mais informações, consulte [Modificando as configurações do AWS kit de ferramentas usando o AWS painel Configuração](toolkit-navigation.md#configuration-options). 

## Desativando AWS o kit de ferramentas
<a name="disable-toolkit"></a>

Você pode desativar o AWS kit de ferramentas na guia **Preferências**.<a name="disabling-toolkit"></a>

**Para desativar o AWS kit de ferramentas**

1. Selecione **AWS Cloud9**, **Preferences** (Preferências) na barra de menu. 

1. Na guia **Preferences** (Preferências), no painel de navegação lateral, escolha **AWS Settings** (Configurações da ). 

1. No painel **AWS Recursos**, desative o Kit de **AWS AWS ferramentas**. 

   **Quando você desativa o AWS Toolkit, o ambiente de desenvolvimento integrado (IDE) é atualizado para remover a opção AWS Toolkit na lateral do IDE abaixo da opção Environment.**



## AWS Tópicos do kit de ferramentas
<a name="toolkit-resources-info"></a>
+ [Navegando e configurando o kit de ferramentas AWS](toolkit-navigation.md)
+ [Usando AWS App Runner com o AWS Toolkit](using-apprunner.md)
+ [Trabalhando com o API Gateway usando o AWS kit de ferramentas](api-gateway-toolkit.md)
+ [Trabalhando com AWS CloudFormation pilhas usando AWS o Toolkit](cloudformation-toolkit.md)
+ [Trabalhando com AWS Lambda funções usando o AWS Toolkit](lambda-toolkit.md)
+ [Trabalhar com recursos](more-resources.md)
+ [Trabalhando com o Amazon S3 usando o Toolkit AWS](s3-toolkit.md)
+ [Trabalhando com AWS SAM o uso do AWS kit de ferramentas](serverless-apps-toolkit.md)
+ [Trabalhando com a Amazon CodeCatalyst](ide-toolkits-cloud9.md)
+ [](ecr.md)