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 for Visual Studio 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 Conceitos básicos, você pode concluir as ações a seguir.

  • 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 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, então você pode se inscrever para 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.

Abrir a guia Conceitos básicos 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:

  • 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 sobre os 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 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 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 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 fornecidos 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 Sign in no quadro Amazon Q para navegar até a tela Configurar autenticação para Amazon Q.

  2. Na tela Configurar autenticação para o Amazon Q, navegue até 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 Builder ID
nota

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

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

  2. Na tela Configurar autenticação para o Amazon Q, navegue até 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, 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 ao seu AWS Builder ID quando o processo é 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 do AWS kit de ferramentas é carregada automaticamente na guia Introdução ao kit de AWS ferramentas. Para continuar, você deve se autenticar usando suas credenciais do Centro de Identidade do AWS IAM ou suas 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: credenciais de longo prazo no guia de referência de ferramentas 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 Sign in 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 IAM Identity Center (sucessor do Single 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 Sign in 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 Função 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 suas 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 do IAM User Role, você pode acessar o AWS Explorer no Toolkit for 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ços e recursos. Essas referências só são visíveis quando pelo menos um recurso foi habilitado.