Conferência de schema¶
O ecosif-auth guarda os scripts V*.sql e, na subida da imagem, confere se o efeito de cada um está no PostgreSQL. O cliente aplica esses scripts à mão. Não usa Flyway. O usuário da aplicação não altera a base.
A conferência só faz SELECT. O modo vem da variável do container ECOSIF_SCHEMA_CHECK_MODE.
| Modo | Efeito |
|---|---|
log |
Padrão. O processo sobe. O log e o componente dbSchema do actuator listam o script que falta. |
fail |
Qualquer outro valor, inclusive fail. O processo não permanece no ar. O log cita o script. |
Quem publica a imagem no Docker Hub entrega a conferência. O cliente só puxa ecosif-auth. As outras imagens não conferem schema.
Próxima versão¶
Ao criar um script novo:
- Arquivo só em
src/main/resources/db/migration/V<versão>__descricao.sql. Não edite umV*.sqljá aplicado. - Symlink em
flyway-ecosif/sql/, como em migrations_flyway.md. - No mesmo corte,
src/main/resources/db/schema-check/V<mesma-versão>.sql.
O check é uma consulta. Zero linhas significa que o efeito está presente. Qualquer linha é defeito e deve dizer o que falta. Uma release do pom.xml pode trazer vários scripts. Cada um tem o próprio arquivo. A versão do pom não entra no nome.
Ficam de fora:
V0.6.00.0(limpeza). Não deixa objeto depois dos scripts seguintes.afterMigrate__align_id_sequences.sql. É callback do Flyway. O cliente não executa Flyway.
V0.6.00.2 só faz setval. A sentinela confere se a sequence existe. O valor do contador muda com o uso e não prova que o script rodou.
Onde ler o resultado¶
Log do container ecosif-auth, com action=schema_check. No actuator, componente dbSchema em /actuator/health e no grupo readiness. Com log, o status do componente continua UP e o detalhe missing lista os scripts. Com fail, a JVM encerra antes de atender requisição.