Pular para conteúdo

⚙️ Configurações - ecosif-moviments

📋 Visão Geral

Este documento descreve todas as configurações disponíveis no serviço ecosif-moviments.


📄 application.yml

O arquivo src/main/resources/application.yml contém todas as configurações base. Configurações específicas são sobrescritas via variáveis de ambiente.


🔧 Variáveis de Ambiente

Banco de Dados

Variável Descrição Padrão
POSTGRES_HOST Host do banco -
POSTGRES_PORT Porta do banco 5432
POSTGRES_DB Nome do banco -
POSTGRES_USER Usuário -
POSTGRES_PASSWORD Senha -

Servidor

Variável Descrição Padrão
ECOSIF_MOVIMENTS_PORT Porta do serviço 8082
ECOSIF_CONTEXT_PATH Context path /

Segurança

Variável Descrição Padrão
AUTH_TOKEN_SECRET Chave secreta JWT -
TOKEN_EXPIRATION Expiração do token (ms) 86400000
ECOSIF_CORS CORS allowed origins http://localhost:4200

JPA/Hibernate

Variável Descrição Valores
HIBERNATE_DDL_AUTO Modo DDL validate, update, create, none
ECOSIF_FLYWAY_ENABLED Habilitar Flyway true, false

Paginação

Variável Descrição Padrão
ECOSIF_PAGINATION_SIZE Tamanho padrão de paginação 100

Logging

Variável Descrição Padrão
ECOSIF_LOGSHOW Mostrar SQL no log false
LOG_FORMAT Formato de log default, json
ECOSIF_LOGMODE_ROOT Nível root INFO
ECOSIF_LOGMODE_SPRING Nível Spring INFO
ECOSIF_LOGMODE_HIBERNATE_SQL Nível SQL INFO

AWS S3

Variável Descrição Padrão
AWS_ACCESS_KEY_ID Chave estática. Opcional. Vale só junto com o secret. vazio: task role
AWS_SECRET_ACCESS_KEY Secret estático. Opcional. Vale só junto com a chave. vazio: task role
AWS_DEFAULT_REGION Região do bucket. Obrigatória na subida. —
AWS_S3_BUCKET Bucket S3. Obrigatório na subida. —

As duas chaves preenchidas acessam o S3 com credencial estática. Isso cobre a conta da própria task e uma conta diferente da task role. Sem as duas, ou com só uma, o cliente usa ContainerCredentialsProvider e a task role do ECS. A cadeia padrão do SDK não serve nesse caso: com a chave ainda no ambiente, ela ignoraria a role.

Se o S3 recusar a chave estática (InvalidAccessKeyId, assinatura, token expirado ou AccessDenied), o processo troca uma vez para a task role e permanece nela até o restart. Timeout, falha de rede ou 5xx em gravação, cópia ou exclusão encerra aquela operação. Não há segunda execução.

A task definition do ECS precisa de task role com permissão no bucket quando as chaves não estiverem preenchidas ou depois da troca. O Fargate injeta AWS_CONTAINER_CREDENTIALS_RELATIVE_URI. Sem essa role, a chamada S3 pela role falha.


📝 Configurações no application.yml

HikariCP (Connection Pool)

spring:
  datasource:
    hikari:
      connection-timeout: 20000
      minimum-idle: 10
      maximum-pool-size: 80
      idle-timeout: 600000
      max-lifetime: 1800000

JPA/Hibernate

spring:
  jpa:
    database-platform: org.hibernate.dialect.PostgreSQLDialect
    hibernate:
      ddl-auto: ${HIBERNATE_DDL_AUTO}
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
        implicit-strategy: org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl

Flyway

spring:
  flyway:
    enabled: ${ECOSIF_FLYWAY_ENABLED}

CORS

spring:
  mvc:
    cors:
      allowed-origins: ${ECOSIF_CORS}

Actuator

management:
  endpoints:
    web:
      exposure:
        include:
          - health
          - info
          - prometheus

🔍 Verificar Configurações

Via Actuator

# Informações da aplicação
curl http://localhost:8082/actuator/info

# Health check
curl http://localhost:8082/actuator/health

# Métricas
curl http://localhost:8082/actuator/prometheus

Última Atualização: 2025-11-27