Migrar um repositório Git para AWS CodeCommit

Para criar e configurar um usuário do IAM para acessar CodeCommit

1. Crie uma conta da Amazon Web Services acessando http://aws.amazon.com e escolhendo Cadastrar-se.

2. Crie um usuário do IAM ou use um existente na sua conta da Amazon Web Services. Confirme se você tem um ID de chave de acesso e uma chave de acesso secreta associados ao usuário do IAM. Para obter mais informações, consulte Criar um usuário do IAM na conta da Amazon Web Services.

   nota

   CodeCommit requer AWS Key Management Service. Se você estiver usando um usuário do IAM existente, verifique se não há políticas anexadas ao usuário que neguem expressamente as AWS KMS ações exigidas pelo CodeCommit. Para obter mais informações, consulte AWS KMS e criptografia.

3. Faça login no AWS Management Console e abra o console do IAM em https://console.aws.amazon.com/iam/.

4. No console do IAM, no painel de navegação, escolha Usuários e, em seguida, escolha o usuário do IAM que você deseja configurar para CodeCommit acesso.

5. Na guia Permissions, escolha Add Permissions.

6. Em Grant permissions, escolha Attach existing policies directly.

7. Na lista de políticas, selecione AWSCodeCommitPowerUserou outra política gerenciada para CodeCommit acesso. Para obter mais informações, consulte AWS políticas gerenciadas para CodeCommit.

   Depois de selecionar a política que deseja anexar, escolha Próximo: Revisar para revisar a lista de políticas a serem anexadas ao usuário do IAM. Se a lista estiver correta, selecione Add permissions.

   Para obter mais informações sobre políticas CodeCommit gerenciadas e compartilhamento de acesso a repositórios com outros grupos e usuários, consulte Compartilhar um repositório e. Autenticação e controle de acesso para o AWS CodeCommit

Para instalar e configurar o AWS CLI

1. Em sua máquina local, baixe e instale AWS CLI o. Esse é um pré-requisito para interagir com a linha CodeCommit de comando. Recomendamos instalar a AWS CLI versão 2. É a versão principal mais recente do AWS CLI e oferece suporte a todos os recursos mais recentes. É a única versão do AWS CLI que suporta o uso de uma conta raiz, acesso federado ou credenciais temporárias com. git-remote-codecommit

   Para obter mais informações, consulte Como configurar a interface de linha de AWS comando.

   nota

   CodeCommit funciona somente com AWS CLI as versões 1.7.38 e posteriores. Como prática recomendada, instale ou atualize AWS CLI para a versão mais recente disponível. Para determinar qual versão do AWS CLI você instalou, execute o aws --version comando.

   Para atualizar uma versão mais antiga do AWS CLI para a versão mais recente, consulte Instalando AWS Command Line Interface o.

2. Execute esse comando para verificar se os CodeCommit comandos do AWS CLI estão instalados.

   aws codecommit help

   Esse comando retorna uma lista de CodeCommit comandos.

3. Configure o AWS CLI com um perfil usando o configure comando, do seguinte modo:.

   aws configure

   Quando solicitado, especifique a chave de AWS acesso e a chave de acesso AWS secreta do usuário do IAM com CodeCommit a qual usar. Além disso, certifique-se de especificar Região da AWS onde o repositório existe, comous-east-2. Quando solicitado pelo formato de saída padrão, especifique json. Por exemplo, se você estiver configurando um perfil para um usuário do IAM:

   AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
   AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
   Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
   Default output format [None]: Type json here, and then press Enter

   Para obter mais informações sobre como criar e configurar perfis para usar com o AWS CLI, consulte o seguinte:

   • Perfis nomeados

   • Usando uma função do IAM no AWS CLI

   • Comando set

   • Conectando-se a AWS CodeCommit repositórios com credenciais rotativas

   Para se conectar a um repositório ou recurso em outro Região da AWS, você deve reconfigurar o AWS CLI com o nome de região padrão. Os nomes de região padrão compatíveis CodeCommit incluem:

   • us-east-2

   • us-east-1

   • eu-west-1

   • us-west-2

   • ap-northeast-1

   • ap-southeast-1

   • ap-southeast-2

   • ap-southeast-3

   • me-central-1

   • eu-central-1

   • ap-northeast-2

   • sa-east-1

   • us-west-1

   • eu-west-2

   • ap-south-1

   • ap-south-1

   • ca-central-1

   • us-gov-west-1

   • us-gov-east-1

   • eu-north-1

   • ap-east-1

   • me-south-1

   • cn-north-1

   • cn-northwest-1

   • eu-south-1

   • ap-northeast-3

   • af-south-1

   • il-central-1

   Para obter mais informações sobre CodeCommit e Região da AWS, consulteRegiões e endpoints de conexão do Git. Para obter mais informações sobre o IAM, chaves de acesso e chaves secretas, consulte Como consigo credenciais? e Gerenciar chaves de acesso para usuário do IAM. Para obter mais informações sobre os perfis AWS CLI e, consulte Perfis nomeados.

