SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-10-27

Servidor Git auto-hospedado: Forgejo, Gitea ou cgit

Compare 4 formas de hospedar Git por RAM: repositorios bare via SSH, cgit, Forgejo ou Gitea e GitLab. Saiba o que cabe em um VPS de 1 GB.

Qual servidor Git auto-hospedado deve executar

Um servidor Git auto-hospedado não é um produto único, e a RAM (memória de acesso aleatório) da sua VPS determina qual versão pode utilizar. O Git não precisa de um daemon próprio: um repositório bare e uma conta SSH (secure shell) já formam um servidor funcional na menor máquina que você pode alugar. Tudo acima desse nível é uma aplicação web que você escolhe executar ao lado dele, e cada etapa exige memória que uma VPS pequena talvez não tenha. Se ainda não está claro onde o Git termina e o GitHub começa, como o Git, o GitHub e um servidor Git próprio diferem explica essa divisão antes de você escolher um plano.

Existem quatro níveis. Um repositório bare através de SSH, sem nenhum serviço novo em escuta. cgit, uma interface web rápida e apenas de leitura, sem base de dados. Forgejo ou Gitea, uma forge completa com contas, issues e pull requests, em algumas centenas de megabytes. GitLab, que espera um servidor muitas vezes maior do que os restantes.

Decida com base no trabalho que precisa de realizar. Depois compare o valor de memória com o plano que está a pagar.

Quanta RAM cada opção realmente precisa

Apenas dois destes projetos publicam um valor de hardware. Considere um valor publicado como o mínimo, não como uma garantia, e meça a sua própria instância depois de a iniciar, com systemd-cgtop ou ps -o rss= -C forgejo.

GráficoRAM the projects document, official docs, October 2026
Os dados por trás deste gráfico
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

A documentação do Gitea indica 1 GB de RAM e 2 núcleos de CPU como normalmente suficientes para equipas e projetos pequenos. Também indica um Raspberry Pi 3 como suficiente para cargas de trabalho pequenas. A documentação do GitLab indica 16 GB como referência para uma instalação num único nó e 8 GB como o limite inferior para aquilo a que a própria página chama um ambiente com memória limitada. O Forgejo não publica qualquer requisito de hardware. É um fork do Gitea e comporta-se de forma semelhante, por isso o valor indicado pelo Gitea é a orientação publicada mais próxima de que dispõe.

Num VPS com 1 GB, repositórios bare e cgit funcionam com memória disponível, porque nenhum dos dois executa um serviço residente. O Forgejo ou o Gitea inicia e serve uma equipa pequena com SQLite, mas está no limite mínimo documentado. Por isso, mantenha o PostgreSQL e o runner de CI (integração contínua) fora desse servidor. Se a interface Web desaparecer sem apresentar um erro, execute sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' e procure uma linha semelhante a Out of memory: Killed process 1181 (forgejo). Isso significa que o out of memory killer do kernel terminou o processo. O GitLab num servidor com 1 GB não é um problema de afinação. Não vai funcionar.

Nível 0: um repositório bare através de SSH

O Git não tem nenhum daemon de rede que seja necessário iniciar. git push através de SSH executa git-receive-pack no sistema remoto como um processo Unix normal, por isso qualquer conta à qual consiga aceder com uma chave já é um remote Git. Crie uma conta para os repositórios e mantenha os repositórios fora do diretório home dessa conta, porque, no Ubuntu 24.04, um novo diretório home tem o modo 0750 e uma interface web adicionada mais tarde não conseguirá aceder ao seu conteúdo.

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
  --group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git

--bare cria um repositório sem working copy, que é o que um servidor mantém. Por predefinição, o push para o branch com checkout de um repositório que tenha uma working copy é recusado com refusing to update checked out branch: refs/heads/main. Esse é o erro mais comum neste nível.

Agora dê uma chave à conta e faça clone do repositório.

sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keys
git remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin main

