Operação e manutenção

Esta seção reúne os comandos operacionais usados depois da instalação inicial. Ela mostra quando parar, migrar, resetar ou limpar o ambiente principal.

Depois que a instalacao principal estiver funcionando, estes sao os comandos operacionais mais usados:

bash ./migrate-selfhost.sh
bash ./stop-selfhost.sh
bash ./reset-selfhost.sh
bash ./reset-selfhost.sh --purge-env

O que cada comando faz

  • migrate-selfhost.sh Reaplica as migracoes do ambiente.
  • stop-selfhost.sh Para os servicos sem apagar os dados.
  • reset-selfhost.sh Limpa o ambiente para recomecar a instalacao.
  • reset-selfhost.sh --purge-env Limpa o ambiente e remove tambem a configuracao salva.

Quando usar

  • Use stop-selfhost.sh quando quiser apenas desligar a plataforma.
  • Use migrate-selfhost.sh quando uma atualizacao exigir reaplicacao da estrutura de dados.
  • Use reset-selfhost.sh quando precisar recomecar a instalacao.
  • Use reset-selfhost.sh --purge-env somente quando tambem for necessario apagar a configuracao salva.

Ordem de cautela

Se houver duvida, siga esta ordem:

  1. prefira stop-selfhost.sh para interromper o ambiente;
  2. use migrate-selfhost.sh quando a manutencao exigir atualizacao de estrutura;
  3. use reset-selfhost.sh somente quando houver necessidade de recomeco;
  4. use reset-selfhost.sh --purge-env apenas quando a limpeza completa for realmente necessaria.

Resultado esperado

Depois de executar cada comando, o comportamento esperado e:

  • stop-selfhost.sh Os servicos param, mas os dados permanecem.
  • migrate-selfhost.sh As migracoes sao reaplicadas sem erro.
  • reset-selfhost.sh O ambiente e limpo para uma nova instalacao.
  • reset-selfhost.sh --purge-env O ambiente e limpo e a configuracao salva e removida.

Sinais de problema

Revise a operacao se:

  • o comando termina com erro;
  • o ambiente nao para quando stop-selfhost.sh e executado;
  • a reaplicacao de migracoes falha;
  • o reset e executado sem que houvesse intencao de apagar o ambiente.

Recomendacao final

Se nao houver certeza sobre o impacto de reset ou purge, confirme antes de executar.