Git: interface gráfica com clonagem, histórico e implementação automática

Importante: atualmente dispõe da ferramenta Deploy+, que liga repositórios do GitHub, GitLab, Bitbucket e outros fornecedores e gere versões a partir da área de cliente. Tem mais informação em Deploy, ferramenta de implementação automática a partir do GitHub.

Pode trabalhar com o Git a partir da linha de comandos ou gerir repositórios através da interface do cPanel. Este guia descreve o fluxo do Git Version Control, independente do Deploy+.

O Git Version Control introduz uma interface gráfica para gerir o Git a partir do cPanel de forma simples, rápida e prática.

Criar um novo repositório

Ao aceder à opção Create, veremos um formulário. Por predefinição, mantém-se ativada a opção Clone, que, como o nome indica, permite clonar um repositório remoto através de um URL compatível. Utilize HTTPS ou SSH, verifique a identidade do servidor e evite incluir tokens no URL. Para repositórios privados, consulte o guia de clonagem com chave SSH.

Se desativarmos a opção Clone, podemos criar um repositório vazio, tal como faria git init, ou adicionar à interface um repositório que já exista no caminho indicado.

Repository Path é o caminho onde alojaremos o repositório (recomendamos que fique fora de public_html) e Repository Name é um nome para identificar o repositório criado.

Gerir opções

A partir da opção Manage temos acesso a opções básicas, como alterar o nome do repositório ou selecionar o ramo (branch) que estamos a usar; além disso, mostra o HEAD Commit, o URL remoto, no caso de ser um repositório clonado, e o URL do nosso repositório.

O acesso ao repositório que alojar é privado e faz-se através do protocolo SSH, pelo que quem aceder tem de ter uma identidade SSH autorizada, como se explica no guia de acesso SSH.

Pull ou deploy

Em Manage temos também o separador Pull or Deploy.

A opção Update from Remote atualiza a partir do repositório que usámos para clonar (caso tenhamos usado este método), aplicando as alterações que possam existir entre a origem e o nosso clone.

Por outro lado, Deploy HEAD Commit executa as tarefas do commit atual, conforme especificarmos no ficheiro .cpanel.yml, que permite definir estratégias de passagem para produção. Tratamos disto em detalhe em «Estratégias para implementação automática com Git».

History (Gitweb)

Através da opção History temos o histórico de commits e de alterações feitas no nosso repositório, podendo comparar versões, descarregar um snapshot e fazer pesquisas internas, entre outras funções que permitem rever o repositório em detalhe.

Eliminar o repositório

A função Remove retira o repositório da gestão do cPanel, mas não apaga o seu diretório nem os seus dados. Se também quiser eliminar os ficheiros, faça-o depois a partir do Gestor de ficheiros ou do terminal, após verificar o caminho e guardar qualquer cópia necessária.

Verificar uma atualização

Confirme o ramo e o commit antes de usar Update from Remote. Atualizar o clone não equivale a executar Deploy HEAD Commit. O resultado da publicação depende do .cpanel.yml: reveja os seus caminhos e tarefas antes da primeira utilização e acompanhe a saída até terminar.

Se o diretório clonado já for a raiz que serve o site, o próprio pull pode tornar visíveis ficheiros novos antes de as tarefas terminarem. Utilize uma estrutura de implementação planeada e teste a aplicação depois; a interface do Git não cria por si só um rollback da base de dados nem dos ficheiros publicados.