Um primeiro push bem-sucedido termina com * [new branch] main -> main. Um push que termina com git@vps.example.com: Permission denied (publickey) nunca foi autenticado, por isso consulte o log do servidor com sudo journalctl -u ssh -n 20. Uma linha com Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys significa que o modo do ficheiro está incorreto, porque o sshd ignora um ficheiro de chaves que possa ser alterado por outros utilizadores.

Se o origin do projeto já aponta para o GitHub, o git remote add origin termina com error: remote origin already exists., e adicionar este servidor como uma segunda URL de push nesse remote permite que um git push atualize ambos.

Depois, retire a shell da conta.

command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" git

git-shell aceita apenas os poucos comandos que o Git envia através de SSH, por isso um início de sessão interativo termina agora com uma mensagem, em vez de apresentar uma prompt:

fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.

Esse é todo o servidor. Não há uma base de dados nem um processo web para atualizar. Em contrapartida, perde tudo o que uma forge oferece: não há navegação dos repositórios, issue tracker, pull requests nem permissões por utilizador. Todas as chaves nesse ficheiro podem ler e escrever em todos os repositórios pertencentes ao utilizador git.

Camada 1: cgit fornece uma interface web sem uma base de dados

cgit é um programa CGI (common gateway interface) escrito em C. O servidor web executa-o uma vez por pedido, lê os repositórios diretamente do disco e não guarda estado próprio. O Ubuntu 24.04 inclui-o no componente universe.

sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgit

Indique o diretório dos repositórios em /etc/cgitrc:

root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/git

scan-path percorre esse diretório e lista todos os repositórios encontrados. Assim, um novo repositório bare aparece sem configuração adicional. cache-size é o número de páginas em cache. O armazenamento em cache fica desativado enquanto esse valor for zero. Leia o conteúdo que o pacote já colocou em /etc/cgitrc antes de adicionar linhas, porque os pacotes Debian e Ubuntu fornecem alguns valores predefinidos.

Cada entrada mostra a primeira linha do ficheiro description do repositório. Por isso, um repositório bare novo aparece como Unnamed repository; edit this file 'description' to name the repository.. Corrija esse valor uma vez por repositório:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
O ficheiro do site nginx e como o verificar
server {
    listen 80;
    server_name git.example.com;
    root /usr/share/cgit;

    try_files $uri @cgit;

    location @cgit {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
        fastcgi_param PATH_INFO $uri;
        fastcgi_param QUERY_STRING $args;
        fastcgi_param HTTP_HOST $server_name;
        fastcgi_pass unix:/run/fcgiwrap.socket;
    }
}
sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listen

root /usr/share/cgit serve cgit.css e cgit.png como ficheiros simples, e try_files encaminha tudo o resto para o CGI em /usr/lib/cgit/cgit.cgi. Uma página 502, com connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) em /var/log/nginx/error.log, significa que a unidade do socket não está em execução ou está a escutar noutro caminho. A linha systemctl show mostra o caminho que está efetivamente a utilizar.

Há dois limites que deve conhecer antes de o utilizar. cgit é apenas de leitura e não tem autenticação. Por isso, tudo em scan-path é público: mantenha os repositórios privados fora desse diretório ou coloque autenticação HTTP basic à frente de todo o site. Além disso, o CGI é executado com o utilizador do servidor web. Esse utilizador precisa de atravessar /srv/git e de ler cada repositório. Um diretório que não consiga abrir aparece como um índice vazio, e não como um erro.

Nível 2: Forgejo ou Gitea para issues e pull requests

Forgejo e Gitea seguem a mesma ideia: um único binário Go que fornece uma forja web com utilizadores, organizações, issues, pull requests, releases, um registo de pacotes e um sistema de CI integrado. O binário e o SQLite constituem toda a instalação, razão pela qual cabem em hardware onde o GitLab não funciona. O ficheiro Compose abaixo é o da documentação do Forgejo, com a tag da imagem indicada nessa documentação em 24 October 2026.

networks:
  forgejo:
    external: false

