Conectando-se a AWS - AWS Kit de ferramentas com Amazon Q
Pré-requisitosConectando-se a AWS partir do kit de ferramentasAmazon Q DeveloperAWS Kit de ferramentas Documentação e tutoriais

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

Conectando-se a AWS

As seções a seguir descrevem como começar a usar o AWS Toolkit com o Amazon Q. Na primeira vez que você inicia o Visual Studio depois de instalar a extensão, uma Introdução é exibida na janela do editor. Na guia Introdução, você pode concluir as seguintes ações.

  • Ative ou desative o Amazon Q e o AWS Toolkit.

  • Adicione e autentique com novas credenciais.

  • Autentique-se com as credenciais existentes.

  • Acesse a documentação e os tutoriais para ajudar você a começar a trabalhar com o Amazon Q e o AWS Toolkit.

Pré-requisitos

Para começar a trabalhar com o Amazon Q e o AWS Toolkit, você precisa se autenticar com AWS credenciais. Se você já configurou uma AWS conta e autenticação por meio de outra AWS ferramenta ou serviço (como o AWS Command Line Interface), o AWS Toolkit detecta automaticamente suas credenciais. Se você é novo AWS ou não criou uma conta, você pode se inscrever em uma AWS conta no portal de AWS inscrição. Para obter informações detalhadas sobre como configurar uma nova AWS conta, consulte o tópico Visão geral no Guia do usuário de AWS configuração.

Conectando-se a AWS partir do kit de ferramentas

Para se conectar às suas AWS contas a partir do AWS Kit de ferramentas, abra a guia Introdução a qualquer momento preenchendo o seguinte.

Abrindo a guia Introdução no Visual Studio

  1. No Visual Studio, expanda Extensões no menu principal e, em seguida, expanda o submenu AWS Toolkit.

  2. Escolha Conceitos básicos.

  3. A guia Introdução é aberta na janela do editor do Visual Studio.

Na guia Introdução, há duas seções principais:

  • Funcionalidades: Nesta seção, você pode ativar ou desativar recursos como o Amazon Q e o AWS Toolkit.

  • Documentação e tutoriais: uma coleção de referências aos seus recursos habilitados.

    nota

    A seção Documentação e tutoriais só fica visível quando um ou mais recursos estão habilitados.

Amazon Q Developer

Na seção Amazon Q na guia Getting Started, você pode ativar ou desativar o Amazon Q, adicionar uma nova conexão ou mudar para uma AWS conexão diferente. Antes que você possa visualizar ou acessar qualquer uma dessas ações, o Amazon Q deve estar ativado. Para ativar o Amazon Q, clique no botão Ativar.

Quando o Amazon Q é desativado, todos os recursos e funções do Amazon Q são completamente removidos do Visual Studio. A ativação do Amazon Q abre automaticamente a autenticação de configuração do Amazon Q na guia Getting Started. Para continuar, você deve se autenticar com suas AWS IAM Identity Center credenciais para acessar o Nível Profissional ou seu ID do AWS Construtor para acessar o Nível Gratuito. Para obter informações detalhadas sobre cada uma das opções de nível, consulte o tópico Entendendo os níveis de serviço para o Amazon Q Developer no Guia do usuário do Amazon Q Developer.

Para continuar, conclua um dos procedimentos a seguir.

Autenticação de nível profissional com o IAM Identity Center
nota

Os campos Nome do PerfilURL, Início, Região do Perfil ou SSORegião que são necessários para autenticação com o nível Profissional são normalmente fornecidos por um administrador da sua empresa ou organização. Para obter informações detalhadas sobre as credenciais do IAM Identity Center, consulte o tópico O que é o IAM Identity Center no Guia do usuário do AWS IAMIdentity Center.

  1. Na seção Nível Profissional, preencha os campos obrigatórios e escolha o botão Conectar.

  2. Confirme que você deseja abrir o portal AWS de solicitação de autorização em seu navegador padrão.

  3. Conclua as etapas exigidas pelo portal de solicitação de AWS autorização, você será notificado quando for seguro fechar o navegador e retornar ao Visual Studio

  4. Na guia Getting Started, o Amazon Q é atualizado para mostrar que você está conectado ao IAM Identity Center quando o processo é concluído.

Autenticação de nível gratuito com AWS Builder ID
nota

Para obter detalhes adicionais sobre o AWS Builder ID, consulte o tópico Entrar com AWS Builder ID no Guia do usuário AWS de login.

  1. Na seção Nível gratuito, escolha o botão Inscrever-se ou Entrar.

  2. Confirme que você deseja abrir o portal AWS de solicitação de autorização em seu navegador padrão.

  3. Conclua as etapas exigidas pelo portal de solicitação de AWS autorização, você será notificado quando for seguro fechar o navegador e retornar ao Visual Studio.

  4. Na guia Getting Started, o Amazon Q é atualizado para mostrar que você está conectado ao seu AWS Builder ID quando o processo é concluído.

