Como usar o SourceTree com o CodeCommit AWS no Windows


Levei algumas horas para conseguir fazer tudo funcionar corretamente, por isso gostaria de compartilhar todos os passos. O CodeCommit é seguro e de custo zero, mas não é simples de se usar. Ele pode integrar com outras “ferramentas” que pode proporcionar um ambiente de CI e CD de baixo custo.

Nessa publicação vou apresentar um passo a passo para quem quer colocar o primeiro projeto no CodeCommit.

1- Criando um usuário para acesso ao CodeCommit

Partindo do pré suposto que você já tem um usuário na AWS, uma boa prática é criar usuários específicos para sua empresa ou corporação, por isso que sugiro criar um usuário no IAM (Identity & Access Management), durante o processo de criação você deve gerar uma Security Credential e baixá-la, você vai precisar dessa informação nos próximos passos. Após criar ee permissão/policy a esse usário de AWSCodeCommitFullAccess (essa permissão vai dar acesso a todos os repositórios, mas é possível definir acesso à um grupo ou à um usuário a um repositório mas isso não será tratado aqui, pois envolve uma personalização de police do IAM).

Se você vai aproveitar um usuário existe, tenha a Security Credential dele ou peça para gerar uma nova. Além disso se esse usuário que você vai usar não for o mesmo usuário dono da conta do AWS valide se ele tem a permissão de AWSCodeCommitFullAccess.

2- Criando um repositório no CodeCommit

No dashboard do AWS acesse o CodeCommit, clique em Create New Repository, defina o nome do seu repositório e uma breve descrição caso queira.

3- Preparando o seu desktop para acessar o repositório

Todos os recursos da AWS funcionam através do aws-cli (uma aplicação de linha de commando da própria AWS baseado em python que permite fazer todas as operações que você pode realizar através da interface web e muito mais) e para autenticar no repositório precisaremos fazer uma configuração que tanto o GIT quanto o próprio Sourcetree utilize o metódo de autenticação através do AWS-CLI.

Para isso faça o download do aws-cli para windows no site do user guide da AWS você consegue as instruções mais detalhadas. Mas como esse guia é focado para windows, segue abaixo os links, espero que não mudem, mas se mudar ai vocês tem que pesquisar no user guide da AWS.

Windows 64bits

Windows 32bits

Ao baixar o arquivo instale com as opções padrões.

Após a instalação realizada com sucesso acesse a linha de comando do DOS.
Cadastre a Security Credential do usário que você irá acessar, para isso execute o comando abaixo.
# aws configure

O comando irá solicitar as seguintes informações:

AWS Access Key ID [None]: Informe o AWS access key ID aqui, e pressione Enter
AWS Secret Access Key [None]: Informe seu AWS secret access key aqui, e pressione Enter
Default region name [None]: Se seu codecommit esta na virgina informe us-east-1 aqui e pressione Enter
Default output format [None]: Informe json aqui e pressione Enter

Para testar se as permissões e os valores informados anteriormente estão corretos execute o comando abaixo, ele deve trazer o repositoryMetadata com os dados de acesso ao seu repositório com o comando abaixo:

#aws codecommit get-repository –repository-name NOMEDOREPOSITORIOCRIADO

Obs:. Algumas pessoas disseram que ao copiar a string acima não deu certo pois o aws reclamou de caracteres desconhecidos, sugiro escrever a linha acima e não copiar.

Retornando o valor correto baixe o git em linha de comando

https://git-for-windows.github.io/
Instale com as opções padrões exceto o Git Credential Manager, esse você precisa desabilitar. (com isso habilitado não vai funcionar)

Desabilitar o Git Credential Management

Desabilitar o Git Credential Management

 

Baixe e instale o AWS Tools for Windows PowerShell para administrar as credenciais da AWS
http://sdk-for-net.amazonwebservices.com/latest/AWSToolsAndSDKForNet.msi

Na instalação pode deixar apenas selecionado o “Command-line credential helper for AWS CodeCommit”

Abra o prompt do DOS
Acesse o diretório C:\Program Files (x86)\AWS Tools\CodeCommit
#cd C:\Program Files (x86)\AWS Tools\CodeCommit
Execute o comando
#git-credential-AWSS4.exe
Caso queira acessar o diretório pelo Windows Explorer e executar o arquivo acima, não tem problema.
Ira aparecer uma mensagem e confirme clicando em SIM/YES

Selecione Yes para reaizar a configuração

Selecione Yes para realizar a configuração

O SourceTree você pode fazer o download no site https://www.sourcetreeapp.com/ e utiliza-lo normalmente após essas configurações. Não testei outros clients mas acredito que funcione, se não funcionar me diga que podemos tentar fazer funcionar juntos.

4- Projetos vazios recém criados

Para projetos recém criados, você precisa executar alguns passos antes de usar o Sourcetree.
Através do git na linha de comando faça o clone do seu repositório já criado no codecommit.
#git clone https://git-codecommit.us-east-1.amazonaws.com/v1/repos/NOMEDOREPOSITORIO
Adicione um arquivo qualquer na pasta criada
No diretório onde colocou o arquivo adicione o arquivo ao projeto com o comando abaixo.
#git add .
Faça o commit da inserção desse novo arquivo
#git commit -m “first commit to create the master branch”
#git push origin master

Após a criação da primeira branch você consegue utilizar normalmente o repositório. Lembrando sempre terá o pré-requisito de instalar o AWS-CLI e o Command-line credential helper for AWS CodeCommit. Essas duas aplicações instaladas e configuradas você consegue utilizar a ferramenta.

Abra o sourcetree e adicione o projeto através do HTTPS e saia para o abraço.

Você pode seguir este artigo através do RSS 2.0 feed. Você pode deixar uma resposta, ou trackback do seu próprio site.

Deixe um Comentário

Time limit is exhausted. Please reload CAPTCHA.

*