services:
  server:
    image: codeberg.org/forgejo/forgejo:17
    container_name: forgejo
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - forgejo
    volumes:
      - ./forgejo:/data
      - /etc/localtime:/etc/localtime:ro
    ports:
      - '3000:3000'
      - '222:22'

Essa tag 17 segue a linha v17. O Forgejo v17.0.0, lançado em 15 October 2026, é a versão estável atual, e o Forgejo suporta a v17 até 28 January 2027. A linha v16 mais antiga perde suporte em 29 October 2026, por isso uma instalação existente que ainda use a tag 16 deve ser atualizada agora. Passar mais tarde de uma versão principal para a seguinte exige uma atualização manual, por isso é mais simples começar pela versão atual.

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1

A linha curl deve mostrar uma linha de estado HTTP. Antes de concluir a configuração inicial, pode mostrar um redirecionamento para /install, o que ainda significa que o serviço está ativo. Se o contentor terminar, a causa habitual são as permissões: o diretório ./forgejo tem de pertencer ao UID (ID do utilizador) indicado em USER_UID, caso contrário o processo não consegue escrever no seu próprio diretório de dados. Docker Compose numa VPS explica detalhadamente essa disposição dos ficheiros e a regra de propriedade do volume.

Duas respostas na página de configuração determinam se os URLs de clone funcionam. A porta SSH deve ser o lado do host do mapeamento SSH, que no ficheiro Compose acima é 222, porque mapeia a porta 222 do host para a porta 22 do contentor. Nada exige a porta 222: qualquer porta livre do host funciona, desde que o mapeamento e esta resposta sejam iguais. O domínio também deve ser o nome que as pessoas vão realmente introduzir. Se qualquer um dos dois estiver errado, todas as páginas de repositórios apresentam um comando de clone que falha para qualquer pessoa que o copie. Depois, ambos ficam na secção [server] de app.ini, como SSH_PORT, SSH_DOMAIN e ROOT_URL.

Numa instância pública, publique a porta web apenas no endereço de loopback ('127.0.0.1:3000:3000') e coloque o nginx à frente para tratar do TLS (segurança da camada de transporte). O Gitea instala-se da mesma forma a partir da imagem docker.gitea.com/gitea usada pela respetiva documentação, ou como um único binário com uma unidade systemd e um único app.ini. A versão estável atual é a v28.2.0, publicada em 18 October 2026. Com a v28.0.0, no final de September, o projeto removeu o prefixo 1. antigo, por isso a versão seguinte à 1.27 é a 28, não a 1.28.

Mantenha o SQLite enquanto for possível. Assim, a instância fica limitada a um processo e a um ficheiro, e sobrevive a um reboot sem outro serviço para supervisionar. O PostgreSQL compensa o custo quando várias pessoas escrevem em simultâneo, porque o SQLite serializa as escritas e as execuções longas de CI escrevem continuamente. Ambos os projetos permitem migrar mais tarde uma instância existente para PostgreSQL, por isso esta não é uma decisão definitiva.

Forgejo ou Gitea: o que realmente difere

A origem é partilhada. O Gitea foi criado a partir do Gogs em 2016. No final de 2022, o controlo do domínio e da marca registada Gitea passou para uma empresa, a Gitea Ltd, e vários maintainers, juntamente com o Codeberg, iniciaram o Forgejo. O Forgejo é desenvolvido pela sua comunidade sob a tutela da Codeberg e.V., uma associação sem fins lucrativos registada na Alemanha que detém os domínios do projeto, enquanto a governação permanece com os próprios contribuidores do Forgejo. Em 2024, mudou da licença MIT para a GPLv3 (GNU general public license version 3). O Gitea continua sob a licença MIT e é desenvolvido com apoio comercial.

No dia a dia, os conjuntos de funcionalidades são semelhantes. O percurso entre os dois não é. O Forgejo v10.0, de janeiro de 2025, foi a última release que podia importar diretamente uma base de dados do Gitea, e apenas do Gitea v1.22 ou anterior. Em outubro de 2026, o Gitea está na v28.2.0, pelo que uma instância Gitea atual não tem uma migração suportada no local para Forgejo. Escolha um dos projetos antes de o preencher com dados e trate qualquer migração posterior como uma exportação seguida de uma nova importação.

