Primeiro admin e publicação

Antes de criar o administrador, o serviço do projeto precisa ter subido ao menos uma vez, como em VPS e variáveis. Na primeira subida, o servidor prepara o banco de dados, e o comando de administrador grava nesse banco.

Criar o administrador

O comando é slash admin create --email <e-mail>. Rode-o como o usuário do serviço e na pasta do projeto. O exemplo usa o slash do slash-kit pelo caminho do cli/bin.ts, como no README do projeto. Troque /opt/slash-kit/cli/bin.ts pelo caminho em que o slash-kit está na VPS, legível pelo usuário do serviço:

sudo -u slash-<projeto> -H sh -c 'cd /srv/<projeto> && /home/slash-<projeto>/.bun/bin/bun /opt/slash-kit/cli/bin.ts admin create --email admin@exemplo.com.br'

O comando pede a senha duas vezes, no terminal. Nada aparece na tela enquanto você digita, e a senha nunca entra pelos argumentos, que o shell guarda no histórico. A senha precisa ter pelo menos 12 caracteres. Veja a saída de uma execução:

Senha: Repita a senha: Administrador criado: admin@exemplo.com.br
[saída: 0]

Estes são os erros que o comando mostra:

• E-mail inválido: «…».: o endereço não passa na checagem.
• Já existe um usuário com este e-mail.: a conta já existe. A checagem roda antes de a senha ser pedida.
• A senha precisa ter pelo menos 12 caracteres.: a senha é curta demais.
• As senhas não conferem.: as duas digitações são diferentes.

Se o DATABASE_URL estiver no arquivo de ambiente, o usuário do serviço não o lê, porque o arquivo é do root. Passe o valor no próprio comando, antes do sh: sudo -u slash-<projeto> -H env DATABASE_URL=<valor> sh -c 'cd /srv/<projeto> && /home/slash-<projeto>/.bun/bin/bun /opt/slash-kit/cli/bin.ts admin create --email admin@exemplo.com.br'.

Para ver o uso, rode slash admin --help:

uso: slash admin create --email <e-mail> [--dir <pasta>]
[saída: 0]

Primeira publicação

O site só existe depois da primeira publicação. Até lá, a tela Publicação mostra o estado «Ainda não publicado».

1. Abra https://seu-dominio.com.br/painel/entrar e entre com o e-mail e a senha do administrador.
2. No menu, abra Operação e depois Publicação.
3. Clique em Republicar o site. A fila mostra o pedido, a origem, o estado e a duração.
4. Se o pedido falhar, abra Ver log na linha dele. O log traz o motivo, por exemplo a mensagem EXDEV, quando o storage/ está em outro disco.

As próximas publicações saem da mesma tela. Use Publicação para o uso do dia a dia.

Conferir o serviço

Dois comandos mostram se o serviço está no ar e o que ele registrou:

sudo systemctl status slash-<projeto>

sudo journalctl -u slash-<projeto> -n 50

Se o processo não sobe, a causa aparece no journalctl. Quando é uma variável de ambiente, a mensagem Configuração de produção inválida. Corrija: lista cada uma delas, e a tabela de VPS e variáveis diz o que cada variável aceita.

Com o administrador criado, o site publicado e o serviço no ar, o próximo passo é a rotina de backup em Backup e restauração. Para mais de um projeto na mesma VPS, veja Vários projetos, mídia e atualização.