1. Abra o CodeCommit console em https://console.aws.amazon.com/codesuite/codecommit/home.

2. No seletor de região, escolha Região da AWS onde você deseja criar o repositório. Para obter mais informações, consulte Regiões e endpoints de conexão do Git.

3. Na página Repositories (Repositórios), selecione Create repository (Criar repositório).

4. Na página Create repository (Criar repositório), em Repository name (Nome do repositório), insira um nome para o repositório.

   nota

   Os nomes de repositórios diferenciam maiúsculas de minúsculas. O nome deve ser exclusivo na Região da AWS para sua conta da Amazon Web Services.

5. (Opcional) Em Description (Descrição), insira uma descrição para o repositório. Isso pode ajudar você e outros usuários a identificar a finalidade do repositório.

   nota

   O campo de descrição exibe o Markdown no console e aceita todos os caracteres HTML e caracteres Unicode válidos. Se você é um desenvolvedor de aplicativos que está usando o GetRepository ou BatchGetRepositories APIs e planeja exibir o campo de descrição do repositório em um navegador da Web, consulte a Referência da CodeCommit API.

6. (Opcional) Escolha Adicionar tag para adicionar uma ou mais tags de repositório (um rótulo de atributo personalizado que ajuda você a organizar e gerenciar seus AWS recursos) ao seu repositório. Para obter mais informações, consulte Marcando repositórios em AWS CodeCommit.

7. (Opcional) Expanda Configuração adicional para especificar se você deseja usar a chave padrão Chave gerenciada pela AWS ou sua própria chave gerenciada pelo cliente para criptografar e descriptografar dados nesse repositório. Se você optar por usar sua própria chave gerenciada pelo cliente, deverá garantir que ela esteja disponível no Região da AWS local em que você está criando o repositório e que a chave esteja ativa. Para obter mais informações, consulte AWS Key Management Service e criptografia para AWS CodeCommit repositórios.

8. (Opcional) Selecione Habilitar Amazon CodeGuru Reviewer para Java e Python se esse repositório contiver código Java ou Python e você CodeGuru quiser que o Reviewer o analise. CodeGuru O revisor usa vários modelos de aprendizado de máquina para encontrar defeitos no código e sugerir melhorias e correções nas pull requests. Para obter mais informações, consulte o Guia do usuário do Amazon CodeGuru Reviewer.

9. Escolha Criar.

