4.8 Git no Servidor - GitLab

O GitLab é um aplicativo da Web baseado em banco de dados, por isso a sua instalação é um pouco mais trabalhosa do que alguns outros servidores Git. Felizmente, este processo é muito bem documentado e apoiado.

Existem alguns métodos que tu podes seguir para instalar o GitLab. Para obter algo em execução rapidamente, podes descarrear uma imagem de máquina virtual ou um instalador de um clique em https://bitnami.com/stack/gitlab e ajustar a configuração para que corresponda ao teu ambiente particular.. Um toque agradável que Bitnami incluiu é o ecrã de login (acedida digitando alt-→); Ele informa o endereço IP e o nome de utilizador e senha padrão para o GitLab instalado.

Para qualquer outra coisa, sigue as orientações no readme do GitLab Community Edition, que pode ser encontrado em https://gitlab.com/gitlab-org/gitlab-ce/tree/master. Lá encontrarás assistência na instalação do GitLab usando receitas do Chef, a máquina virtual no Digital Ocean, e os pacotes RPM e DEB (que, no momento em que este texto foi escrito, estava na versão estável Omnibus, para os sistemas operacionais Ubuntu 14.04, Ubuntu 16.04, Debian 7, Debian 8, CentOS 6, CentOS 7, OpenSUSE 42.1 e Raspberry PI 2 em Raspbian). Há também guias com orientações “não oficiais” para que o GitLab funcione em sistemas operacionais e bases de dados diferentes dos citados acima, um script para instalação completamente manual e muitos outros tópicos.

A interface de administração do GitLab é acedida através da web. Basta apontar o teu navegador para o nome do host ou endereço IP onde o GitLab está instalado e efetuar login como um utilizador admin. O nome de utilizador padrão é admin@local.host e a senha padrão é 5iveL!fe (que tu serás solicitado a alterar assim que entrares nele). Depois de efetuares o login, clica no ícone “Área de administração” no menu no canto superior direito.

A primeira coisa que vais querer fazer com o GitLab é criar um novo projeto. Isto é feito clicando no ícone “+” na barra de ferramentas. Ser-te-á pedido o nome do projecto, a qual namespace ele deverá pertencer e que nível de visibilidade deverá ter. A maior parte do que tu especificas aqui não é permanente e pode ser reajustada posteriormente através da interface de configurações. Clica em “Criar projeto” e pronto.

Uma vez que o projeto exista, provavelmente vais querer conectá-lo com um repositório Git local. Cada projeto é acessível através de HTTPS ou SSH, sendo que ambos podem ser usados para configurar um Git remoto. As URLs estão visíveis na parte superior da página inicial do projeto. Para um repositório local existente, este comando criará um remoto chamado gitlab para o local hospedado:

Se não tens uma cópia local do repositório, podes simplesmente fazer isto:

A interface do utilizador da Web fornece o acesso a várias visualizações úteis do próprio repositório. A página inicial de cada projeto mostra as atividades recentes e os links ao longo do topo levam-te a exibições dos arquivos do projeto e do log de commits.

A maneira mais simples de trabalhar juntos num projeto GitLab é dar a outro utilizador acesso direto de push (envio de commits) ao repositório Git. Podes adicionar um utilizador a um projeto indo para a seção “Membros” das configurações deste projeto e associando o novo utilizador com um nível de acesso (os diferentes níveis de acesso estão um pouco descritos em Grupos). Ao fornecer a um utilizador um nível de acesso de “Desenvolvedor” ou superior, este utilizador pode empurrar branches e ramificações diretamente para o repositório.

Outra maneira mais dissociada de colaboração é usar solicitações de mesclagem. Este recurso permite que qualquer utilizador que possa ver um projeto contribua para ele de forma controlada. Os utilizadores com acesso direto podem simplesmente criar uma ramificação, empurrá-la para ele e abrir uma solicitação de mesclagem do seu ramo de volta para master ou qualquer outra ramificação. Os utilizador que não têm permissões push para um repositório podem "fork" (criar sua própria cópia), push commit para aquela cópia e abrir uma solicitação de mesclagem de sua bifurcação de volta para o projeto principal. Este modelo permite que o proprietário esteja no controle total do que entra no repositório e quando, embora permita contribuições de utilizadores não confiáveis.

Os pedidos de mesclagem e os problemas são as principais unidades de discussão de longa duração no GitLab. Cada solicitação de mesclagem permite uma discussão linha a linha da alteração proposta (que suporta um tipo leve de revisão de código), bem como um tópico geral de discussão geral. Ambos podem ser atribuídos a utilizador ou organizados em marcos.

Esta seção é focada principalmente nos recursos relacionados ao Git do GitLab, mas como um projeto maduro, ele fornece muitos outros recursos para ajudar a tua equipa a trabalhar em conjunto, como wikis de projeto e ferramentas de manutenção do sistema. Um benefício para o GitLab é que, uma vez que o servidor está configurado e em execução, tu raramente precisarás ajustar um arquivo de configuração ou aceder o servidor via SSH; A maior parte da administração e o uso geral podem ser realizados através da interface no navegador.