Ir para o conteúdo

45 — Operador de suporte: download do kit e levantamento de ambiente

Para: equipe de suporte Lorentz / Orbitall
Onde baixar: MonitorOPS → Ferramentas → Pacote suporte
VPS referência: srv1869007 · 2.25.92.168
Relacionados: INSTALACAO-SUPORTE.md · 38 · 44

1. Segurança (obrigatório)

Camada Controle
Rede IP do operador em EDGE_ADMIN_CIDRS (Caddy) — senão 403 em monitorops.orbitall.app
Autenticação Login MonitorOPS (MONITOR_ADMIN_USER / senha)
Conteúdo do kit Sem .env de produção, sem *.lic, sem ura-sip-passwords.txt
Auditoria Download registrado no log do container (support_kit_download)

Não publique o .tar.gz em site aberto. Domínio dedicado (support.orbitall.app) é opcional no futuro — hoje o canal oficial é MonitorOPS (já allowlisted).

Liberar IP:

# na VPS
cd /root/omnichannel/lorentz-vps-stack
# editar EDGE_ADMIN_CIDRS+=SEU_IP/32
./scripts/apply-edge-config.sh

Ou MonitorOPS → Ferramentas → Aplicar allowlist após editar .env.

2. Baixar o kit (passo a passo)

  1. Acesse https://monitorops.orbitall.app/ do IP liberado.
  2. Faça login.
  3. Menu Ferramentas.
  4. Seção Pacote suporte — fontes e requisitos:
  5. Gerar kit (standard) — scripts, docs, compose, templates (sem zips grandes)
  6. Gerar kit FULL — inclui resources/net9.0.zip, supervisor.tar.gz, .bak se existirem na VPS
  7. Só documentação — docs + INSTALACAO
  8. Aguarde a saída no painel; clique Atualizar lista.
  9. Download do .tar.gz e do .sha256.

CLI equivalente na VPS:

cd /root/omnichannel/lorentz-vps-stack
./scripts/build-support-kit.sh              # standard
./scripts/build-support-kit.sh --full       # com binários
ls -lh config/runtime/support-kits/

3. Extrair em área disponível na VPS (ou lab)

Escolha um diretório livre (não sobrescreva .env de produção sem backup):

# Exemplo: área de homologação
mkdir -p /root/lab-suporte && cd /root/lab-suporte
# copie o tar baixado (scp do PC ou já está em support-kits/)
cp /root/omnichannel/lorentz-vps-stack/config/runtime/support-kits/lorentz-support-kit-*.tar.gz .
sha256sum -c lorentz-support-kit-*.tar.gz.sha256

tar -xzf lorentz-support-kit-YYYYMMDD-HHMM.tar.gz
cd lorentz-support-kit-YYYYMMDD-HHMM

# Este diretório funciona como lorentz-vps-stack
cp .env.example .env
nano .env
# Defina no mínimo:
#   VPS_PUBLIC_IP=
#   MSSQL_SA_PASSWORD=
#   MONITOR_ADMIN_PASSWORD=
#   ISSABEL_DIR=/root/issabel4-docker   # se Issabel já existe na mesma máquina, NÃO reinstale às cegas

Atenção produção Orbitall: na srv1869007 o stack já roda. Use o kit para:

  • copiar para outra VPS / lab WSL, ou
  • atualizar scripts/docs, não rodar deploy-all.sh em cima da produção sem janela.

4. Preparar e subir ambiente

chmod +x scripts/*.sh

# Se o kit FULL trouxe resources/net9.0.zip:
./scripts/prepare-support-install.sh

./scripts/check-pre-install.sh
./scripts/deploy-stack.sh          # core Docker (sem Issabel ISO)
# ou, VPS nova com PBX:
# ./scripts/deploy-all.sh

./scripts/validate-install.sh --external
./scripts/diagnose-stack.sh --brief

Issabel + URA lab (≥10 ramais):

./scripts/configure-issabel-ami-docker.sh --restart-cti
./scripts/configure-issabel-lab-homolog.sh

Guia lab: 44-lab-homologacao-issabel-cti-supervisor.md.

5. Checklist rápido do operador

# Item OK
1 IP em allowlist + login MonitorOPS [ ]
2 Download kit + checksum [ ]
3 Extrair em pasta dedicada [ ]
4 .env novo (sem copiar produção cegamente) [ ]
5 prepare-support-install / binários [ ]
6 deploy-stack ou deploy-all [ ]
7 validate-install / diagnose --brief [ ]
8 Supervisor + CTI + (opcional) URA/SIP [ ]

6. Domínio específico (opcional, futuro)

Hoje não é necessário: monitorops.orbitall.app já está protegido.

Se quiser support.orbitall.app:

  1. DNS A → mesmo IP VPS
  2. Bloco Caddy espelhando MonitorOPS ou só handle_path /api/support*
  3. Mesma EDGE_ADMIN_CIDRS
  4. Documentar em 34-checklist-portas-dns-orbitall.md

7. Conteúdo típico do kit (standard)

  • scripts/*.sh, docker-compose.yml, docker/
  • docs/ (guias suporte + plantas H/Issabel)
  • config/templates, asterisk-ura, windows-ura (sem .lic)
  • .env.example, INSTALACAO-SUPORTE.md, README-OPERADOR.md
  • FULL: resources/net9.0.zip, supervisor.tar.gz, LorentzCTI.bak (se existirem na origem)

Canal oficial de distribuição interna: MonitorOPS Ferramentas. Não versionar tarballs em git (config/runtime/support-kits/).