Pular para conteúdo

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:

  1. Arquivo só em src/main/resources/db/migration/V<versão>__descricao.sql. Não edite um V*.sql já aplicado.
  2. Symlink em flyway-ecosif/sql/, como em migrations_flyway.md.
  3. 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.