Integrar o Visual Studio ao AWS CodeCommit - AWS CodeCommit

Integrar o Visual Studio ao AWS CodeCommit

Você pode usar o Visual Studio para fazer alterações de código em um repositório do CodeCommit. Agora, o AWS Toolkit for Visual Studio inclui recursos que facilitam e tornam mais conveniente o trabalho com o CodeCommit no Team Explorer para Visual Studio. A integração com o Toolkit for Visual Studio foi desenvolvida para funcionar com credenciais do Git e um usuário do IAM. Você pode clonar repositórios existentes, criar repositórios, confirmar e enviar alterações de código por push para um repositório e muito mais.

Importante

O Toolkit for Visual Studio está disponível apenas para instalação em sistemas operacionais Windows.

Se você usou já usou o Toolkit for Visual Studio, provavelmente já está familiarizado com a configuração de perfis de credenciais da AWS que contêm uma chave de acesso e uma chave secreta. Os perfis de credenciais são utilizados na Toolkit for Visual Studio para ativar chamadas para AWS serviço APIs (por exemplo, para Amazon S3 para listar grupos ou para CodeCommit para listar repositórios). Para extrair e enviar o código a um repositório do CodeCommit, você também precisa de credenciais do Git. Se você não tiver credenciais do Git, o Toolkit for Visual Studio poderá gerar e aplicar essas credenciais para você. Isso pode poupar muito tempo.

Para usar o Visual Studio com o CodeCommit, você precisa do seguinte:

Passo 1: Obtenha um ade uso intensivo ke spor excêntrico kpor ypelo nosso IAM user

Se você ainda não tem um perfil de credencial configurado no computador em que o Visual Studio está instalado, pode configurar um com a AWS CLI e o comando aws configure. Como alternativa, você pode seguir as etapas deste procedimento para criar e fazer download das suas credenciais. Forneça-as ao Toolkit for Visual Studio quando solicitado.

As chaves de acesso consistem em um ID de chave de acesso e uma chave de acesso secreta, que são usados para assinar as solicitações programáticas que você faz à AWS. Se você não tiver chaves de acesso, poderá criá-las no Console de gerenciamento da AWS. Como melhores práticas, não utilize chaves de acesso Usuário raiz da conta da AWS para nenhuma tarefa para a qual não seja necessário. Em vez disso, crie um novo usuário do IAM com chaves de acesso para você mesmo.

A única ocasião em que você poderá visualizar ou fazer download da chave de acesso secreta é quando você criar as chaves. Não será possível recuperá-las posteriormente. No entanto, você pode criar novas chaves de acesso a qualquer momento. Você também deve ter permissões para realizar as ações do IAM necessárias. Para obter mais informações, consulte Permissões necessárias para acessar os recursos do IAM no Guia do usuário do IAM.

Para criar chaves de acesso para um usuário do IAM

  1. Faça login no Console de gerenciamento da AWS e abra o console da IAM em https://console.aws.amazon.com/iam/.

  2. No painel de navegação, escolha Users (Usuários).

  3. Escolha o nome do usuário cujas chaves de acesso você deseja criar e a guia Security credentials (Credenciais de segurança).

  4. Na seção Access keys (Chaves de acesso), escolha Create access key (Criar chave de acesso).

  5. Para visualizar a nova chave de acesso, escolha Show (Mostrar). Você não terá mais acesso à chave de acesso secreta depois que essa caixa de diálogo for fechada. Suas credenciais terão a seguinte aparência:

    • ID de chave de acesso: AKIAIOSFODNN7EXAMPLE

    • Chave de acesso secreta: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

  6. Para baixar o par de chaves, escolha Baixar arquivo .csv. Armazene as chaves em um lugar seguro. Você não terá mais acesso à chave de acesso secreta depois que essa caixa de diálogo for fechada.

    Mantenha a confidencialidade das chaves para proteger sua conta da AWS e nunca envie-as por e-mail. Não compartilhe as chaves fora da sua organização, mesmo se uma pesquisa parecer vir da AWS ou da Amazon.com. Alguém que legitimamente represente a Amazon jamais pedirá a você sua chave secreta.

  7. Depois de baixar do arquivo .csv, selecione Close (Fechar). Quando você cria uma chave de acesso, o par de chaves é ativo por padrão, e você pode usar o par imediatamente.

Tópicos relacionados

Passo 2: Instalar AWS Toolkit for Visual Studio e cligarpara ligar a CodeCommit

O Toolkit for Visual Studio é um pacote de software que você pode adicionar ao Visual Studio. Depois de instalá-lo, você pode se conectar ao CodeCommit a partir do Team Explorer no Visual Studio.

