# Instalação e Ciclo de Vida

Managed documentation for Instalação e Ciclo de Vida.

# Procedimento de Instalação

<!-- BOOKSTACK-DOCUMENT-RELEASE:BEGIN -->
# Procedimento de Instalação

| Campo | Valor |
| --- | --- |
| Distribuição | WCT Portuguese — OpenC5ISR |
| Produto | OpenC5ISR |
| Versão | 0.15.1 |
| Implantação | `openc5isr-pt.wallacecorptech.com` |
| Fonte | `/srv/wct/releases/OpenC5ISR-v0.15.0-20app-pt` |
| Evidência | Manifestos da distribuição mais padrão de implantação controlada |
| Impressão digital da fonte | `e92dc1580aa26f7545815bcf40300b21bc5485b0a2ae46a715538a48365cc801` |
| Estado | Linha de base gerada — revisão humana obrigatória |

> **Limite de verificação:** Esta página combina orientação de projeto da plataforma com evidências estáticas da distribuição. Ela não comprova que todas as interfaces detectadas estejam habilitadas, acessíveis, seguras ou operacionais no ambiente implantado.

## Pontos de entrada candidatos de build/instalação

| Evidência | Invocação | Ação declarada |
| --- | --- | --- |
| `package.json` | `npm run start` | `npm run verify:startup && node server.js` |
| `package.json` | `npm run test` | `python3 tests/integrated_smoke_test.py && python3 tests/openknowledge_opentask_ontology_smoke_test.py && python3 tests/opendaa_opendata_smoke_test.py && python3 tests/opendaa_openanalytics_smoke_test.py && python3 tests/opencop_smoke_test.py && python3 tests/smoke_test.py && python3 tests/openeyes_smoke_test.py && python3 tests/raspbot_agent_smoke_test.py && python3 tests/openpnt_smoke_test.py && python3 tests/openpnt_linuxptp_wrapper_smoke_test.py && python3 tests/openpnt_agent_smoke_test.py && python3 tests/external_integrations_smoke_test.py && python3 tests/compiled_deployment_smoke_test.py && node tests/openssa/test_openssa.js && python3 tests/openssa/test_sensor.py && python3 tests/openssa_opensof_smoke_test.py && python3 tests/openrf_opensof_smoke_test.py && python3 tests/openlvc_edge_gateway_test.py && python3 tests/openlvc_smoke_test.py && python3 tests/opencybersec_smoke_test.py && python3 tests/opencybersec_agent_smoke_test.py && python3 tests/openiia_smoke_test.py && python3 tests/openaar_mr_smoke_test.py` |
| `package.json` | `npm run verify:startup` | `node -e "require('./lib/openpnt-timing'); require('./lib/openpnt'); console.log('startup dependencies OK')"` |
| `edge/openssa-sensor/package.json` | `npm run start` | `node local_server.js 3000` |
| `edge/openssa-sensor/package.json` | `npm run check` | `node --check lib/openssa.js && node --check public/open-ssa/app.js && node --check local_server.js && python3 -m py_compile drivers/ssa_sensor.py tools/*.py demo/run_streaming_demo.py tests/*.py` |
| `edge/openssa-sensor/package.json` | `npm run test` | `npm run check && node tests/test_openssa.js && python3 -m unittest discover -s tests -v` |
| `third_party/ontowiki/Makefile` | `make clean` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make codebeautifier` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make codesniffer` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make composer-install` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make debianize` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make default` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make deploy` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make devenv` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make directories` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make getcomposer` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make help` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make help-cs` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make help-test` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make install` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make list-events` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make odbctest` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test-directories` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test-extensions` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test-integration-mysql` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test-integration-virtuoso` | Alvo Make |
| `third_party/ontowiki/Makefile` | `make test-unit` | Alvo Make |
| `third_party/ontowiki/debian/Makefile/Makefile` | `make clean` | Alvo Make |
| `third_party/ontowiki/debian/Makefile/Makefile` | `make default` | Alvo Make |
| `third_party/ontowiki/debian/Makefile/Makefile` | `make package` | Alvo Make |
| `third_party/ontowiki/debian/Makefile/Makefile` | `make prepare` | Alvo Make |

## Procedimento de instalação controlada

1. Registrar nome do artefato, versão, checksum, origem e aprovação.
2. Fazer backup de configuração, dados persistentes, banco de dados e definições ativas de proxy/serviço.
3. Extrair a distribuição em novo diretório imutável; não sobrescrever a versão ativa.
4. Instalar dependências usando manifestos e lock files fixados. Revisar scripts antes de executá-los como usuário privilegiado.
5. Criar/atualizar configuração e segredos específicos da edição fora do diretório da versão.
6. Executar testes unitários/estáticos e verificação local de saúde antes de trocar tráfego de produção.
7. Ativar atomicamente pelo link current/tag de contêiner/definição de serviço e reiniciar apenas serviços afetados.
8. Validar estado de processos, endpoints locais, roteamento Nginx, WebSockets, login, fluxo principal e logs.
9. Registrar resultados reais e manter a versão anterior até completar a janela de aceitação.

## Não presuma

O gerador deliberadamente não inventa um comando de instalação quando a distribuição não fornece evidências suficientes. Promova um comando para esta página somente após executá-lo com sucesso em um alvo limpo ou controlado.
<!-- BOOKSTACK-DOCUMENT-RELEASE:END -->

---

## Notas do Mantenedor

<!-- BOOKSTACK-DOCUMENT-RELEASE:NOTES-BEGIN -->
Adicione aqui notas de implantação revisadas por pessoas, correções, decisões, capturas de tela e links. O conteúdo fora do bloco gerado é preservado nas próximas execuções.
<!-- BOOKSTACK-DOCUMENT-RELEASE:NOTES-END -->

# Atualização e Reversão

<!-- BOOKSTACK-DOCUMENT-RELEASE:BEGIN -->
# Atualização e Reversão

| Campo | Valor |
| --- | --- |
| Distribuição | WCT Portuguese — OpenC5ISR |
| Produto | OpenC5ISR |
| Versão | 0.15.1 |
| Implantação | `openc5isr-pt.wallacecorptech.com` |
| Fonte | `/srv/wct/releases/OpenC5ISR-v0.15.0-20app-pt` |
| Evidência | Padrão de ciclo de vida e comparação opcional de versões |
| Impressão digital da fonte | `e92dc1580aa26f7545815bcf40300b21bc5485b0a2ae46a715538a48365cc801` |
| Estado | Linha de base gerada — revisão humana obrigatória |

> **Limite de verificação:** Esta página combina orientação de projeto da plataforma com evidências estáticas da distribuição. Ela não comprova que todas as interfaces detectadas estejam habilitadas, acessíveis, seguras ou operacionais no ambiente implantado.

## Gate pré-atualização

- Caminho da versão anterior e comando de reversão são conhecidos e testados.
- Migrações de banco/configuração são identificadas, respaldadas e reversíveis ou explicitamente irreversíveis.
- Interfaces externas e módulos dependentes têm expectativas de compatibilidade registradas.
- Existe plano de manutenção/comunicação para interrupção visível ao usuário.
- Testes de aceitação e revisor responsável estão atribuídos.

## Sequência de atualização

```text
backup → stage new release → install/validate dependencies → migrate if required
→ switch active release → restart affected services → smoke/acceptance tests
→ observe → approve or roll back
```

## Sequência de reversão

```text
stop traffic/affected service → restore compatible data/config if required
→ repoint active release → restart → validate local/public endpoints
→ record incident and preserve failed-release evidence
```

## Comparação específica da versão

Nenhuma versão anterior foi fornecida. Execute com `--compare /caminho/versao-anterior` para gerar inventário estático de mudanças.
<!-- BOOKSTACK-DOCUMENT-RELEASE:END -->

---

## Notas do Mantenedor

<!-- BOOKSTACK-DOCUMENT-RELEASE:NOTES-BEGIN -->
Adicione aqui notas de implantação revisadas por pessoas, correções, decisões, capturas de tela e links. O conteúdo fora do bloco gerado é preservado nas próximas execuções.
<!-- BOOKSTACK-DOCUMENT-RELEASE:NOTES-END -->