Git: atualizar o seu site a partir de um repositório

Trabalha com Git, por exemplo com GitHub ou GitLab? Então pode, no DirectAdmin, em Git, criar um repositório no servidor ou associá-lo a um repositório externo. Assim, coloca uma nova versão do seu site no servidor com um clique (ou automaticamente).

Criar um repositório

1. No DirectAdmin, em Recursos Avançados, clique em Git.
2. Clique em CRIAR REPOSITÓRIO.
3. Em Domínio, encontra o domínio ao qual o repositório pertence.
4. Em Nome (1), introduza um nome, por exemplo website.
5. Pretende importar um repositório existente do GitHub, GitLab ou de outro serviço? Introduza então o endereço em Remoto (2).
6. Se esse repositório for privado, introduza em Arquivo de chave (3) a chave com a qual o servidor pode ler (veja abaixo).
7. Clique em CRIAR REPOSITÓRIO.

Se deixar o campo Remoto em branco, o DirectAdmin cria um repositório vazio no servidor, para o qual pode enviar (push) diretamente através de SSH (consulte Chaves do SSH e iniciar sessão com SSH).

Um repositório privado: uma chave de implementação (deploy key)

Para ler um repositório privado, o servidor precisa de uma chave própria. Crie-a, de preferência, apenas com permissão de leitura, como deploy key no GitHub ou GitLab. Coloque a parte pública junto do seu repositório (no GitHub: Settings, Deploy keys) e indique ao DirectAdmin o caminho para a parte privada no seu pacote. Para o endereço, utilize então o formato SSH, por exemplo git@github.com:oseunome/website.git.

Atualizar e implementar (deploy)

Clique na lista sobre o seu repositório. Aí, obtém a versão mais recente do repositório externo e coloca os ficheiros numa pasta do seu site (implementação). O DirectAdmin mostra também, nesse local, um endereço de webhook. Coloque esse endereço no seu repositório como webhook (no GitHub: Settings, Webhooks) e, assim, o servidor implementa automaticamente cada push.

Atenção: Mantenha o endereço de webhook confidencial. Qualquer pessoa que conheça o endereço pode iniciar uma nova implementação.

Bom saber

• Durante a implementação, os ficheiros com o mesmo nome são substituídos, mas os ficheiros que tenha removido do seu repositório permanecem no servidor. Remova-os você mesmo.
• Não coloque o repositório diretamente em public_html. Caso contrário, qualquer pessoa pode aceder à pasta .git com todo o seu histórico. Deixe o DirectAdmin implementar os ficheiros em public_html.
• Não coloque palavras-passe nem chaves de API no seu repositório. Guarde-as num ficheiro separado que não esteja no Git, como .env.
• Para executar o Composer ou o npm após uma implementação, utilize o Terminal de comando ou o SSH (consulte Terminal de comando no seu browser).