Uma regra simples para escolher. Se a governação for importante para si, ou se quiser um projeto sob a tutela de uma organização sem fins lucrativos, use Forgejo. Se quiser uma base instalada maior e uma opção de suporte comercial, use Gitea. Ambos são mantidos de forma aberta e lançam releases com frequência: o Forgejo disponibiliza uma release estável a cada três meses e uma release LTS (long term support) por ano, com a v17.0.0 atual e a v15.0.10 como LTS em 24 de outubro de 2026. O Forgejo suporta a v17 até 28 de janeiro de 2027 e a v15 até 15 de julho de 2027, enquanto o suporte da v16 termina em 29 de outubro de 2026. Consulte a página de releases antes de fixar uma versão major.

Tier 3: quanto o GitLab consome antes de fazer qualquer coisa

O GitLab CE pertence a uma categoria diferente de software. Uma instância é formada por vários serviços cooperantes: Puma para a aplicação Web, Sidekiq para tarefas em segundo plano, PostgreSQL, Redis, Gitaly para acesso aos repositórios e nginx à frente. O pacote Omnibus instala todos estes componentes em conjunto. Isto simplifica a instalação, mas eleva o consumo mínimo de memória.

A página de requisitos do GitLab documenta 16 GB de RAM e 8 vCPU como referência para uma instalação de nó único, indicando 8 GB como o limite inferior num ambiente com memória limitada. A mesma página recomenda desativar a swap, porque a troca para disco sob carga degrada bastante a instância. Estes são os valores publicados em outubro de 2026. Eles aumentaram ao longo dos anos, por isso consulte novamente a página antes de dimensionar um servidor.

Esse orçamento fornece funcionalidades concretas: um container registry, um package registry, permissões granulares, funcionalidades de conformidade e auditoria e CI testada em grande escala. Se ninguém na sua equipa conseguir indicar uma funcionalidade dessa lista de que precise neste trimestre, estará a pagar por um VPS maior sem obter qualquer benefício.

O modelo de acesso SSH: um utilizador git e muitas chaves

Todas as camadas aqui autenticam da mesma forma. Existe uma conta Unix chamada git, e todas as chaves públicas são colocadas no ~/.ssh/authorized_keys dessa conta. A autenticação é feita pela chave. A autorização é definida pelas opções que escreve antes da chave na mesma linha.

Uma linha de chave simples concede ao titular tudo o que essa conta pode fazer. Um comando forçado limita o acesso ao Git:

restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop

restrict, disponível desde o OpenSSH 7.2, desativa o encaminhamento de portas, o encaminhamento do agente, o X11 e a alocação de PTY (terminal pseudo). command= substitui o comando solicitado pelo cliente pelo comando indicado, e o Git continua a funcionar porque envia o pedido em $SSH_ORIGINAL_COMMAND.

Uma forge escreve esse ficheiro por si, e essa é a diferença real entre a camada 0 e a camada 2. Quando funcionam atrás do servidor OpenSSH do sistema, que é a configuração predefinida, Forgejo e Gitea reescrevem authorized_keys com uma linha por cada chave registada. Cada linha contém um comando forçado que identifica a chave pelo ID na base de dados:

command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice

Esse comando forçado transforma uma conta Unix partilhada em permissões por utilizador: key-3 informa a forge sobre o utilizador que está a ligar-se, e a forge compara esse utilizador com o repositório antes de transferir qualquer objeto. Não edite manualmente esse ficheiro num servidor gerido pela forge, porque ele é reescrito a partir da base de dados e a sua linha desaparece. Se ativar o servidor SSH integrado da forge, ou se configurar o OpenSSH para pedir as chaves à forge através de AuthorizedKeysCommand, a forge não precisa desse ficheiro. No segundo caso, ambos os projetos recomendam desativar a sua criação. As chaves de implementação usam o mesmo mecanismo: uma chave de implementação é uma chave SSH normal registada num único repositório, normalmente com acesso apenas de leitura. A verificação é feita pela forge, e não pelo sshd.

