Oracle Devops Ptbr

oracle-devops-ptbr — v3.1.0

Estrutura Git, scripts de deploy e CI/CD para projetos Oracle 19c + APEX 24.2 + ORDS.

Desenvolvido por: Maxwell da Silva Oliveira — M&S do Brasil LTDA

Áreas cobertas

Quando ativar

• Estrutura de diretórios para projeto Oracle/APEX/ORDS no Git
• Nomenclatura de arquivos de deploy (padrão GMUD: 001_projeto_ddl_objeto.sql)
• Scripts de deploy Python: deploy_full.py (orquestrador), deploy_db.py, deploy_ords.py
• Export APEX split via SQLcl (apex export -split)
• Export de módulos ORDS via ORDS_EXPORT.export_schema()
• Versionamento de módulos ORDS (clientes_v1/, clientes_v2/)
• Branch strategy (main / hom / develop / feature/*)
• GitHub Actions para Oracle/APEX/ORDS
• .gitignore para projetos Oracle
• .gitattributes (encoding UTF-8, LF)
• Ordem de deploy de objetos do banco (sequences → tables → packages → triggers)
• Gestão de environments (dev / hom / prod) sem credenciais em código
• Exportar DDL atual do banco para Git (baseline de projeto legado, sync após alteração direta)
• Changelog de banco: migrations ordenadas (changelog.yml + db_changelog), apply_changelog.py com --dry-run/--status, checksum SHA-256, detecção de drift entre ambientes

Não usar para: código PL/SQL (→ oracle-plsql-ptbr), APEX pages (→ oracle-apex-ptbr), ORDS handlers (→ oracle-ords-ptbr), DBA ops (→ oracle-dba-ptbr), tuning (→ oracle-tuning-ptbr).

Estrutura canônica de projeto

meu-projeto-apex/
├── .gitignore            ← assets/gitignore-oracle.txt
├── db/
│   ├── tables/           ← DDL de tabelas
│   ├── views/
│   ├── packages/         ← .pks (spec) e .pkb (body) separados
│   ├── procedures/       ← .prc
│   ├── functions/        ← .fnc
│   ├── triggers/         ← .trg (sempre compound)
│   └── scripts/          ← 001_projeto_tipo_objeto.sql (GMUD)
├── apex/
│   └── app_100/
│       ├── install.sql   ← entry point
│       └── f100/         ← export split (SQLcl)
├── ords/
│   ├── modules/
│   │   ├── clientes_v1/  ← module.sql + templates.sql +
│   │   └── clientes_v2/     handlers.sql + privileges.sql
│   ├── security/
│   └── scripts/          ← (wrappers shell — chamam os .py)
├── scripts/
│   ├── deploy_full.py    ← orquestrador (changelog → apex → ords)
│   ├── deploy_db.py      ← deploy objetos banco em ordem
│   ├── deploy_ords.py    ← deploy módulos ORDS
│   ├── apply_changelog.py← migrations do changelog.yml
│   ├── export_db.py      ← extrai DDL do banco → db/
│   ├── export_apex.py    ← export split APEX via SQLcl
│   ├── export_ords.py    ← export schema ORDS
│   ├── oracle_devops_utils.py  ← módulo compartilhado
│   └── requirements-devops.txt
└── .github/workflows/
    └── deploy.yml        ← assets/github-deploy.yml

Padrão GMUD — nomenclatura de scripts

{sequencia}_{projeto}_{tipo}_{objeto}.sql

001_msbrasil_ddl_tb_clientes.sql
002_msbrasil_ddl_pk_clientes.sql
003_msbrasil_pkg_clientes.sql
004_msbrasil_page_54_cadastro_v1.sql

Tipos: ddl dml pkg prc fnc trg vw page fix

Ordem de deploy de objetos do banco

sequences → types → tables → constraints → FK → indexes →
grants → synonyms → views → package specs (.pks) →
package bodies (.pkb) → procedures → functions → triggers →
APEX → ORDS

Implementado em assets/deploy_db.py.

Assets disponíveis

Referências cruzadas