O AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. Saiba mais
Tutorial do AWS CodeCommit para o AWS Cloud9
Você pode usar o tutorial do AWS CodeCommit para configurar um ambiente de desenvolvimento do AWS Cloud9 a fim de interagir com um repositório de código remoto no CodeCommit. O CodeCommit é um serviço de controle de código-fonte que pode ser usado para armazenar e gerenciar repositórios do Git com privacidade na Nuvem AWS. Para obter mais informações sobre o CodeCommit, consulte o Manual do usuário do AWS CodeCommit.
Seguir este tutorial e criar este exemplo pode gerar cobranças em sua Conta da AWS. Isso inclui possíveis cobranças por serviços como o Amazon EC2 e CodeCommit. Para obter mais informações, consulte Definição de preço do Amazon EC2
Pré-requisitos
Antes de usar esse exemplo, verifique se suas configurações cumprem os requisitos a seguir.
-
É necessário ter um ambiente existente de desenvolvimento do AWS Cloud9 EC2 Este exemplo pressupõe que você já tem um ambiente do EC2 conectado a uma instância do Amazon EC2 que executa Amazon Linux ou Ubuntu Server. Caso tenha um tipo diferente de ambiente ou sistema operacional, poderá ser necessário adaptar as instruções desse exemplo para configurar ferramentas relacionadas. Para ter mais informações, consulte Criar um ambiente no AWS Cloud9.
-
Você tem o IDE do AWS Cloud9 para o ambiente existente já aberto. Ao abrir um ambiente o AWS Cloud9 abre o IDE para esse ambiente em um navegador da web. Para ter mais informações, consulte Abrir um ambiente no AWS Cloud9.
Etapa 1: Configurar o grupo do IAM com as permissões de acesso necessárias
Suponha que suas credenciais da AWS estão associadas a um usuário administrador em sua Conta da AWS e você quer usar esse usuário para trabalhar com o CodeCommit. Avance para a Etapa 2: Criar um repositório no AWS CodeCommit.
Conclua essa etapa usando o AWS Management Console ou a interface da linha de comando da AWS (AWS CLI).
Configurar o grupo do IAM com as permissões de acesso necessárias usando o console
-
Faça login no AWS Management Console, se ainda não tiver feito.
Para esta etapa, recomendamos que faça login usando credenciais de um usuário administrador em sua Conta da AWS. Se isso não for possível, fale com o administrador de sua Conta da AWS.
-
Abra o console do IAM. Para fazer isso, na barra de navegação do console, selecione Serviços. Depois, selecione IAM.
-
Selecione Grupos.
-
Selecione o nome do grupo.
-
Na guia Permssões, em Políticas gerenciadas, selecione Anexar política.
-
Na lista de nomes de políticas, selecione uma das seguintes caixas:
-
Selecione AWSCodeCommitPowerUser para acessar todas as funcionalidades do CodeCommit e recursos relacionados ao repositório. No entanto, isso não permite que você exclua repositórios do CodeCommit nem crie ou exclua recursos relacionados ao repositório em outros Serviços da AWS, como o Amazon CloudWatch Events.
-
Selecione AWSCodeCommitFullAccess para obter controle total sobre os repositórios do CodeCommit e os recursos relacionados na Conta da AWS. Isso inclui a capacidade de excluir repositórios.
Se nenhum desses nomes de política for encontrado na lista, insira os nomes das políticas na caixa Filtrar para exibi-las.
-
-
Escolha Attach Policy.
Para ver a lista de permissões de acesso que essas políticas gerenciadas pela AWS fornecem a um grupo, consulte Políticas (predefinidas) gerenciadas pela AWS para o AWS CodeCommit no Guia do usuário do AWS CodeCommit.
Avance até a Etapa 2: Criar um repositório no AWS CodeCommit.
Configurar o grupo do IAM com as permissões de acesso necessárias usando a AWS CLI
Execute o comando attach-group-policy
do IAM, especificando o nome do grupo e o nome do recurso da Amazon (ARN) da política gerenciada pela AWS que descreve as permissões de acesso necessárias. A sintaxe é a seguinte.
aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN
No comando anterior, substitua MyGroup
pelo nome do grupo. Substitua POLICY_ARN
pelo ARN da política gerenciada pela AWS:
-
arn:aws:iam::aws:policy/AWSCodeCommitPowerUser
para acessar todas as funcionalidades do CodeCommit e recursos relacionados ao repositório. No entanto, não permite que você exclua repositórios do CodeCommit nem crie ou exclua recursos relacionados ao repositório em outros Serviços da AWS, como o Amazon CloudWatch Events. -
arn:aws:iam::aws:policy/AWSCodeCommitFullAccess
para obter controle total sobre os repositórios do CodeCommit e os recursos relacionados na Conta da AWS. Isso inclui a capacidade de excluir repositórios.
Para ver a lista de permissões de acesso que essas políticas gerenciadas pela AWS fornecem a um grupo, consulte Políticas (predefinidas) gerenciadas pela AWS para o AWS CodeCommit no Guia do usuário do AWS CodeCommit.
Etapa 2: Criar um repositório no CodeCommit
Nesta etapa, você criará um repositório de código remoto no CodeCommit usando o console dele.
Se você já tiver um repositório do CodeCommit, avance até a Etapa 3: Conectar o ambiente ao repositório remoto.
Conclua essa etapa usando o AWS Management Console ou a interface da linha de comando da AWS (AWS CLI).
Crie um repositório no CodeCommit usando o console
-
Suponha que você está conectado ao AWS Management Console como um usuário administrador desde a etapa anterior e não quer usar o usuário administrador para criar o repositório. Saia do AWS Management Console.
-
Abra o console do CodeCommit em https://console.aws.amazon.com/codecommit
. -
Na barra de navegação do console, use o seletor de região para selecionar a Região da AWS onde deseja criar o repositório. Por exemplo, US East (Ohio) [Leste dos EUA (Ohio)].
-
Se uma página de boas-vindas for exibida, escolha Get started. Caso contrário, selecione Criar repositório.
-
Na página Criar repositório, em Nome do repositório, insira um nome para o novo repositório (por exemplo,
MyDemoCloud9Repo
). Se escolher um nome diferente, substitua-o ao longo desse exemplo. -
(Opcional) Em Descrição, insira algo sobre o repositório. Por exemplo, insira:
This is a demonstration repository for the AWS Cloud9 sample.
-
Escolha Criar repositório. Um painel Conectar ao repositório é exibido. Selecione Fechar, uma vez que se conectará ao repositório de forma diferente mais adiante nesse tópico.
Avance até a Etapa 3: Conectar o ambiente ao repositório remoto.
Crie um repositório no CodeCommit usando a AWS CLI
Execute o comando AWS CodeCommit create-repository
. Especifique o nome do repositório, uma descrição opcional e a Região da AWS onde o repositório será criado.
aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2
No comando anterior, substitua us-east-2
pelo ID da Região da AWS onde o repositório será criado. Para ver uma lista das regiões compatíveis, consulte AWS CodeCommit no Referência geral da Amazon Web Services.
Se decidiu usar um nome de repositório diferente, substitua-o ao longo desse exemplo.
Etapa 3: Conectar o ambiente ao repositório remoto
Nesta etapa, use o IDE do AWS Cloud9 para se conectar ao repositório do CodeCommit criado ou identificado na etapa anterior.
nota
Se preferir trabalhar com o Git por meio de uma interface visual, você poderá clonar o repositório remoto. Depois, você poderá adicionar arquivos usando o recurso Painel do Git que está disponível no IDE.
Conclua um dos conjuntos de procedimentos a seguir de acordo com o tipo do ambiente de desenvolvimento do AWS Cloud9.
Tipo de ambiente | Siga esses procedimentos |
---|---|
Ambiente EC2 |
|
Ambiente do SSH |
|
Etapa 4: Clonar o repositório remoto no ambiente
Nesta etapa, você usará o IDE do AWS Cloud9 para clonar o repositório remoto no CodeCommit no ambiente.
Para clonar o repositório, execute o comando git clone
. Substitua CLONE_URL
pelo URL do clone do repositório.
git clone CLONE_URL
Para um ambiente EC2, forneça um URL de clonagem HTTPS que comece com https://
. Para um ambiente SSH, forneça um URL de clonagem SSH que comece com ssh://
.
Para obter o URL de clonagem completo do repositório, consulte Usar o console do AWS CodeCommit para exibir os detalhes do repositório no Manual do usuário do AWS CodeCommit.
Se seu repositório não tiver nenhum arquivo, uma mensagem de aviso será exibida, como: “You appear to have cloned an empty repository.
This is expected.” (Parece que você clonou um repositório vazio. Isso é esperado.). Você cuidará disso mais tarde.
Etapa 5: Adicionar arquivos ao repositório
Nesta etapa, você criará três arquivos simples no repositório clonado no ambiente do AWS Cloud9. Depois, adicione os arquivos à área de preparação do Git no repositório clonado. Por fim, confirme os arquivos preparados e envie a confirmação para o repositório remoto no CodeCommit.
Se o repositório clonado já contém arquivos, pule o restante desse exemplo.
Para adicionar arquivos ao repositório
-
Criar um novo arquivo. Na barra de menus, selecione Arquivo, Novo arquivo.
-
Insira o conteúdo a seguir no arquivo, depois selecione Arquivo e Salvar para salvar o arquivo como
bird.txt
no diretórioMyDemoCloud9Repo
no ambiente do AWS Cloud9.bird.txt -------- Birds are a group of endothermic vertebrates, characterized by feathers, toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic rate, a four-chambered heart, and a lightweight but strong skeleton.
nota
Para confirmar que está salvando o arquivo no diretório correto, na caixa de diálogo Salvar como, selecione a pasta
MyDemoCloud9Repo
. Depois, certifique-se de que Pasta exiba/MyDemoCloud9Repo
. -
Crie mais dois arquivos, chamados
insect.txt
ereptile.txt
, com o conteúdo a seguir. Salve os arquivos no mesmo diretórioMyDemoCloud9Repo
.insect.txt ---------- Insects are a class of invertebrates within the arthropod phylum that have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen), three pairs of jointed legs, compound eyes, and one pair of antennae.
reptile.txt ----------- Reptiles are tetrapod (four-limbed vertebrate) animals in the class Reptilia, comprising today's turtles, crocodilians, snakes, amphisbaenians, lizards, tuatara, and their extinct relatives.
-
No terminal, execute o comando
cd
para alternar para o diretórioMyDemoCloud9Repo
.cd MyDemoCloud9Repo
-
Confirme se os arquivos foram salvos com sucesso no diretório
MyDemoCloud9Repo
executando o comandogit status
. Todos os três arquivos serão listados como arquivos não rastreados.Untracked files: (use "git add <file>..." to include in what will be committed) bird.txt insect.txt reptile.txt
-
Adicione os arquivos à área de preparação do Git executando o comando
git add
.git add --all
-
Confirme se os arquivos foram adicionados com sucesso à área de preparação do Git executando o comando
git status
novamente. Todos os três arquivos agora estão listados como alterações na confirmação.Changes to be committed: (use "git rm --cached <file>..." to unstage) new file: bird.txt new file: insect.txt new file: reptile.txt
-
Confirme os arquivos preparados executando o comando
git commit
.git commit -m "Added information about birds, insects, and reptiles."
-
Envie a confirmação para o repositório remoto no CodeCommit executando o comando
git push
.git push -u origin master
-
Confirme se os arquivos foram enviado com êxito. Abra o console do CodeCommit, se ainda não estiver aberto, em https://console.aws.amazon.com/codecommit
. -
Na barra de navegação superior, perto da borda direita, selecione a Região da AWS onde o repositório foi criado; por exemplo, US East (Ohio) [Leste dos EUA (Ohio)].
-
Na página do Dashboard (Painel), selecione MyDemoCloud9Repo. Os três arquivos são exibidos.
Para continuar a testar o repositório do CodeCommit, consulte Browse the Contents of Your Repository (Navegar pelo conteúdo do repositório) no Manual do usuário do AWS CodeCommit.
Se for iniciante no Git e não quiser bagunçar seu repositório do CodeCommit, faça um teste com um exemplo de repositório Git no site Try Git
Etapa 6: limpar
Para evitar cobranças contínuas na Conta da AWS, ao terminar de usar esse exemplo, exclua o repositório do CodeCommit. Para obter instruções, consulte Delete an AWS CodeCommit Repository no Guia do usuário do AWS CodeCommit.
Exclua também o ambiente. Para obter instruções, consulte Exclusão de um ambiente.