MÓDULO 4.2 / 8 DE 8
VPS do zero e operação 24/7
Preparar um plano de implantação, supervisão, backup e verificação do serviço.
1Uma VPS é uma máquina sob sua responsabilidade
O que é
VPS é um servidor virtual alugado: um computador remoto com memória, disco e rede. Você administra usuários, atualizações e processos. Comece com uma máquina pequena compatível com a aplicação; não contrate GPU apenas para chamar um modelo por API. O modelo remoto roda na infraestrutura do provedor.
Por que aprender
Uma máquina ligada não significa um serviço saudável. Custos de VPS, armazenamento e API são separados. Antes de contratar, defina o que precisa rodar continuamente e quem verificará incidentes.
Conceitos-chave
Servidor remoto; recursos; custo recorrente; responsabilidade operacional.
Na prática
Um bot pequeno que consulta dados fictícios não precisa da mesma infraestrutura que um modelo local. A gestora estima carga, orçamento e disponibilidade antes de escolher o plano.
✓ Faça
Preencha materiais/plano-vps.md. Registre sistema operacional, forma de acesso, limite mensal, responsável e forma de desligar o recurso.
✗ Evite
Aceitar uma conclusão sem conferir a entrada que a sustenta.
2Entre por SSH e preserve acesso
O que é
SSH cria uma conexão protegida para administrar a máquina. Use a chave pública cadastrada conforme o provedor e confira a identidade do servidor. Crie um usuário de trabalho com permissões administrativas quando necessário. Mantenha a sessão original aberta enquanto testa uma segunda conexão.
Por que aprender
Mudar firewall ou autenticação sem testar uma rota de recuperação pode bloquear seu próprio acesso. O console do provedor é a alternativa quando a conexão normal falha; confira que ele funciona antes de restringir a rede.
Conceitos-chave
Chave pública; impressão digital; usuário; sudo; recuperação.
Na prática
O comando ssh usuario@ip-da-vps abre a sessão. usuario e ip-da-vps são campos para substituir, não valores reais. O nome do prompt e pwd ajudam a confirmar em qual máquina você está.
3Instale só o necessário
O que é
Os exemplos do laboratório usam Ubuntu com apt. Atualize a lista de pacotes e revise a atualização proposta. O bot base precisa de Python 3; Git ajuda a transferir o projeto. Node, Docker e Codex são opcionais conforme a aplicação, não uma lista obrigatória para qualquer VPS.
Por que aprender
Cada dependência acrescenta manutenção. Um serviço simples, com poucas peças, é mais fácil de explicar, atualizar e recuperar. Instalar ferramentas por hábito cria trabalho sem aumentar a capacidade necessária.
Conceitos-chave
apt update; apt upgrade; dependência; ambiente virtual quando necessário.
Na prática
Sequência de referência: sudo apt update, sudo apt upgrade, sudo apt install git python3. O bot do kit usa somente a biblioteca padrão, sem instalar pacotes Python externos.
Sequência para experimentar
- Prepare uma cópia de treino.
- Antes de confirmar a atualização, leia os pacotes envolvidos. Confira python3 --version e git --version, depois crie ~/projetos na conta de trabalho.
- Registre o resultado observado e a próxima correção.
4Proteja a rede e as credenciais
O que é
Firewall filtra conexões de rede. Para long polling, o bot precisa sair para HTTPS; não precisa expor uma porta de bot à internet. Antes de ativar UFW, libere a porta SSH realmente usada e confira regras locais e do provedor. Restrinja o .env com chmod 600 e deixe-o fora do Git.
Por que aprender
Abrir todas as portas para “fazer funcionar” amplia o risco sem diagnosticar a causa. Se o processo não responde, rede de saída, token e execução merecem checagens distintas.
Conceitos-chave
Entrada e saída; porta SSH; regra de firewall; permissões de arquivo.
Na prática
Se SSH usa a porta 22, sudo ufw allow 22/tcp pode ser apropriado. Se usa outra porta, a regra precisa mudar. Só execute sudo ufw enable após testar a configuração e o acesso de recuperação.
✓ Faça
Liste portas realmente necessárias no plano. Registre quais comandos variam por provedor e nunca trate o exemplo de porta como universal.
✗ Evite
Misturar a cópia de treino com arquivos privados ou trabalho em produção.
5Systemd supervisiona o processo
O que é
systemd é o gerenciador de serviços de muitas distribuições Linux. Uma unidade descreve qual programa iniciar, com qual usuário e em qual pasta. Restart=on-failure reinicia após uma falha, mas não corrige um erro persistente. O kit fornece uma unidade parametrizada para o usuário oswork.
Por que aprender
Executar o bot numa sessão SSH pode encerrar o trabalho ao fechar a conexão. Supervisão permite reiniciar com a máquina e centralizar logs. Ela não substitui alertas, limites ou análise da causa.
Conceitos-chave
Unidade; usuário de serviço; diretório; reinício; journal.
Na prática
Depois de adaptar caminhos, use sudo systemctl daemon-reload e sudo systemctl enable --now oswork-bot. Consulte systemctl status e journalctl -u oswork-bot -n 50 --no-pager.
6Disponibilidade exige rotina de cuidado
O que é
Operação contínua combina supervisão, atualização, monitoramento, backups e restauração testada. Faça cópias dos dados fora da máquina, proteja credenciais e defina retenção. Um backup só foi validado quando você restaurou uma cópia e verificou o conteúdo.
Por que aprender
Sem monitoramento, um serviço pode ficar parado durante dias. Sem teste de restauração, a cópia pode estar incompleta. A promessa real é uma rotina recuperável, não uma máquina infalível.
Conceitos-chave
Checagem externa; logs; backup fora da VPS; restauração; limite de gasto.
Na prática
Uma verificação diária registra resposta do bot e espaço em disco. Um teste mensal restaura vendas.csv em uma pasta separada e compara o total. Credenciais seguem tratamento privado, sem entrar no backup público.
Critérios para revisar sua entrega
Use esta rubrica depois do laboratório. Cada linha pede uma evidência; marcar leitura não significa que a prática foi executada.
| Critério | Evidência esperada | Se não passou |
|---|---|---|
| Escopo | A entrega corresponde ao objetivo desta aula. | Reduza a tarefa e nomeie um único resultado. |
| Entradas | Você sabe quais arquivos ou dados foram usados. | Liste as fontes e remova material sem relação. |
| Execução | O procedimento foi realizado no ambiente de treino. | Diferencie o que foi planejado do que foi feito. |
| Conferência | Um resultado foi comparado com uma referência. | Abra o arquivo ou repita a consulta verificável. |
| Segredos | Nenhum token, senha ou dado privado foi compartilhado. | Revise a cópia de trabalho antes de qualquer envio. |
| Continuidade | Outra pessoa consegue encontrar o próximo passo. | Atualize README e registre uma pendência concreta. |
MÃO NA MASSA / ~15 MIN OU EM ETAPAS
Da pasta local a um serviço supervisionado
Use arquivos fictícios e uma pasta de treino. As práticas com instalação, Telegram ou VPS podem exigir tempo adicional para cadastro e configuração.
VPS Ubuntu · adapte caminhos antes
Leia o bloco antes de usar. Campos como Seu Nome e usuario@ip-da-vps são exemplos para adaptar; comandos administrativos pertencem somente ao seu ambiente de treino.
sudo apt update
sudo apt upgrade
sudo apt install git python3
# Adapte a unidade do kit ao usuário e caminho reais.
sudo systemctl daemon-reload
sudo systemctl enable --now oswork-bot
systemctl status oswork-bot --no-pager
journalctl -u oswork-bot -n 50 --no-pager
Critério de pronto
Preparar um plano de implantação, supervisão, backup e verificação do serviço. Registre o arquivo produzido, o teste executado e o resultado observado.
Abrir arquivos e modelos do laboratórioConfira o que ficou
Instalar Codex numa VPS garante um agente ativo 24 horas?
Ver resposta comentada
Não. É preciso um serviço ou agendador, processo supervisionado, credenciais válidas, rede e monitoramento.
Se sua resposta foi diferente, volte ao tópico correspondente e escreva a diferença em uma frase. A checagem não bloqueia seu estudo.
Resumo do módulo
- Servidor remoto; recursos; custo recorrente; responsabilidade operacional.
- Chave pública; impressão digital; usuário; sudo; recuperação.
- apt update; apt upgrade; dependência; ambiente virtual quando necessário.
- Entrada e saída; porta SSH; regra de firewall; permissões de arquivo.
- Unidade; usuário de serviço; diretório; reinício; journal.
- Checagem externa; logs; backup fora da VPS; restauração; limite de gasto.
Consulte a fonte
Ferramentas verificadas em 20/09/2026; nomes de telas e disponibilidade podem mudar.