Dois hábitos são mais importantes do que qualquer configuração acima. Emita uma chave por pessoa ou por máquina, nunca uma chave partilhada, porque revogar uma chave partilhada obriga a substituí-la para todas as pessoas ao mesmo tempo. Remova as chaves no dia em que alguém sair, porque uma chave antiga nesse ficheiro é um acesso permanente que ninguém está a monitorizar. Boa gestão de chaves SSH num servidor aborda os tipos de chave e as frases-passe, e tudo isso se aplica aqui sem alterações. Se o servidor for novo, os primeiros dez minutos num VPS novo é o procedimento correto antes de colocar repositórios nele.

Posso executar o GitHub Actions no meu próprio servidor Git?

Pode executar workflows escritos na sintaxe do GitHub Actions. Não pode executar o GitHub. O Forgejo Actions está ativado por predefinição desde o Forgejo v1.21 e lê os ficheiros de workflow em .forgejo/workflows de cada repositório. O Gitea Actions funciona da mesma forma e lê .gitea/workflows. Ambos precisam de um segundo programa, o runner, instalado e registado na sua instância com um token obtido nas definições de administrador. Muitas actions publicadas funcionam sem alterações; as que chamam a API do GitHub ou esperam infraestrutura alojada pelo GitHub não funcionam.

Tenha em conta duas consequências. Com as etiquetas de contentor habituais, o runner inicia um contentor para cada job. Por isso, precisa do seu próprio motor de contentores e de um orçamento de memória próprio. É por esse motivo que não deve ficar na mesma máquina de 1 GB que o forge. Ambos os runners também podem executar jobs diretamente no host, através de uma etiqueta terminada em :host no Forgejo. Esta opção não precisa de um motor, mas também não coloca nenhum contentor entre o job e essa máquina. Além disso, o runner executa tudo o que o ficheiro de workflow indicar. A documentação do Forgejo afirma isso claramente: o runner executa código remotamente. Se possível, atribua-lhe o seu próprio host. No mínimo, use um utilizador sem privilégios próprio e um token de registo limitado a um único repositório.

Se os seus repositórios continuarem no GitHub e quiser apenas executar os jobs em hardware sob o seu controlo, trata-se de uma configuração diferente, com passos diferentes: um runner self-hosted do GitHub Actions associa-se a um repositório do GitHub e não precisa de nada disto. Se ainda estiver a avaliar o custo de sair, o que o GitHub oferece realmente separa o alojamento Git da rede que o envolve.

Backups: repositories são apenas metade do estado

Um repositório bare é um diretório, portanto copiá-lo copia tudo o que contém. Um clone mirror de outra máquina é uma cópia de segurança real e é atualizado no local:

git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote update

Isto obtém todas as refs e todos os objetos. Não obtém os hooks do servidor nem o ficheiro description. Se usar hooks, mantenha também uma cópia ao nível dos ficheiros do diretório.

Uma forge mantém issues, pull requests, utilizadores, chaves e permissões na base de dados. Uma cópia apenas dos repositórios elimina todos esses dados. Ambos os projetos disponibilizam um comando dump que grava a base de dados, os repositórios, a configuração e os anexos num único arquivo:

sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zip

No Docker, o mesmo comando é executado dentro do contentor. O caminho da configuração depende da imagem, por isso confirme-o antes de executar o comando:

docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.ini

Execute-o como o utilizador proprietário dos dados e grave o arquivo num diretório onde esse utilizador tenha permissões de escrita. Depois, copie o arquivo para fora do servidor. Uma cópia de segurança que só existe na máquina que está a ser protegida não é uma cópia de segurança. Restaurar é a etapa que muitas pessoas ignoram: descompacte agora um dump numa máquina sobressalente, para aprender o procedimento num momento tranquilo, em vez de o fazer durante uma interrupção.

Escolha por cenário