1. No terminal ou no prompt de comando do seu computador local, execute o git clone comando com a --mirror opção de clonar uma cópia vazia do repositório remoto em uma nova pasta chamada. aws-codecommit-demo Este é um repositório vazio destinado apenas à migração. Não é o repositório local para interagir com o repositório migrado em. CodeCommit Você pode criar isso mais tarde, após a conclusão da migração para CodeCommit .

   O exemplo a seguir clona um aplicativo de demonstração hospedado em GitHub (https://github.com/awslabs/aws-demo-php-simple-app.git) em um repositório local em um diretório chamado. aws-codecommit-demo

   git clone --mirror https://github.com/awslabs/aws-demo-php-simple-app.git aws-codecommit-demo

2. Altere os diretórios para o diretório onde você criou o clone.

   cd aws-codecommit-demo

3. Execute o git push comando, especificando a URL e o nome do CodeCommit repositório de destino e a --all opção. (Este é o URL que você copiou em Etapa 1: criar um CodeCommit repositório).

   Por exemplo, se você nomeou seu repositório MyClonedRepository e está configurado para usar HTTPS, execute o seguinte comando:

   git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --all

   nota

   A opção --all apenas envia por push todas as ramificações para o repositório. Ela não é compatível com o push de outras referências, como tags. Se você deseja enviar tags por push, aguarde até o push inicial ser concluído e, em seguida, envie por push novamente, desta vez usando a opção --tags:

   git push ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyClonedRepository --tags

   Para obter mais informações, consulte Git push no site do Git. Para obter informações sobre enviar grandes repositórios por push, principalmente ao enviar todas as referências por push de uma vez (por exemplo, com a opção --mirror), consulte Migrar um repositório em incrementos.

1. Abra o CodeCommit console em https://console.aws.amazon.com/codesuite/codecommit/home.

2. Em Repositórios, escolha o nome do repositório (por exemplo,MyClonedRepository).

3. Visualize os arquivos no repositório das ramificações, do clone URLs, das configurações e muito mais.

   

Criação de uma política gerenciada por cliente para seu repositório

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

2. Na área de navegação do Painel, escolha Policies e, em seguida, Create Policy.

3. Na página Criar políticas, escolha Importar política gerenciada.

4. Na página Importar políticas gerenciadas, em Filtrar políticas, insira o AWSCodeCommitPowerUser. Selecione o botão ao lado do nome da política e escolha Importar.

5. Na página Create policy (Criar política), escolha JSON. Substitua a parte “*” da Resource linha para CodeCommit ações pelo Amazon Resource Name (ARN) do CodeCommit repositório, conforme mostrado aqui:

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo"
    ]

   dica

   Para encontrar o ARN do CodeCommit repositório, acesse o CodeCommit console, escolha o nome do repositório na lista e escolha Configurações. Para obter mais informações, consulte Visualizar detalhes de repositórios.

   Se você quiser que essa política seja aplicada a mais de um repositório, adicione cada um como um recurso especificando o ARN dele. Inclua uma vírgula entre cada instrução de recurso, conforme mostrado aqui:

   "Resource": [
    "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo",
    "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo"
    ]

   Ao concluir a edição, selecione Revisar política.

6. Na página Revisar Política, em Nome, insira um novo nome para a política (por exemplo,AWSCodeCommitPowerUser-MyDemoRepo). Como opção, você pode fornecer uma descrição para essa política.

7. Escolha Criar política.

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

2. Na área de navegação Painel, escolha Grupos e Criar novo grupo.

3. Na página Set Group Name (Definir nome de grupo), em Group Name (Nome do grupo), insira um nome para o grupo (por exemplo, MyDemoRepoGroup) e escolha Next Step (Próxima etapa). Considere incluir o nome do repositório como parte do nome do grupo.

   nota

   Esse nome precisa ser exclusivo em toda a conta da Amazon Web Services.

4. Selecione a caixa ao lado da política gerenciada pelo cliente que você criou na seção anterior (por exemplo, AWSCodeCommitPowerUser-MyDemoRepo).

5. Na página Análise, escolha Criar grupo. O IAM criará esse grupo com as políticas especificadas já anexadas. O grupo aparecerá na lista de grupos associados à sua conta da Amazon Web Services.

6. Escolha seu grupo na lista.

7. Na página de resumo do grupo, escolha a guiaUsuários e Adicionar usuários ao grupo. Na lista que mostra todos os usuários associados à sua conta da Amazon Web Services, selecione as caixas ao lado dos usuários aos quais você deseja permitir acesso ao CodeCommit repositório e escolha Adicionar usuários.

   dica

   Você pode usar a caixa Pesquisar para encontrar rapidamente usuários por nome.

8. Depois de adicionar os usuários, feche o console do IAM.

1. Abra o CodeCommit console em https://console.aws.amazon.com/codesuite/codecommit/home.

2. No seletor de região, escolha Região da AWS onde o repositório foi criado. Os repositórios são específicos para um Região da AWS. Para obter mais informações, consulte Regiões e endpoints de conexão do Git.

3. Na página Repositories (Repositórios), escolha o repositório que deseja atualizar.

4. Em Clone URL (Clonar URL), escolha o protocolo que você deseja que os usuários usem. Isso copia a URL clonada para o protocolo de conexão.

5. Envie aos usuários o URL do clone junto com quaisquer outras instruções, como instalar o AWS CLI, configurar um perfil ou instalar o Git. Não se esqueça de incluir as informações de configuração para o protocolo de conexão (por exemplo, HTTPS).