View a markdown version of this page

Conectando-se a AWS - AWS Kit de ferramentas com Amazon Q
Pré-requisitosConectando-se a AWS do kit de ferramentasAmazon Q DeveloperAWS Kit de ferramentasDocumentaçã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 for Visual Studio with Amazon Q. Na primeira vez que você inicia o Visual Studio depois de instalar a extensão, um Guia de introdução é exibido na janela do editor. Você pode concluir as seguintes ações na guia Conceitos básicos.

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

  • Adicionar e se autenticar com novas credenciais.

  • Autenticar-se com as credenciais existentes.

  • Acessar a documentação e os tutoriais para ajudar você a começar a usar o Amazon Q e o kit de ferramentas da AWS .

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 uma autenticação por meio de outra AWS ferramenta ou serviço (como o AWS Command Line Interface), o AWS Toolkit detectará automaticamente suas credenciais. Se você é novo AWS ou não criou uma conta, 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 do kit de ferramentas

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

Abrindo o Conceitos básicos guia 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 Conceitos básicos, há duas seções principais:

  • Recursos: 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 sobre os recursos habilitados.

    nota

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

Amazon Q Developer

Na seção Amazon Q da guia Conceitos básicos, você pode habilitar ou desabilitar o Amazon Q, adicionar uma nova conexão ou mudar para outra conexão da AWS . Antes que você possa visualizar ou acessar qualquer uma dessas ações, o Amazon Q deve ser habilitado. Para habilitar o Amazon Q, clique no botão Habilitar.

Quando o Amazon Q é desabilitado, todos os recursos e funções do Amazon Q são completamente removidos do Visual Studio. A habilitação do Amazon Q abre automaticamente a tela Configurar autenticação para o Amazon Q na guia Conceitos básicos. Para continuar, você deve se autenticar com suas Centro de Identidade do AWS IAM credenciais para acessar o Nível Profissional ou sua ID de AWS Construtor para acessar o Nível Gratuito. Para saber mais detalhes sobre cada uma das opções de nível, consulte o tópico Noções básicas dos níveis de serviço do Amazon Q Developer no Guia do usuário do Amazon Q Developer.

Para continuar, execute um dos procedimentos a seguir.

Autenticação no nível profissional com o Centro de Identidade do IAM
nota

Os campos Nome do perfil, URL inicial, Região do perfil ou Região do SSO necessários para autenticação no nível profissional geralmente são informados por um administrador da sua empresa ou organização. Para obter informações detalhadas sobre as credenciais do Centro de Identidade do IAM, consulte o tópico O que é o Centro de Identidade do IAM? no Guia do usuário do Centro de Identidade do AWS IAM.

  1. Na tela Getting Started: AWS Toolkit with Amazon Q, escolha o botão Fazer login no quadro Amazon Q para navegar até a tela Configurar autenticação para o Amazon Q.

  2. Na tela Configurar autenticação para o Amazon Q, acesse a seção Nível profissional, preencha os campos obrigatórios e clique no botão Conectar.

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

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

  5. Na guia Conceitos básicos, o Amazon Q é atualizado para mostrar que você se conectou com o Centro de Identidade do IAM quando o processo é concluído.

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

Para obter detalhes adicionais sobre o AWS Builder ID, consulte o tópico Fazer login com o AWS Builder ID no Guia AWS Sign-in do usuário.

  1. Na tela Getting Started: AWS Toolkit with Amazon Q, escolha o botão Fazer login no quadro Amazon Q para navegar até a tela Configurar autenticação para o Amazon Q.

  2. Na tela Configurar autenticação para o Amazon Q, acesse a seção Nível gratuito e clique no botão Inscrever-se ou iniciar sessão.

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

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

  5. Na guia Getting Started, o Amazon Q é atualizado para mostrar que você está conectado à sua ID do AWS Builder quando o processo for concluído.

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

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

  • Desabilitar o Amazon Q: desabilita 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 para o AWS kit de ferramentas é carregada automaticamente na guia Introdução ao kit de AWS ferramentas. Para continuar, você deve se autenticar usando as credenciais do Centro de Identidade do AWS IAM ou as credenciais do Perfil de usuário do IAM.

nota

Para obter informações detalhadas sobre as credenciais do Centro de Identidade do IAM, consulte o tópico O que é o Centro de Identidade do IAM? no Guia do usuário do Centro de Identidade do AWS IAM. Para obter informações detalhadas sobre as credenciais da função de usuário do IAM, consulte o tópico Chaves de AWS acesso: Long-term credenciais no guia de referência de AWS SDKs e ferramentas.

Fazer a autenticação e conectar-se com o Centro de Identidade do IAM

  1. Na tela Getting Started: AWS Toolkit with Amazon Q, escolha o botão Login no quadro AWS Toolkit para navegar até a tela Configurar autenticação para o AWS Toolkit.

  2. Na tela Configurar autenticação para AWS kit de ferramentas, escolha IAM Identity Center (sucessor de único Sign-on) no menu suspenso Tipo de perfil.

  3. No menu suspenso Escolher um perfil existente ou adicionar novo, escolha um perfil existente ou selecione Adicionar novo perfil para adicionar as informações do novo perfil.

    nota

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

  4. No campo Nome do perfil, insira o profile name associado à conta do Centro de Identidade do IAM com a qual você deseja se autenticar.

  5. No campo de texto URL inicial, insira o Start URL que está anexado às suas credenciais do Centro de Identidade IAM.

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

  7. No menu suspenso Região do SSO (padrão: us-east-1), escolha a Região do SSO definida pelas suas credenciais do Centro de Identidade do IAM.

  8. Clique no botão Conectar para abrir o site de Solicitação de autorização da AWS em seu navegador da web padrão.

  9. Siga as instruções no navegador da web padrão. Você receberá a notificação de que é seguro fechar o navegador e retornar ao Visual Studio quando o processo for concluído.

  10. Na guia Conceitos básicos, a seção Kit de ferramentas da AWS é atualizada para mostrar que você se conectou com o Centro de Identidade do IAM quando o processo é concluído.

Autenticar-se e conectar-se com credenciais do perfil de usuário do IAM

  1. Na tela Getting Started: AWS Toolkit with Amazon Q, escolha o botão Login no quadro AWS Toolkit para navegar até a tela Configurar autenticação para o AWS Toolkit.

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

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

    nota

    Se escolher um nome de perfil existente na lista, vá para a Etapa 8.

  4. No campo de texto Nome do perfil, insira um nome para o novo perfil.

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

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

  7. No menu suspenso Local de armazenamento (padrão: arquivo de credenciais compartilhadas), especifique se deseja armazenar as credenciais em um arquivo de Credenciais compartilhadas ou no Armazenamento criptografado .NET.

  8. Nos menus suspensos Região do perfil (padrão: us-east-1), escolha a Partição e a Região do perfil que estão anexadas ao perfil com o qual deseja se autenticar.

  9. Escolha o botão Conectar para adicionar esse perfil ao seu local de AWS armazenamento com AWS o qual and/or se autenticar.

  10. Na guia Conceitos básicos, a seção Kit de ferramentas da AWS é atualizada para mostrar que você se conectou com suas credenciais do perfil de usuário do IAM quando o processo é concluído.

Depois de se autenticar com suas credenciais do IAM Identity Center ou da função de usuário do IAM, você pode acessar o AWS Explorer no kit de ferramentas do Visual Studio. Além disso, você pode Sair e Desabilitar o kit de ferramentas da AWS para Visual Studio com Amazon Q na guia Conceitos básicos.

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ço e recursos. Essas referências são visíveis somente quando pelo menos um recurso foi habilitado.