Painel
Visão geral do estado atual
Como usar
- Cadastre um servidor: nome, se é Local (mesma máquina do portal) ou Remoto (via SSH), e o caminho onde fica (ou vai ficar) o docker-compose.yml.
- Se a pasta ainda não tiver o código, toque em "Provisionar" — clona o repositório do zero, gera a chave e cadastra ela no GitHub automaticamente (precisa de uma conta cadastrada em Conexão GitHub).
- Se for remoto, cole o comando gerado no servidor de destino e depois toque em "Testar conexão".
- Depois de configurado, use o botão "Portas" pra trocar a porta do host no docker-compose.yml direto pela tela (útil pra rodar uma cópia de dev sem conflitar com a produção).
- Use o seletor no topo da tela para escolher qual servidor as outras abas (Programação, GitHub, Assinatura, Implantar) devem afetar.
Servidores cadastrados
Cada servidor tem suas próprias chaves, agendamento e histórico
Provisionar
Clona o repositório do zero, gera a chave e cadastra ela automaticamente no GitHub
Portas
Porta do host (esquerda) → porta do contêiner (direita, não muda)
Histórico de cadastro
Últimos servidores cadastrados ou provisionados
Cadastrar novo servidor
Local: outro projeto/contêiner nesta mesma máquina. Remoto: outra máquina, acessada por SSH.
Local
Mesma máquina do portal
Remoto
Outra máquina, via SSH
Como usar
- Escolha de quanto em quanto tempo o servidor verifica se há código novo no GitHub.
- Ligue o interruptor pra ativar a verificação automática — ela roda sozinha no servidor, mesmo com o portal fechado.
Intervalo de atualização
Com que frequência o portal verifica o GitHub por novidades
Como usar
- Se quiser escolher de uma lista em vez de digitar, cadastre uma conta do GitHub (com um token pessoal, escopo "repo") em "Buscar no GitHub" e toque em "Buscar repositórios".
- Toque em "Detectar agora" pra ver se o servidor já tem um repositório configurado (ex: feito manualmente antes).
- Se não houver, cadastre um novo repositório (nome + owner/repositório) — uma chave de leitura é gerada na hora.
- Cole a chave pública no GitHub do repositório (Settings → Deploy keys), sem marcar acesso de escrita.
- Toque em "Configurar automaticamente" e depois em "Testar conexão" pra confirmar.
Repositórios cadastrados
Repositórios GitHub ligados ao servidor selecionado acima
Detectar repositório já configurado
Verifica se o servidor selecionado já tem um Git configurado (ex: feito manualmente antes deste cadastro existir)
Buscar no GitHub
Lista repositórios de uma conta GitHub cadastrada, pra você escolher em vez de digitar
Não achou o repositório na lista? Cadastre manualmente
Cadastrar repositório manualmente
Gera automaticamente uma chave de leitura dedicada a este repositório
Como usar
- Gere a chave de assinatura.
- Cole a chave pública no GitHub em Settings → SSH and GPG keys, como Signing Key (não Authentication Key).
- Toque em "Aplicar configuração no Git" pra ativar a assinatura automática de commits e tags.
Chave de assinatura de commits
Assina commits e tags para comprovar que vieram deste servidor
Como usar
- Escolha o modo: Completa (reconstrói tudo) ou Parcial (só o que mudou, mais rápido).
- Toque em "Implantar agora" — roda em segundo plano.
- Acompanhe o resultado no histórico logo abaixo — toque numa linha pra ver o log completo daquela execução (útil quando algo falha).
Modo de implantação
Escolha como aplicar a próxima atualização
Completa
Reconstrói toda a stack do zero. Mais lento, mais previsível.
Parcial
Reconstrói só o(s) serviço(s) afetado(s) pela mudança. Mais rápido.
Histórico
Últimas implantações
Como usar
- Resumo do servidor selecionado no topo: se a atualização automática está ligada e qual foi o resultado da última implantação.
- Pra mudar algo, vá em Servidores e use as sub-abas Agendamento ou Implantar do servidor selecionado.
Estado atual
Resumo do agendamento e das últimas implantações
Como usar
- Assinatura digital: crie seu perfil (nome, NIF/CPF, país, e-mail) uma vez, depois cole qualquer conteúdo pra assinar — o portal testemunha e busca um carimbo de tempo externo independente. Não é uma assinatura qualificada (QES/ICP-Brasil) — veja o aviso no próprio certificado gerado.
- Backup de código: escolhe a conta do GitHub e o nome do repositório (privado), toca em "Fazer backup agora" — envia só o código, nunca segredos.
- Backup local: guarda `.env` e as chaves compactadas no próprio servidor, fora do alcance do GitHub — útil pra recuperar rápido se algo corromper.
- Qualquer usuário cadastrado pode gerenciar servidores, chaves e implantações — não há níveis de permissão.
- Cadastre um novo usuário com nome e senha (mínimo 8 caracteres).
- Não é possível remover o último usuário restante, pra evitar ficar sem acesso ao portal.
Backup do código (GitHub)
Envia o código-fonte do portal (sem .env nem chaves) pra um repositório privado dedicado
Backup local (dados sensíveis)
Chaves e configuração ficam só no próprio servidor, nunca no GitHub — arquivo compactado com permissão restrita
Google Drive (cópia externa)
Envia o backup local pra uma pasta "Servidor VPS Contabo" no seu Drive — protege contra o servidor cair de vez
Assinatura Digital (com testemunho)
Assinatura eletrônica avançada — não é QES europeia nem ICP-Brasil/gov.br. Veja o aviso completo no certificado gerado.
Crie seu perfil de assinatura (feito uma vez só) — esses dados identificam você no certificado.
Histórico de assinaturas
Usuários com acesso ao portal
Qualquer um deles pode gerenciar servidores, chaves e implantações
Cadastrar usuário
Senha com pelo menos 8 caracteres