Para instalar o Toolkit for Visual Studio com o módulo do AWS CodeCommit e configurar o acesso ao repositório do projeto

  1. Instale o Visual Studio no computador local se você ainda não tiver uma versão compatível instalada.

  2. Faça download e instale o Toolkit for Visual Studio e salve o arquivo em uma pasta ou diretório local. Inicie o assistente de instalação, abrindo o arquivo. Quando solicitado na página Getting Started with the AWS Toolkit for Visual Studio (Conceitos básicos do AWS Toolkit for Visual Studio), insira ou importe suas credenciais da AWS (sua chave de acesso e a chave secreta) e selecione Save and Close (Salvar e fechar).

  3. No Visual Studio, abra o Team Explorer. Em Hosted Service Providers (Provedores de serviços hospedados), localize o AWS CodeCommit e selecione Connect (Conectar).

    
                        Ligar a CodeCommit no Team Explorer com o Toolkit for Visual Studio instalado.
  4. Execute um destes procedimentos:

    • Se você tiver um perfil de credencial único já configurado no seu computador, o Toolkit for Visual Studio o aplicará automaticamente. Nenhuma ação é necessária. O painel de conexão do AWS CodeCommit aparece no Team Explorer.

    • Se você tiver mais de um perfil de credencial configurado no seu computador, será solicitado a escolher aquele que deseja usar. Escolha o perfil associado ao usuário do IAM que você usará para se conectar a repositórios do CodeCommit e, em seguida, escolha OK.

    • Se você não tiver um perfil configurado, uma caixa de diálogo será exibida e solicitará suas credenciais de segurança da AWS (sua chave de acesso e chave secreta). Insira-as ou importe-as e selecione OK.

Depois de se conectar com um perfil, o painel de conexão do AWS CodeCommit aparecerá no Team Explorer com opções para clonar, criar ou sair. Escolher Clone (Clonar) clona um repositório do CodeCommit para o seu computador local. Assim, você poderá começar a trabalhar no código. Essa é a opção mais utilizada.

Se você não possui repositórios ou deseja criar um, escolha Create. Para obter mais informações, consulte Criar uma CodeCommit repositório de Visual Studio.

Clone a CodeCommit repositório de Visual Studio

Depois de se conectar ao CodeCommit, você pode clonar um repositório para um repositório local no seu computador. Em seguida, pode começar a trabalhar com o código.

  1. Em Gerenciar conexões, escolha Clonar. Em Region (Região), escolha a região da AWS na qual o repositório foi criado no CodeCommit. Escolha o repositório do seu projeto e a pasta no seu computador local na qual você deseja clonar o repositório e escolha OK.

  2. Se você for solicitado a criar credenciais do Git, escolha Yes. O toolkit tenta criar credenciais em seu nome. Você deve ter a IAMSelfManageServiceSpecificCredentials aplicada ao seu usuário do IAM ou as permissões equivalentes. Quando solicitado, salve o arquivo de credenciais em um local seguro. Essa é a única oportunidade que você terá de salvar essas credenciais do Git.

    Se o toolkit não puder criar credenciais do Git em seu nome, ou se você escolher No, deverá criar e fornecer suas próprias credenciais do Git. Para obter mais informações, consulte Para utilizadores HTTPS que utilizam credenciais Git ou siga as instruções online.

  3. Quando tiver concluído a clonagem do projeto, você estará pronto para começar a editar o código no Visual Studio e confirmar e enviar suas alterações por push ao repositório do projeto no CodeCommit.

Criar uma CodeCommit repositório de Visual Studio

Você pode criar repositórios do CodeCommit a partir do Visual Studio com o Toolkit for Visual Studio. Como parte da criação do repositório, você também o clona em um repositório local no seu computador, para poder começar a trabalhar com ele imediatamente.

  1. Em Manage Connections, escolha Create.

  2. Em Region (Região), escolha a região da AWS em que você deseja criar o repositório. Os repositórios do CodeCommit são organizados por região da AWS.

  3. Em Name (Nome), insira um nome para esse repositório. Os nomes dos repositórios devem ser exclusivos em uma conta da AWS. Existem limites de caractere e comprimento. Para obter mais informações, consulte Cotas. Em Description (Descrição), insira uma descrição opcional para esse repositório. Isso ajuda os outros a entender a função do repositório e ajuda a diferenciá-lo de outros repositórios na região.

  4. Em Clone into (Clonar para), insira ou navegue até a pasta ou o diretório em que deseja clonar esse repositório no computador local. O Visual Studio clonará automaticamente o repositório após a criação e cria o repositório local onde você escolher.

  5. Quando estiver satisfeito com suas escolhas, escolha OK.

  6. Se solicitado a criar credenciais do Git, escolha Sim. O toolkit tenta criar credenciais em seu nome. Você deve ter a IAMSelfManageServiceSpecificCredentials aplicada ao seu usuário do IAM ou as permissões equivalentes. Quando solicitado, salve o arquivo de credenciais em um local seguro. Essa é a única oportunidade que você terá de salvar essas credenciais do Git.

    Se o toolkit não puder criar credenciais do Git em seu nome, ou se você escolher No, deverá criar e fornecer suas próprias credenciais do Git. Para obter mais informações, consulte Para utilizadores HTTPS que utilizam credenciais Git ou siga as instruções online.

Trabalhar com CodeCommit repositories

Depois de se conectar ao CodeCommit, você pode ver uma lista de repositórios associados à sua conta da AWS. É possível navegar pelo conteúdo desses repositórios no Visual Studio. Abra o menu de contexto do repositório de interesse e escolha Browse in Console.

As operações do Git no Visual Studio para repositórios do CodeCommit funcionam exatamente como em qualquer outro repositório baseado no Git. Você pode fazer alterações no código, adicionar arquivos e criar confirmações locais. Quando estiver pronto para compartilhar, use a opção Sync (Sincronizar) no Team Explorer para enviar suas confirmações ao repositório do CodeCommit. Como suas credenciais do Git para o usuário do IAM já estão armazenadas localmente e associadas ao seu perfil de credenciais conectado da AWS, você não precisará informá-las novamente quando fizer push para o CodeCommit.

Para obter mais informações sobre como trabalhar com o Toolkit for Visual Studio, consulte o Guia do usuário do AWS Toolkit for Visual Studio.