Integrar o Eclipse ao AWS CodeCommit - AWS CodeCommit

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

Integrar o Eclipse ao AWS CodeCommit

Você pode usar o Eclipse para fazer alterações de código em um repositório do CodeCommit. A integração do Toolkit for Eclipse foi desenvolvida para funcionar com credenciais do Git e usuário do IAM. Você pode clonar repositórios existentes, criar repositórios, confirmar e enviar alterações de código via push para um repositório e muito mais.

Para usar o Toolkit for Eclipse com o CodeCommit, você precisa do seguinte:

Etapa 1: obter uma chave de acesso e uma chave secreta para o usuário do IAM

Se você ainda não tem um perfil de credencial configurado no computador em que o Eclipse 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 eles ao Toolkit for Eclipse quando solicitado.

Os usuários precisam de acesso programático se quiserem interagir com a AWS de fora do AWS Management Console. A forma de conceder acesso programático depende do tipo de usuário que está acessando a AWS.

Para conceder acesso programático aos usuários, escolha uma das seguintes opções:

Qual usuário precisa de acesso programático? Para Por

Identificação da força de trabalho

(Usuários gerenciados no Centro de Identidade do IAM)

Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

IAM Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS. Siga as instruções em Como usar credenciais temporárias com recursos da AWS no Guia do usuário do IAM.
IAM

(Não recomendado)

Use credenciais de longo prazo para assinar solicitações programáticas para a AWS CLI, os SDKs da AWS ou as APIs da AWS.

Siga as instruções da interface que deseja utilizar.

Etapa 2: instalar o AWS Toolkit for Eclipse e conectar ao CodeCommit

O Toolkit for Eclipse é um pacote de software que você pode adicionar ao Eclipse. Depois de instalar e configurar ele com seu perfil de credencial da AWS, você pode se conectar ao CodeCommit a partir do AWS Explorer no Eclipse.

Para instalar o Toolkit for Eclipse com o módulo do AWS CodeCommit e configurar o acesso ao repositório do projeto
  1. Instale o Toolkit for Eclipse no seu computador local se ainda não tiver uma versão compatível instalada. Se você precisar atualizar sua versão do Toolkit for Eclipse, siga as instruções em Configurar o Toolkit.

  2. No Eclipse, siga a experiência de primeira execução ou abra Preferências no sistema de menu do Eclipse (a localização precisa varia de acordo com a versão e o sistema operacional) e escolha AWS Toolkit.

  3. Faça um dos seguintes procedimentos:

    • Se você seguir a experiência de primeira execução, forneça suas credenciais de segurança da AWS quando solicitado a configurar seu perfil de credencial.

    • Se você estiver configurando em Preferences (Preferências) e tiver um perfil de credencial já configurado no seu computador, escolha-o em Default Profile (Perfil padrão).

    • Se você estiver configurando em Preferences e não vir o perfil que deseja usar, ou se a lista estiver vazia, escolha Add profile. Em Detalhes do perfil, insira um nome para o perfil e as credenciais do usuário do IAM (chave de acesso e chave secreta) ou, como alternativa, insira a localização do arquivo de credenciais.

    • Se estiver configurando em Preferences (Preferências) e não tiver um perfil configurado, use os links para se cadastrar em uma conta ou gerenciar suas credenciais de segurança da AWS.

  4. No Eclipse, expanda o menu AWS Toolkit e escolha AWS CodeCommit. Escolha seu perfil de credencial e insira o nome do usuário e a senha para as suas credenciais do Git ou importe-os do arquivo .csv. Escolha Apply e, em seguida, escolha OK.

    
                        Configurar credenciais do Git no Eclipse com o Toolkit for Eclipse instalado.

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. Selecionar Clonar clona um repositório do CodeCommit existente no seu computador local para você poder começar a trabalhar no código. Essa é a opção mais utilizada.

Se você não tem repositórios ou deseja criar um, escolha Create.

Clonar um repositório do CodeCommit do Eclipse

Depois de configurar suas credenciais, você poderá clonar um repositório em um repositório local em seu computador, fazendo seu check-out no Eclipse. Em seguida, pode começar a trabalhar com o código.

  1. No Eclipse, abra AWS Explorer. Para obter mais informações sobre onde encontrá-lo, consulte Como acessar o AWS Explorer. Expanda oAWS CodeCommit e escolha o repositório do CodeCommit no qual você deseja trabalhar. Você pode ver o histórico de confirmações e outros detalhes do repositório, o que pode ajudá-lo a determinar se este é o repositório e a ramificação que deseja clonar.

    nota

    Se você não visualizar o repositório, escolha o ícone de sinalizador para abrir o menu Regiões da AWS e escolha a Região da AWS em que o repositório foi criado.

    
                   Escolher seu repositório do CodeCommit no AWS Explorer.
  2. Escolha Check out e siga as instruções para clonar o repositório no seu computador local.

  3. Quando tiver concluído a clonagem do projeto, você poderá começar a editar o código no Eclipse e a preparar, confirmar e enviar suas alterações via push ao repositório do projeto no CodeCommit.

Criar um repositório do CodeCommit no Eclipse

Você pode criar repositórios do CodeCommit no Eclipse com o Toolkit for Eclipse. 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. No AWS Explorer, clique com o botão direito do mouse em AWS CodeCommit e escolha Criar repositório.

    nota

    Os repositórios são específicos para a região. Antes de criar o repositório, certifique-se de ter selecionado a Região da AWS correta. Não é possível escolher a Região da AWS depois de iniciar o processo de criação do repositório.

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

  3. No AWS Explorer, expanda o AWS CodeCommit e escolha o repositório do CodeCommit que você acabou de criar. Você verá que esse repositório não tem um histórico de confirmação. Escolha Check out e siga as instruções para clonar o repositório no seu computador local.

Trabalhar com repositórios do CodeCommit

Depois de se conectar ao CodeCommit, você poderá ver uma lista de repositórios associados à sua conta, por Região da AWS, no AWS Explorer. Escolha o menu de sinalizador para alterar a região.

nota

O CodeCommit pode não estar disponível em todas as Regiões da AWS compatíveis com o Toolkit for Eclipse.

No Toolkit for Eclipse, você pode procurar o conteúdo desses repositórios nas visualizações Navegação e Package Explorer. Para abrir um arquivo, escolha-o na lista.

As operações do Git no Toolkit for Eclipse 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 Preparação do Git para enviar suas confirmações ao repositório do CodeCommit. Se você não tiver configurado suas informações de autor e responsável pela confirmação em um perfil do Git, poderá fazer isso antes de confirmar e enviar. Como suas credenciais do Git para o usuário do IAM já estão armazenadas localmente e associadas ao seu perfil de credencial 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 Eclipse, consulte o Guia de conceitos básicos do AWS Toolkit for Eclipse.