> For the complete documentation index, see [llms.txt](https://aurimrv.gitbook.io/pratica-devops-com-docker-para-machine-learning/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aurimrv.gitbook.io/pratica-devops-com-docker-para-machine-learning/id-6-integracao-continua/6-3-configurando-um-repositorio-no-gitlab.md). # 6.3 Configurando um repositório no GitLab Vamos começar a colocar esses conceitos em prática então. Retomando a figura, estamos no passo 2, ou seja, vamos começar colocando um de nossos projetos nesse ciclo, iniciando pelo sistema de controle de versões. Utilizaremos o [GitLab](https://gitlab.com/). ![Fluxo de trabalho genérico e para o ciclo de vida do aplicativo em contêineres do Docker (extraída de Torre (2020))](https://docs.microsoft.com/pt-br/dotnet/architecture/containerized-lifecycle/docker-application-lifecycle/media/containers-foundation-for-devops-collaboration/generic-end-to-enddpcker-app-life-cycle.png) ## 6.3.1. Download e preparação do projeto Faremos o exemplo baseado no aplicativo para classificação de produtos que utiliza contêiner único. Faça o [download aqui](https://gitlab.com/aurimrv/bookdevopsml/-/blob/main/exemplos/aplicativos/README.md) e salve-o em seu computador (precisaremos apenas da pasta referente ao projeto da API HTTP com contêiner único). Caso ainda não exista, não se esqueça de criar e ativar um ambiente virtual para esse projeto. A estrutura de diretórios deve ser a seguinte: ![Página inicial do GitLab](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-22553dd48e112e43a11eaebe73d2458581930215%2Fintegracaocontinua2.png?alt=media\&token=487378c8-a18b-42fd-8090-ff1fb1331f37) Sempre certificando-se que o ambiente virtual está ativado, execute o comando `pip install -r requirements.txt` para instalar os pacotes caso necessário. ## 6.3.2. Configuração do repositório Agora vamos colocar esse projeto no [GitLab](https://gitlab.com/). A primeira coisa a fazer é criar uma conta de usuário. O processo é simples e rápido, basta acessar a página e seguir as instruções. Assim que estiver concluído, você verá a página inicial: ![Página inicial do GitLab](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-035737260b572bf1420a4c30a07e686d0082da72%2Fintegracaocontinua1.png?alt=media\&token=40181de7-2b8b-439a-b851-32a561495409) Crie um novo projeto vazio, e escolha um nome para ele. O importante é que este nome seja único dentro do seu conjunto de repositórios. Vamos escolher "classificador-produtos". Também é importante escolher a visibilidade. A opção "Private" mantém o repositório inacessível a outros usuários, permitindo que você libere o acesso apenas a quem desejar, enquanto a opção "Public" permite que qualquer pessoa consiga vê-lo, o que é ideal para projetos abertos, open source, etc. Para este exemplo, tanto faz a opção. Por último, vamos desmarcar a opção "Initialize repository with a README", pois queremos inicializar o repositório com a pasta que acabamos de criar. As Figuras a seguir ilustram as opções a serem adotadas para este exemplo. ![Criação de projeto no GitLab - parte 1](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-1a072ff8f593daa909687b3b9d414a902ee494d9%2Fintegracaocontinua3.png?alt=media) ![Criação de projeto no GitLab - parte 2](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-bde141381f79c9ffb81006adf2c4e61b87ab5b85%2Fintegracaocontinua4.png?alt=media) Ao concluir a criação do projeto, você será levado até sua página inicial. Lá serão exibidas algumas informações interessantes. Uma delas é uma sequência de comandos para configurar seu usuário padrão do GitLab na máquina (não se preocupe, isso pode ser alterado posteriormente caso queira outros usuários): ```sh git config --global user.name "Daniel Lucrédio" git config --global user.email "daniel.lucredio@ufscar.br" ``` Em seguida, precisamos configurar uma forma segura para acessar o repositório a partir da nossa máquina local. Há diferentes formas para fazer isso. Faremos utilizando um *token* de acesso pessoal. Clique no ícone para editar seu perfil, no canto superior direito da página: ![Criando um token de acesso pessoal - parte 1](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-ad07165a8c1517123b4780ccbd35d10f4d5429fe%2Fintegracaocontinua5.png?alt=media) Em seguida, clique em "Personal Access Tokens", "Generate Token" e escolha a opção "Legacy token" (que será substituída no futuro): ![Criando um token de acesso pessoal - parte 2](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-08fc5c9aef2ed1c3326e5baa25bbbb1ecf1cedb6%2Fintegracaocontinua6.png?alt=media) Na página que aparecer, escolha um nome para seu token (no exemplo, colocamos "notebook-samsung"), ative a opção `write_repository`, e crie o token. Se quiser definir uma data para que o token expire, é possível. Caso deixe em branco, o *token* terá validade indeterminada. ![Criando um token de acesso pessoal - parte 3](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-96c4196018fe883b2b6954081f7e5c22d032b94a%2Fintegracaocontinua7.png?alt=media) Assim que o processo for concluído, será exibido o *token* criado. Conforme as instruções, copie-o agora e salve-o em algum local seguro, pois o mesmo não poderá ser visto novamente assim que sair da página (será necessário revogá-lo e criar novamente). ![Criando um token de acesso pessoal - parte 4](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-afa6cfeecc2262f06004cad18d4aef9ca7a3daaa%2Fintegracaocontinua8.png?alt=media) Agora podemos inicializar nosso repositório com o conteúdo que criamos anteriormente. Abra um terminal e navegue até a pasta com o projeto `classificador-produtos`. Execute os seguintes comandos, substituindo o nome ("notebook-samsung") e conteúdo do token (`xxxxxxxxxxxxxxxxxxxxx`) pelos valores que você acabou de criar. ```sh git init --initial-branch=main git remote add origin https://notebook-samsung:xxxxxxxxxxxxxxxxxxxxxxxxxxx@gitlab.com/daniel.lucredio/classificador-produtos.git git add . git commit -m "Initial commit" git push -u origin main ``` Uma outra opção é seguir as instruções que aparecem na página inicial do projeto vazio. Porém, neste caso, pode ser necessário configurar outra forma de login e autenticação, uma vez que o token não estará automaticamente configurado no repositório. Se tudo der certo, algo parecido com o seguinte deve aparecer no terminal: ``` Enumerating objects: 12, done. Counting objects: 100% (12/12), done. Delta compression using up to 8 threads Compressing objects: 100% (9/9), done. Writing objects: 100% (12/12), 434.51 KiB | 5.79 MiB/s, done. Total 12 (delta 0), reused 0 (delta 0), pack-reused 0 To https://gitlab.com/daniel.lucredio/classificador-produtos.git * [new branch] main -> main branch 'main' set up to track 'origin/main'. ``` Acessando a página do projeto no GitLab, você deve conseguir ver o mesmo conteúdo que criamos anteriormente: ![Inicialização do repositório aparecendo no GitLab](https://2167929857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjISexK2k1gRWKUt6SseU%2Fuploads%2Fgit-blob-455ffb4bdb64351f698f7c4fe7a7015a09d820f5%2Fintegracaocontinua9.png?alt=media) Não é aqui o objetivo ensinar todos os detalhes e procedimentos para utilização do `git`. Existem muitos tutoriais, livros e artigos sobre o assunto, sendo de fácil acesso e aprendizado. Deixamos para o leitor a tarefa de se familizarizar com o uso desse sistema para controle de versões. Mas iremos demonstrar a seguir o processo de criação de uma "branch" e o processo de "merge", pois é importante para a integração contínua.