Uma pessoa com um laptop e um VPS, sem necessidade de navegação: repositórios bare por SSH. Não há nenhum serviço adicional em execução nem nada para atualizar.

O mesmo cenário, mas com a necessidade de ler código num navegador e enviar links para ele: adicione o cgit. Continua sem base de dados e sem processos residentes.

Uma equipa que revê o código uns dos outros e acompanha problemas: Forgejo ou Gitea, com 2 GB de RAM ou mais. Mova o runner de CI para uma segunda máquina quando os jobs se tornarem relevantes.

Uma organização que precisa de um registry de containers e de trilhos de auditoria, com 16 GB disponíveis para o servidor: GitLab. Abaixo desse orçamento, não o inicie.

Subir pelos três primeiros níveis é barato, porque em todos eles os repositórios são diretórios Git normais no disco. Comece pelo nível mais baixo que resolve o problema. Se estiver a decidir que outros serviços justificam espaço no mesmo servidor, a lista curta do que vale a pena alojar por conta própria coloca um servidor Git ao lado dos outros serviços que competem por essa RAM.

FAQ

Um VPS com 1 GB pode executar Forgejo ou Gitea?

Sim, para uma equipa pequena, com SQLite e sem outros serviços pesados no servidor. A documentação do Gitea indica que 1 GB de RAM e 2 núcleos de CPU são normalmente suficientes para equipas e projetos pequenos, e o Forgejo é um fork do Gitea com requisitos semelhantes. Não adicione PostgreSQL nem um runner de CI a essa máquina. Se o serviço desaparecer sem apresentar erros no próprio log, execute sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': uma linha que identifique o processo terminado significa que o killer de falta de memória do kernel o terminou. Nesse caso, a solução é escolher um plano maior, não ajustar uma flag.

Qual é a diferença entre Forgejo e Gitea?

Partilham o histórico da base de código e a maioria das funcionalidades. O Gitea foi criado a partir do Gogs em 2016, e o Forgejo foi criado a partir do Gitea no final de 2022, depois de o controlo da marca registada Gitea ter passado para uma empresa. O Forgejo é desenvolvido pela sua comunidade sob a responsabilidade da Codeberg e.V., uma organização sem fins lucrativos na Alemanha, e é lançado sob a licença GPLv3. O Gitea continua sob a licença MIT e tem apoio comercial. A diferença prática está no caminho de migração. O Forgejo v10.0, lançado em January 2025, foi a última release capaz de importar diretamente uma base de dados do Gitea, e apenas a partir do Gitea v1.22 ou anterior. Por isso, uma instância atual do Gitea não tem uma migração suportada no local.

Posso executar workflows do GitHub Actions num servidor Git self-hosted?

O Forgejo Actions e o Gitea Actions executam workflows escritos na sintaxe YAML do GitHub Actions, lidos de .forgejo/workflows e .gitea/workflows. É necessário instalar um programa runner separado e registá-lo na sua instância. Muitas actions publicadas funcionam sem alterações, mas qualquer action que chame a API do GitHub não funciona. O runner executa código arbitrário dos seus repositórios e, com as etiquetas de contentor habituais, inicia um contentor por job. Por isso, atribua-lhe o seu próprio host ou, pelo menos, o seu próprio utilizador sem privilégios. Não o execute num servidor com 1 GB que já esteja a executar o forge.

Como faço uma cópia de segurança de um servidor Git self-hosted?

Para repositórios bare, git clone --mirror, executado a partir de outra máquina, copia todas as refs e todos os objetos. O comando git remote update, executado dentro desse mirror, atualiza-o. No Forgejo ou Gitea, os repositórios são apenas parte do estado, porque os issues, pull requests, utilizadores e chaves ficam na base de dados. Use o dump integrado, sudo -u git forgejo dump -c /etc/forgejo/app.ini, ou o mesmo comando dentro do contentor numa instalação Docker. Copie o arquivo para fora do servidor e restaure-o uma vez numa máquina sobressalente para confirmar que o procedimento funciona.

Este artigo foi útil?

#git#self-hosting#forgejo#gitea#ssh