`/plugadvpl:deploy`

/plugadvpl:deploy

Orquestra o ciclo completo de dev: compila o fonte, restarta o AppServer e (opcionalmente) confere se o REST voltou. Não é um subcomando novo — é um wrapper instrutivo sobre /plugadvpl:compile + /plugadvpl:tq que evita o usuário ter que lembrar os 3 passos e os encadeamentos com &&.

Quando usar

• Acabou de editar um .prw/.tlpp e quer ver no AppServer.
• Terminou um ciclo edit-prw e precisa publicar.
• Roda smoke contra um endpoint REST e o AppServer subiu antes do REST estar pronto.

Quando NÃO usar

• Só compilar sem restartar → use /plugadvpl:compile.
• Só restartar (já compilou em outra janela) → use /plugadvpl:tq.
• Deploy PROD-grade com rollback automático e versionamento de RPO → não existe no plugin. Foi descartado conscientemente (issue #5 comment). Pra esse caso, escreva um restart_cmd que faça o rollback dentro do próprio cmd (ex: restart-com-fallback.bat que detecta falha e restaura RPO anterior).

Workflow (3 passos)

Passo 1 — Pré-flight

Verifique que tanto compile quanto tq estão configurados:

plugadvpl --format json compile --doctor
plugadvpl compile --list-servers

O server alvo precisa ter restart_cmd setado. Se aparecer vazio, configure antes:

plugadvpl compile --set-restart-cmd <server> --cmd "<cmd do restart>"

Ex. Windows: "cmd.exe /c gaps\\restart-totvs.bat" Ex. Linux: "sudo systemctl restart totvs-appserver12"

Passo 2 — Compile + restart encadeados

plugadvpl compile --use-server <server> --all-envs <fonte> && \
plugadvpl tq --use-server <server>

Importante:

• O && garante que só restarta se compilar limpo. Compile com erro aborta o flow, AppServer fica intacto.
• --all-envs é recomendado quando o server tem múltiplos environments (típico: protheus + protheus_rest) — RPO sai sincronizado entre eles.
• Se o REST do AppServer roda numa porta diferente do TCP do advpls, passe --port no tq:

  plugadvpl tq --use-server Local --port 8019
  

Passo 3 — Smoke (opcional)

Se tem endpoint REST custom pra testar, valide depois do tq voltar:

curl -s http://<host>:<port>/rest/<endpoint> | jq .

Se quebrou:

1. Confere console.log do AppServer (path em appserver.ini → [General].ConsoleFile).
2. plugadvpl log-diagnose <console.log> pra rodar a KB de 93 correction tips.

Padrões de erro

Sinal	Provável causa	Fix
compile exit 1 com C2xxx	erro de sintaxe / include faltando	/plugadvpl:compile mostra diagnóstico, edita fonte e repete
tq exit 1 com restart_exit_code != 0	restart_cmd falhou (permissão, path errado)	rode o cmd manual pra ver erro completo
tq exit 1 com healthcheck timeout	AppServer demorou pra subir / porta REST diferente	aumente --timeout ou ajuste --port
smoke 500 mas tq ok	bug no fonte que compilou mas estoura em runtime	log-diagnose no console.log

Exemplo completo

Cenário real: ajustar coletadb.tlpp, publicar nos 2 envs, validar /rest/coletadb/ping:

# 1. Compile + restart
plugadvpl compile --use-server Local --all-envs docs/reference-impl/coletadb.tlpp && \
plugadvpl tq --use-server Local --port 8019

# 2. Smoke
curl -s http://127.0.0.1:8019/rest/coletadb/ping

Se o smoke der 200, deploy ok. Qualquer fail anterior aborta a cadeia.

Skills relacionadas

• /plugadvpl:compile — passo 1 isolado
• /plugadvpl:tq — passo 2 isolado
• /plugadvpl:edit-prw — fluxo de edição antes do deploy (preserva encoding CP1252)
• /plugadvpl:log-diagnose — troubleshoot pós-deploy