Integrar o AWS Cloud9 ao AWS CodeCommit - AWS CodeCommit

AWS CodeCommit não está mais disponível para novos clientes. Os clientes atuais do AWS CodeCommit podem continuar usando o serviço normalmente. Saiba mais

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 AWS Cloud9 ao AWS CodeCommit

Você pode usar o AWS Cloud9 para fazer alterações de código em um repositório do CodeCommit. O AWS Cloud9 contém um conjunto de ferramentas que você pode usar para escrever códigos, além de compilar, executar, testar, depurar e liberar softwares. 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, tudo isso no ambiente de desenvolvimento do AWS Cloud9 EC2. O ambiente de desenvolvimento de EC2 do AWS Cloud9 geralmente é pré-configurado com a AWS CLI, uma função do Amazon EC2, e o Git, portanto, na maioria dos casos, você pode executar alguns comandos simples e começar a interagir com o repositório.

Para usar o AWS Cloud9 com o CodeCommit, você precisa do seguinte:

Etapa 1: criar um ambiente de desenvolvimento do AWS Cloud9

O AWS Cloud9 hospeda seu ambiente de desenvolvimento em uma instância do Amazon EC2. Essa é a maneira mais fácil de fazer a integração, pois você pode usar credenciais temporárias gerenciadas pela AWS para que a instância se conecte ao repositório do CodeCommit. Para usar seu próprio servidor, consulte o Guia do usuário do AWS Cloud9.

Para criar um ambiente do AWS Cloud9
  1. Faça login na AWS como o usuário do IAM configurado e abra o console do AWS Cloud9.

  2. No console do AWS Cloud9, escolha Create environment (Criar ambiente).

  3. Em Step 1: Name environment (Etapa 1: nomear ambiente), insira um nome e uma descrição opcional para o ambiente e selecione Next step (Próxima etapa).

  4. Em Step 2: Configure Settings, configure seu ambiente da seguinte maneira:

    • Em Environment type, escolha Create a new instance for environment (EC2).

    • Em Instance type, escolha o tipo de instância adequado para o seu ambiente de desenvolvimento. Por exemplo, se você está apenas explorar o serviço, pode escolher o padrão de t2.micro. Se você pretende usar este ambiente para trabalho de desenvolvimento, escolha um tipo de instância maior.

    • Aceite as outras configurações padrão, a menos que você tenha motivos para fazer diferente (por exemplo, sua organização usa uma VPC específica ou sua conta da Amazon Web Services não tem nenhuma VPC configurada) e selecione Próxima etapa.

  5. Em Step 3: Review, analise suas configurações. Escolha Previous step se quiser fazer qualquer alteração. Se não, escolha Create environment.

    A criação de um ambiente e a conexão a ele pela primeira vez leva vários minutos. Se parecer levar um tempo muito longo, consulte Solução de problemas no Guia do usuário do AWS Cloud9.

  6. Após a conexão com o ambiente, verifique se o Git já está instalado e se é uma versão compatível, executando o comando git --version na janela do terminal.

    Se o Git não está instalado, ou se não é uma versão compatível, instale uma versão compatível. O CodeCommit é compatível com o Git versões 1.7.9 e posteriores. A versão 2.28 do Git é compatível com a configuração do nome de ramificações para as confirmações iniciais. Recomendamos o uso de uma versão recente do Git. Para instalar o Git, recomendamos sites como o Git Downloads.

    dica

    Dependendo do sistema operacional do ambiente, você pode usar o comando yum com a opção sudo para instalar atualizações, incluindo o Git. Por exemplo, uma sequência de comandos administrativos poderá se parecer com os seguintes três comandos:

    sudo yum -y update sudo yum -y install git git --version

  7. Configure um nome de usuário e e-mail a ser associado a suas confirmações do Git executando o comando git config. Por exemplo:

    git config --global user.name "Mary Major" git config --global user.email mary.major@example.com

Etapa 2: configurar o assistente de credenciais da AWS CLI no ambiente de desenvolvimento do EC2 do AWS Cloud9

Depois de criar um ambiente do AWS Cloud9, você pode configurar o assistente de credenciais da AWS CLI para gerenciar as credenciais para conexões com seu repositório do CodeCommit. O ambiente de desenvolvimento do AWS Cloud9 vem com credenciais temporárias gerenciadas pela AWS, que estão associadas a seu usuário do IAM. Você usa essas credenciais com o auxiliar de credenciais da AWS CLI.

  1. Abra a janela do terminal e execute o seguinte comando para verificar se a AWS CLI está instalada:

    aws --version

    Se for bem-sucedido, este comando retornará a versão da AWS CLI instalada no momento. Para atualizar uma versão mais antiga da AWS CLI para a versão mais recente, consulte Instalação da AWS Command Line Interface.

  2. No terminal, execute os seguintes comandos para configurar o auxiliar de credenciais da AWS CLI para conexões HTTPS:

    git config --global credential.helper '!aws codecommit credential-helper $@' git config --global credential.UseHttpPath true
    dica

    O assistente de credenciais usa o perfil de instância padrão do Amazon EC2 para o ambiente de desenvolvimento. Se você pretende usar o ambiente de desenvolvimento para conectar-se a repositórios que não são hospedados no CodeCommit, configure as conexões SSH para esses repositórios ou configure um arquivo local .gitconfig para usar um sistema de gerenciamento de credenciais alternativo ao conectar-se a esses outros repositórios. Para obter mais informações, consulte Ferramentas do GiT – armazenamento de credenciais no site do Git.

Etapa 3: clonar um repositório do CodeCommit em seu ambiente de desenvolvimento de EC2 do AWS Cloud9

Depois de configurar o assistente de credenciais da AWS CLI, você poderá clonar o repositório do CodeCommit nele. Em seguida, pode começar a trabalhar com o código.

  1. No terminal, execute o comando git clone especificando a URL do clone HTTPS do repositório que você deseja clonar. Por exemplo, se quiser clonar um repositório nomeado MyDemoRepo na região Leste dos EUA (Ohio), insira:

    git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
    dica

    É possível encontrar a URL do clone para seu repositório no console do CodeCommit selecionando URL do clone.

  2. Quando a clonagem for concluída, na navegação lateral, expanda a pasta do seu repositório e selecione o arquivo que deseja abrir para edição. Como alternativa, selecione File (Arquivo) e selecione New file (Novo arquivo) para criar um arquivo.

  3. Quando você finalizar a edição ou a criação de arquivos, na janela do terminal, altere os diretórios para o repositório clonado e, em seguida, confirme e faça push de suas alterações. Por exemplo, se você adicionou um novo arquivo chamado MyFile.py:

    cd MyDemoRepo git commit -a MyFile.py git commit -m "Added a new file with some code improvements" git push

Próximas etapas

Para obter mais informações, consulte Guia do usuário do AWS Cloud9 e Amostra do CodeCommit para o AWS Cloud9. Para obter mais informações sobre como usar o Git com o CodeCommit, consulte Conceitos básicos do Git e AWS CodeCommit.