Depois de se autenticar com suas credenciais do IAM Identity Center ou do AWS Builder ID, você pode acessar o Amazon Q no Visual Studio. Além disso, você pode realizar as seguintes ações na guia Introdução:

  • Sair: desconecta sua conexão de credencial atual de todas as funções do Amazon Q. O Amazon Q continua ativado, mas a maioria dos recursos não funciona.

  • Desativar o Amazon Q: desativa completamente todos os recursos do Amazon Q no Visual Studio.

AWS Kit de ferramentas

Na seção AWS Kit de ferramentas na guia Introdução ao AWS kit de ferramentas, você pode ativar ou desativar o AWS kit de ferramentas, adicionar uma nova conexão ou alternar para uma conexão diferente. AWS Antes que você possa visualizar ou acessar qualquer uma dessas ações, o AWS Toolkit deve estar ativado. Para ativar o AWS kit de ferramentas, clique no botão Ativar.

Quando o AWS kit de ferramentas está ativado, a autenticação de configuração do AWS kit de ferramentas é carregada automaticamente na guia Introdução ao kit de AWS ferramentas. Para continuar, você deve se autenticar com suas credenciais ou com suas AWS IAM Identity Centercredenciais de função de IAM usuário.

nota

Para obter informações detalhadas sobre as credenciais do IAM Identity Center, consulte o tópico O que é o IAM Identity Center no Guia do usuário do AWS IAMIdentity Center. Para obter informações detalhadas sobre as credenciais da função de IAM usuário, consulte o tópico Chaves de AWS acesso: credenciais de longo prazo no guia de referência de ferramentas AWS SDKs e ferramentas.

Autentique e conecte-se com o IAM Identity Center

  1. Na tela Configurar autenticação do AWS kit de ferramentas, escolha IAMIdentity Center (sucessor do login único) no menu suspenso Tipo de perfil.

  2. No menu suspenso Escolher de um perfil existente ou adicionar novo, escolha um perfil existente ou selecione Adicionar novo perfil para adicionar novas informações de perfil.

    nota

    Se você escolher um perfil existente, vá para a etapa 7.

  3. No campo Nome do perfil, insira o profile name associado à conta do IAM Identity Center com a qual você deseja se autenticar.

  4. No campo de URL texto Iniciar, insira o Start URL que está anexado às suas credenciais do IAM Identity Center.

  5. No menu suspenso Região do perfil (o padrão é us-east-1), escolha a região do perfil definida pelo perfil de usuário do IAM Identity Center com o qual você está se autenticando.

  6. No menu suspenso SSORegião (o padrão é us-east-1), escolha a SSOregião definida pelas suas credenciais do Identity Center. IAM

  7. Escolha o botão Conectar para abrir o site AWS de solicitação de autorização em seu navegador padrão.

  8. Siga as instruções em seu navegador da Web padrão, você será notificado quando o processo de autorização for concluído, é seguro fechar o navegador e retornar ao Visual Studio.

  9. Na guia Introdução, a seção AWS Kit de ferramentas é atualizada para mostrar que você está conectado ao IAM Identity Center quando o processo é concluído.

Autentique e conecte-se com as credenciais da função de IAM usuário

  1. Na tela Configurar autenticação para o AWS kit de ferramentas, escolha Função IAM do usuário no menu suspenso Tipo de perfil.

  2. No menu suspenso Escolher de um perfil existente ou adicionar novo, escolha. Add new profile

    nota

    Se você estiver escolhendo um nome de perfil existente na lista, vá para a Etapa 8.

  3. No campo de texto Nome do perfil, insira um nome para seu novo perfil.

  4. No campo de texto ID da chave de acesso, insira o Access Key ID do perfil com o qual você deseja se autenticar.

  5. No campo de texto Chave secreta, insira o Secret Key do perfil com o qual você deseja se autenticar.

  6. No menu suspenso Local de armazenamento (o padrão é Arquivo de Credenciais Compartilhado), especifique se você deseja armazenar suas credenciais com um arquivo de Credenciais Compartilhadas ou com. NETLoja criptografada.

  7. Nos menus suspensos Região do perfil (o padrão é us-east-1), escolha a partição e a região do perfil que estão anexadas ao perfil com o qual você deseja se autenticar.

  8. Escolha o botão Conectar para adicionar esse perfil ao seu local AWS de armazenamento e/ou autenticar com AWS.

  9. Na guia Introdução, a seção AWS Kit de ferramentas é atualizada para mostrar que você está conectado às suas credenciais de função de IAM usuário quando o processo é concluído.

Depois de se autenticar com suas credenciais do IAM Identity Center ou IAM do User Role, você pode acessar o AWS Explorer no Toolkit for Visual Studio. Além disso, você pode sair e desativar o AWS kit de ferramentas com o Amazon Q na guia Getting Started.

Documentação e tutoriais

A seção de documentação e tutoriais é atualizada automaticamente com sugestões de documentação e tutoriais com base em suas preferências AWS de serviços e recursos. Essas referências só são visíveis quando pelo menos um recurso foi ativado.