문제: 앞 커밋이 Gradle 루트를 저장소 루트로 옮기고 계층 폴더를 묶었다.
빌드 스크립트·build-logic·시험·workflow·스크립트·문서가 아직 옛 배치
(Gradle 루트 = src/)를 가정해 빌드가 되지 않는다.
고른 방법:
- Gradle 경로와 registry id는 그대로 둔다(:app-bootstrap, :application-core,
:composition:*). registry의 source_path만 새 폴더를 가리킨다. 폴더에 맞춘
이름(:domain:core, :application:core)은 프로젝트 이름 core가 둘이 되어
boot jar의 BOOT-INF/lib와 기본 capability가 겹치고, 파생 서비스의 모든
project(':…') 줄을 바꾸게 한다.
- registry는 gradle/modules.json, 시험 이미지 목록은
gradle/container-images.properties: 버전 카탈로그 옆, 빌드가 고정하는 것.
config/는 코드 검사 도구 설정만 둔다.
- build-logic: settings·architecture 플러그인의 저장소 루트를 Gradle 루트로
(getParentFile 제거). config contract의 파일 트리는 src/만 훑는다(루트를
훑으면 docs·.claude/worktrees까지 줍는다).
- 빌드 스크립트: rootProject.projectDir.parentFile → rootProject.projectDir,
rootProject.file('../…') → rootProject.file('…'), 옛 src 기준 include에
src/를 붙인다. notification API surface의 application-notification 소스
루트를 새 폴더로(놓치면 272개 타입이 surface에서 말없이 빠진다).
- 시험: 옛 src 기준 모듈 목록과 ../ 개수를 고친다. 없는 폴더를 말없이
건너뛰던 목록(MessagingAuthority, NotificationPayloadAtRest 등)을 새
폴더로, FileserverDocumentationCoverageTest는 Gradle 경로 → 폴더를
registry로 찾는다. Docker 계약은 WORKDIR /build, 새 jar 경로.
- Docker: 빌드 context를 저장소 루트로, .dockerignore는 허용 목록으로 다시
써서 전에 context였던 것만 들어가게 한다. compose의 build.context는 .,
env_file은 ./.env.
- workflow: working-directory: src 기본값과 그것을 되돌리던 줄을 지운다.
- scripts: verify.sh, ci/*, bootstrap-local, new-feature,
verify-feature-scaffold, mongo 검증, hooks, check-repo-layout 허용 목록.
check-docs의 경로 검사는 build-logic/·gradle/로 시작하는 경로도 본다.
- 문서: AGENTS.md 지도, README 구조 표, leaf AGENTS.md의 cd src, gates·
operate·결정 색인, src/bootstrap/AGENTS.md를 조립 계층 family 규칙으로
다시 쓴다. 기록 문서(docs/design·history·reviews, 지난 upgrade 안내,
capability-status 제거 표)는 머리 블록만 고친다. 파생 서비스용 안내
docs/upgrade/2026-11-relayout.md를 더한다.
위험: bootRun working dir가 저장소 루트가 되어 .env와 상대 경로 설정이
루트 기준이다. 루트 .env는 compose 보간에도 읽힌다(upgrade 안내 5절).
파생 서비스는 태그 pre-relayout-2026-11까지 받은 뒤 이 묶음을 받는다.
검증: desktop에서 캐시 없이 scripts/verify.sh docs·pr·main·release,
compose smoke 18 lane, 빠른 시작(scripts/verify.sh app). 결과는 PR 본문.
구조 리뷰(arch-reviewer) 지적 5건을 반영했다.
BREAKING CHANGE: Gradle은 저장소 루트에서 돈다(cd src 없음). registry는
gradle/modules.json, 이미지 빌드 context는 저장소 루트다. 옛 경로 → 새 경로
표는 docs/upgrade/2026-11-relayout.md.
Refs: design-docs repo-structure/01-backend-layout.md 6.1절 가-2·가-3
5258 lines
214 KiB
YAML
5258 lines
214 KiB
YAML
# Registry: Env Keys
|
|
# Schema owner: feature-contract-registry-governance
|
|
# Owner branch: feature-env-driven-runtime-configuration
|
|
# Last updated: 2026-09-25
|
|
#
|
|
# 표기 규칙
|
|
# - 애플리케이션이 가진 env는 모두 `APP_` 접두어를 쓴다(D2, 2026-06-05). Spring 속성으로 이어지는
|
|
# datasource·server 등의 키도 APP_*로 바꿨다(예: SERVER_PORT -> APP_SERVER_PORT).
|
|
# - Spring 런타임이 직접 읽는 env만 원래 이름으로 둔다: SPRING_*와 SPRING_PROFILES_ACTIVE
|
|
# (D6 — profile 선택자는 APP_가 아니라 Spring 자체 이름이다).
|
|
# - `classification: secret` 행은 secrets-classification.yaml을 가리키기만 한다. 행 전체는 그 파일이 가진다.
|
|
# - reload_policy 기본값 = `restart-only` (env-driven branch "config reload: no runtime reload" — 실행 중
|
|
# 다시 읽지 않는다).
|
|
# - boolean 값은 true/false만 쓴다 (env-driven branch 2026-05-22).
|
|
# - Duration 값은 Spring 줄임 표기(`30s`)다. ISO-8601(`PT30S`)은 쓰지 않는다 (env-driven branch 2026-05-22).
|
|
# - DataSize 값은 `10MB` 꼴이다 (env-driven branch 2026-05-22).
|
|
# - required_when은 둘 중 하나다. `<속성>=<값>` 꼴(공백 없음)은 테스트가 그 조건에서 기동 실패를 확인하고,
|
|
# 공백이 든 설명 꼴은 사람이 읽는 조건이다(RequiredWhenIsEnforcedTest).
|
|
|
|
env_keys:
|
|
# === Profile / 정체성 (feature-env-driven-runtime-configuration) ===
|
|
|
|
- name: SPRING_PROFILES_ACTIVE
|
|
# source: feature-env-driven-runtime-configuration D6 (2026-06-06), five-adapter-runtime-remediation §7.1에서
|
|
# 고침. profile 선택자는 Spring 자체 키 하나뿐이다(APP_PROFILE은 지웠다). CSV 목록이 아니라 값 정확히
|
|
# 하나다: 두 환경의 안전 규칙이 함께 적용될 수 없고, 진 쪽은 소리 없이 빠졌다.
|
|
type: enum
|
|
# 기본값이 없다. 짐작한 profile은 아무도 고르지 않은 배포다: 예전에는 profile 없이 띄운 jar가 local이
|
|
# 됐고, 영속성을 조건으로 묶기 전에는 재기동 때 쓴 것을 모두 잃는 in-memory DB이기도 했다.
|
|
allowed_values: [local, dev, prod]
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:profile-active
|
|
|
|
# APP_PROFILE은 일부러 지웠다 (D6, 2026-06-06): profile = SPRING_PROFILES_ACTIVE 하나. APP_PROFILE을
|
|
# 따로 두면 같은 정보를 두 번 두고, 어긋날 때 실패하는 비용만 늘어난다. 설계 기록
|
|
# feature-env-driven-runtime-configuration Claims (wont-fix) 참고.
|
|
|
|
- name: APP_NAME
|
|
# source: feature-env-driven-runtime-configuration 2026-05-22
|
|
# "Required config: APP_NAME, APP_PROFILE..."
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:app-name-present
|
|
|
|
# === HTTP 서버 (D2에 따라 APP_로 통일) ===
|
|
|
|
- name: APP_SERVER_PORT
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_로 전부 통일. server.port는
|
|
# APP_SERVER_PORT에서 온다.
|
|
# + feature-management-actuator-security-contract 2026-05-22 "management port default = 9001 (separate from app 8080)"
|
|
# (관리 포트 기본값 9001, 앱 8080과 분리)
|
|
type: int
|
|
default: 8080
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: port_range_1_65535
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-port-bound
|
|
|
|
- name: MANAGEMENT_SERVER_PORT
|
|
# source: feature-management-actuator-security-contract 2026-05-22
|
|
# "management port default = 9001 (separate from app 8080). single-port는 platform ingress 보호 + 문서화 시만 허용."
|
|
type: int
|
|
default: 9001
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-management-actuator-security-contract
|
|
validation: port_range_1_65535
|
|
compatibility_impact: behavior-change
|
|
required_test: actuator-contract:management-port-separated
|
|
|
|
- name: APP_SERVER_SHUTDOWN
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (server.shutdown 방식. graceful은 처리 중인 요청을 끝내고 내린다)
|
|
type: enum
|
|
default: graceful
|
|
allowed_values: [graceful, immediate]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-shutdown-mode
|
|
|
|
- name: APP_SERVER_SHUTDOWN_TIMEOUT
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일.
|
|
# 옛 APP_SHUTDOWN_TIMEOUT 행을 대신한다. k8s terminationGracePeriod 이하여야 한다
|
|
# (feature-container-runtime-contract 참고).
|
|
type: duration
|
|
default: 30s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: spring_duration_shorthand_le_termination_grace
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-shutdown-timeout-aligned
|
|
|
|
- name: APP_SERVER_FORWARD_HEADERS_STRATEGY
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일.
|
|
# 기본은 닫힘(fail closed): forwarded 헤더는 배포가 정리·신뢰 proxy 뒤에서 직접 켤 때만 믿는다.
|
|
# native = Tomcat RemoteIpValve. server.tomcat.remoteip.internal-proxies에 맞는 상대에게서 온 헤더만
|
|
# 따른다. framework는 허용하지 않는다: 그 ForwardedHeaderFilter는 모든 상대를 믿고, rate limiter가
|
|
# 그 값으로는 기동을 거부한다.
|
|
type: enum
|
|
default: none
|
|
allowed_values: [none, native]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-forward-headers-strategy
|
|
|
|
- name: APP_SERVER_TOMCAT_MAX_THREADS
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (동시 요청 worker 상한)
|
|
type: int
|
|
default: 200
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:tomcat-max-threads-bounded
|
|
|
|
- name: APP_SERVER_TOMCAT_MIN_SPARE_THREADS
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (쉬는 worker pool의 하한)
|
|
type: int
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:tomcat-min-spare-threads-valid
|
|
|
|
- name: APP_SERVER_TOMCAT_ACCEPT_COUNT
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (들어오는 TCP 연결의 OS backlog queue 깊이)
|
|
type: int
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:tomcat-accept-count-valid
|
|
|
|
- name: APP_SERVER_TOMCAT_MAX_CONNECTIONS
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (동시에 열린 연결 수의 상한)
|
|
type: int
|
|
default: 8192
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:tomcat-max-connections-bounded
|
|
|
|
- name: APP_SERVER_TOMCAT_CONNECTION_TIMEOUT
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (Tomcat connector 연결 timeout)
|
|
type: duration
|
|
default: 20s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: spring_duration_shorthand
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:tomcat-connection-timeout-set
|
|
|
|
- name: APP_SERVER_COMPRESSION_ENABLED
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (server.compression 켜고 끄기)
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-compression-toggle
|
|
|
|
- name: APP_SERVER_COMPRESSION_MIN_RESPONSE_SIZE
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (이 크기보다 작은 응답은 압축하지 않는다)
|
|
type: data_size
|
|
default: 1KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: spring_data_size
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-compression-min-size
|
|
|
|
- name: APP_SERVER_ERROR_INCLUDE_STACKTRACE
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (spring.web.error.include-stacktrace 정책)
|
|
type: enum
|
|
default: never
|
|
allowed_values: [always, never, on_param]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-error-stacktrace-policy
|
|
|
|
- name: APP_SERVER_ERROR_INCLUDE_MESSAGE
|
|
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
|
|
# (spring.web.error.include-message 정책)
|
|
type: enum
|
|
default: never
|
|
allowed_values: [always, never, on_param]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:server-error-message-policy
|
|
|
|
- name: APP_MULTI_INSTANCE_ENABLED
|
|
# source: feature-env-driven-runtime-configuration D8 (2026-06-06)
|
|
# true면 StartupSafetyValidator(다른 singleton보다 먼저 도는 StartupRule)가 이름이
|
|
# distributedLockProvider인 인스턴스 간 DistributedLockPort bean을 요구한다. 없으면 기동이 실패한다
|
|
# (exit 72). 이 값을 쓰는 곳: feature-runtime-health-lifecycle-contract,
|
|
# feature-background-job-async-contract, feature-cache-consistency-contract,
|
|
# feature-domain-event-outbox-contract, feature-rate-limit-idempotency-contract,
|
|
# feature-migration-startup-contract.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: requires_coordination_beans_when_true
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:multi-instance-beans-present
|
|
|
|
- name: APP_MIGRATION_ON_STARTUP
|
|
# source: feature-migration-startup-contract
|
|
# true면 애플리케이션이 기동하면서 Flyway migration을 자동으로 돌린다.
|
|
# false면 migration을 건너뛴다(앱 밖의 container·pipeline job에 맡긴다).
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-migration-startup-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:migration-on-startup-toggle
|
|
|
|
# === Datasource / pool (env-driven branch "Required config: datasource") ===
|
|
|
|
- name: APP_DATASOURCE_URL
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# + feature-persistence-failure-baseline "datasource/pool/timeout/connection exhaustion log field"
|
|
# (datasource·pool·timeout·연결 고갈 로그 필드)
|
|
type: url
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: jdbc_url_pattern
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-url-resolvable
|
|
|
|
- name: APP_DATASOURCE_USERNAME
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-credential-present
|
|
|
|
- name: APP_DATASOURCE_PASSWORD
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# + feature-secrets-config-source-contract — secret 분류라 secrets-classification.yaml이 행을 가진다
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-secrets-config-source-contract
|
|
validation: must_not_be_local_dev_sentinel_in_prod
|
|
compatibility_impact: breaking
|
|
required_test: secrets-contract:db-password-not-leaked
|
|
|
|
- name: APP_PERSISTENCE_VENDOR
|
|
# source: application-local.yml과 bootRunH2가 쓰는 영속성 vendor 선택자.
|
|
# PostgreSQL이 기본으로 들어 있고, H2는 개발자가 명시적으로 고를 때만 쓴다.
|
|
property: app.persistence.vendor
|
|
type: enum
|
|
default: postgresql
|
|
allowed_values: [postgresql, h2]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: persistence-jpa-vendor-composition
|
|
validation: enum_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:local-vendor-parity
|
|
|
|
- name: APP_REALTIME_REPLAY_ENABLED
|
|
property: app.realtime.replay.enabled
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:realtime-replay-env
|
|
|
|
- name: APP_REALTIME_REPLAY_RETENTION
|
|
property: app.realtime.replay.retention
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: duration
|
|
default: 1h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_REALTIME_REPLAY_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:realtime-replay-env
|
|
|
|
- name: APP_FLYWAY_ENABLED
|
|
# source: 로컬 PostgreSQL을 운영과 맞춤 / 명시적 H2 개발 lane.
|
|
# 모든 profile이 기본으로 migration을 돌린다 — persistence-jpa 모듈 기본값이 이 키를 읽는다
|
|
# (07-08; dev/prod가 그 위에 값을 박지 않는다). bootRunH2는 migration tree가 PostgreSQL 전용이라
|
|
# 끈다.
|
|
property: spring.flyway.enabled
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: persistence-jpa-vendor-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:local-flyway-parity
|
|
|
|
- name: APP_DATASOURCE_POOL_MAX_SIZE
|
|
# source: feature-env-driven-runtime-configuration "datasource/pool env"
|
|
# + feature-persistence-failure-baseline "Hikari metric 노출 기준"
|
|
type: int
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:pool-bounded
|
|
|
|
- name: APP_DATASOURCE_POOL_MIN_IDLE
|
|
# source: feature-env-driven-runtime-configuration "datasource/pool env"
|
|
type: int
|
|
default: 2
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:pool-min-idle-valid
|
|
|
|
- name: APP_DATASOURCE_CONNECTION_TIMEOUT
|
|
# source: feature-env-driven-runtime-configuration "datasource/pool env"
|
|
# + feature-persistence-failure-baseline "Hikari Alert Threshold: pool wait p99 > 100ms"
|
|
# 단위: 밀리초. 이 값은 spring.datasource.hikari.connection-timeout으로 가고, 그 키는
|
|
# HikariConfig#setConnectionTimeout(long)에 바인딩된다 — "5s" 같은 duration 줄임 표기는 바인딩되지 않아
|
|
# 기동이 실패한다. 이 행이 `duration` / `5s`라 했고, application.yml이 그 기본값을 복사했고, 모든 prod·dev
|
|
# 배포가 기동을 거부했다. five-adapter-runtime-remediation Wave 2가 prod-smoke lane에서 찾았다. 실제로
|
|
# 받는 값으로 고쳤다.
|
|
type: integer
|
|
default: 5000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: positive_integer_milliseconds
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:connection-timeout-set
|
|
|
|
- name: APP_DATASOURCE_DRIVER
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# (설정한 datasource URL의 JDBC driver class)
|
|
type: string
|
|
default: org.postgresql.Driver
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-driver-set
|
|
|
|
- name: APP_DATASOURCE_DDL_AUTO
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# (Hibernate ddl-auto. prod는 validate|none이어야 하고, local은 update가 편하다)
|
|
type: enum
|
|
default: validate
|
|
allowed_values: [none, validate, update, create, create-drop]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-ddl-auto-safe
|
|
|
|
- name: APP_DATASOURCE_SHOW_SQL
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# (SQL을 로그에 찍는다)
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-show-sql-toggle
|
|
|
|
- name: APP_DATASOURCE_FORMAT_SQL
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# (SQL을 보기 좋게 찍는다 — SHOW_SQL=true일 때만 쓸모 있다)
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-format-sql-toggle
|
|
|
|
- name: APP_DATASOURCE_OPEN_IN_VIEW
|
|
# source: feature-env-driven-runtime-configuration "Required config: datasource"
|
|
# (Hibernate OSIV — prod에서 켜지 않는다)
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:datasource-open-in-view-toggle
|
|
|
|
- name: APP_DATASOURCE_POOL_IDLE_TIMEOUT
|
|
# source: feature-env-driven-runtime-configuration "datasource/pool env"
|
|
# (Hikari 밀리초. 쉬는 연결을 내보내는 기준)
|
|
type: int
|
|
default: 600000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:pool-idle-timeout-valid
|
|
|
|
- name: APP_DATASOURCE_POOL_MAX_LIFETIME
|
|
# source: feature-env-driven-runtime-configuration "datasource/pool env"
|
|
# (Hikari 밀리초. 연결 최대 수명 — broker timeout 전에 교체한다)
|
|
type: int
|
|
default: 1800000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-env-driven-runtime-configuration
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:pool-max-lifetime-valid
|
|
|
|
# === 추적 / 관측 (feature-distributed-tracing-contract) ===
|
|
|
|
- name: OTEL_EXPORTER_OTLP_ENDPOINT
|
|
# source: feature-distributed-tracing-contract 2026-05-22
|
|
# "Micrometer Tracing + OpenTelemetry exporter를 기본 기준으로 둠"
|
|
# OTLP 기본 주소(OpenTelemetry 규격). TracingEnvironmentPostProcessor가 이 값을
|
|
# management.opentelemetry.tracing.export.otlp.endpoint의 <value>/v1/traces(OTLP/HTTP)로 잇는다.
|
|
# 빈 값 = span exporter bean 없음 (review 07-01, 2026-11-01).
|
|
type: url
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-distributed-tracing-contract
|
|
validation: url_or_empty
|
|
compatibility_impact: additive
|
|
required_test: tracing-contract:exporter-endpoint-resolvable
|
|
|
|
- name: APP_TRACING_ENABLED
|
|
# source: feature-distributed-tracing-contract 2026-05-22
|
|
# "tracing disabled profile에서도 envelope meta.traceId와 log traceId는 유지"
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-distributed-tracing-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: tracing-contract:meta-traceid-when-disabled
|
|
|
|
- name: APP_TRACING_SAMPLE_RATE
|
|
# source: feature-distributed-tracing-contract 2026-05-22
|
|
# "trace sampling rate default = prod 1%, dev/local 100%"
|
|
# D-1 ISSUE-1 fix (2026-06-16): 빈 값 = profile별 resolver 기본값을 쓴다.
|
|
# RuntimeEnvironment가 profile의 정본이다. resolver 정책은 prod=0.01, dev/local=1.0.
|
|
# TracingEnvironmentPostProcessor가 정한 비율을 management.tracing.sampling.probability로 잇는다.
|
|
type: string
|
|
default: ""
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-distributed-tracing-contract
|
|
validation: float_between_0_and_1_or_blank
|
|
compatibility_impact: behavior-change
|
|
required_test: tracing-contract:sample-rate-per-profile
|
|
|
|
# === 로그 관리 (feature-log-management-contract) ===
|
|
|
|
# APP_LOG_LEVEL 키 하나를 아래 APP_LOG_LEVEL_* 행 다섯(root / app / spring / web / sql)으로 나눴다
|
|
# — feature-log-management-contract가 만든 대로.
|
|
|
|
- name: APP_LOG_LEVEL_ROOT
|
|
# source: feature-log-management-contract — root logger 레벨
|
|
type: enum
|
|
default: INFO
|
|
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:root-level
|
|
|
|
- name: APP_LOG_LEVEL_APP
|
|
# source: feature-log-management-contract — 애플리케이션 패키지 레벨
|
|
type: enum
|
|
default: INFO
|
|
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:app-level
|
|
|
|
- name: APP_LOG_LEVEL_SPRING
|
|
# source: feature-log-management-contract — Spring framework 패키지 레벨
|
|
type: enum
|
|
default: INFO
|
|
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:spring-level
|
|
|
|
- name: APP_LOG_LEVEL_WEB
|
|
# source: feature-log-management-contract — web/MVC 패키지 레벨
|
|
type: enum
|
|
default: INFO
|
|
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:web-level
|
|
|
|
- name: APP_LOG_LEVEL_SQL
|
|
# source: feature-log-management-contract — JPA/JDBC SQL 패키지 레벨 (DEBUG면 SQL을 찍는다)
|
|
type: enum
|
|
default: WARN
|
|
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:sql-level
|
|
|
|
- name: APP_LOG_FILE_ENABLED
|
|
# source: feature-log-management-contract — 순환(rolling) JSON 파일 appender 켜고 끄기
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:file-appender-toggle
|
|
|
|
- name: APP_LOG_FILE_PATH
|
|
# source: feature-log-management-contract — 파일 경로 (bootRun 실행 위치 기준 상대 경로 또는 절대 경로)
|
|
type: string
|
|
default: logs/ca-skeleton.json
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:file-path-set
|
|
|
|
- name: APP_LOG_FILE_MAX_SIZE
|
|
# source: feature-log-management-contract — 파일 하나의 순환 크기 상한
|
|
type: data_size
|
|
default: 100MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: spring_data_size
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:file-max-size
|
|
|
|
- name: APP_LOG_FILE_MAX_HISTORY
|
|
# source: feature-log-management-contract — 남길 순환 보관 파일 수
|
|
type: int
|
|
default: 14
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:file-max-history
|
|
|
|
- name: APP_LOG_FILE_TOTAL_SIZE_CAP
|
|
# source: feature-log-management-contract — 순환 파일 전체의 크기 상한
|
|
type: data_size
|
|
default: 3GB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: spring_data_size
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:file-total-size-cap
|
|
|
|
- name: APP_LOG_ASYNC_ENABLED
|
|
# source: feature-log-management-contract — 막히지 않는 I/O를 위한 AsyncAppender 감싸기
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:async-appender-toggle
|
|
|
|
- name: APP_LOG_ASYNC_QUEUE_SIZE
|
|
# source: feature-log-management-contract — 역압(back-pressure) 전 메모리 queue 깊이
|
|
type: int
|
|
default: 512
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:async-queue-size
|
|
|
|
- name: APP_LOG_ASYNC_DISCARDING_THRESHOLD
|
|
# source: feature-log-management-contract — 남은 용량이 이 값 아래로 내려가면
|
|
# TRACE/DEBUG/INFO 이벤트를 버린다(WARN/ERROR는 늘 남긴다). 0 = 버리지 않는다.
|
|
type: int
|
|
default: 20
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:async-discarding-threshold
|
|
|
|
- name: APP_LOG_JSON_TIMEZONE
|
|
# source: feature-log-management-contract — JSON encoder 시각에 쓰는 IANA timezone
|
|
type: string
|
|
default: UTC
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:json-timezone
|
|
|
|
- name: APP_LOG_JSON_TIMESTAMP_PATTERN
|
|
# source: feature-log-management-contract — JSON encoder 시각 형식 (기본 ISO 8601)
|
|
type: string
|
|
default: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: non_empty_string
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:json-timestamp-pattern
|
|
|
|
- name: APP_LOG_JSON_INCLUDE_CALLER_DATA
|
|
# source: feature-log-management-contract — 파일·메서드·줄 번호를 넣는다 (성능 비용이 크다)
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:json-include-caller-data
|
|
|
|
- name: APP_LOG_JSON_LOGGER_NAME_LENGTH
|
|
# source: feature-log-management-contract — logger 이름 줄이기 (0 = 전체 이름)
|
|
type: int
|
|
default: 0
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: non_negative_int
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:json-logger-name-length
|
|
|
|
- name: APP_LOG_SAMPLING_RATE
|
|
# source: feature-log-management-contract 2026-05-22
|
|
# "log sampling(prod 10%) > trace sampling(prod 1%)" + Sampling Policy 표 (prod 10%, dev/local 100%)
|
|
type: string
|
|
default: "1.0"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-log-management-contract
|
|
validation: float_between_0_and_1
|
|
compatibility_impact: behavior-change
|
|
required_test: log-contract:sample-rate-per-profile
|
|
|
|
# === 개인정보: user_principal 가명화 (feature-data-retention-privacy-contract) ===
|
|
|
|
- name: APP_PRIVACY_PSEUDONYMIZATION_SALT
|
|
# source: feature-data-retention-privacy-contract — "pseudonymization key = HMAC-SHA-256
|
|
# with rotating salt (90d)" (가명화 키는 90일마다 바뀌는 salt의 HMAC-SHA-256). feature-log-management-contract
|
|
# (DRIFT-6)가 user_principal을 가명 형태로 남기는 데 쓴다. secret 분류라 secrets-classification.yaml이 행을
|
|
# 가진다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-data-retention-privacy-contract
|
|
validation: must_not_be_local_dev_sentinel_in_prod
|
|
compatibility_impact: breaking
|
|
required_test: secrets-contract:pseudonymization-salt-rotation
|
|
|
|
# === Security / CORS / JWT (feature-security-operational-baseline) ===
|
|
|
|
- name: APP_SECURITY_CORS_ORIGINS
|
|
# source: feature-security-operational-baseline 2026-05-22
|
|
# "allowlist origin은 env-driven runtime configuration의 APP_SECURITY_CORS_ORIGINS로 주입"
|
|
type: csv_list
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: csv_of_origins_no_wildcard_with_credentials
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-allowlist
|
|
|
|
- name: APP_SECURITY_CORS_ENABLED
|
|
# source: feature-security-operational-baseline — CORS filter 전체 켜고 끄기
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-enabled-toggle
|
|
|
|
- name: APP_SECURITY_CORS_ALLOWED_METHODS
|
|
# source: feature-security-operational-baseline — 허용 method
|
|
# (빈 값 -> CorsSettings의 무난한 method 기본값)
|
|
type: csv_list
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: csv_of_http_methods_or_empty
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-allowed-methods
|
|
|
|
- name: APP_SECURITY_CORS_ALLOWED_HEADERS
|
|
# source: feature-security-operational-baseline — 허용 요청 헤더 ("*" = 모두)
|
|
type: csv_list
|
|
default: "*"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: csv_non_empty
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-allowed-headers
|
|
|
|
- name: APP_SECURITY_CORS_ALLOW_CREDENTIALS
|
|
# source: feature-security-operational-baseline 2026-05-22
|
|
# "CORS는 allowlist default, credentials false default" / "wildcard with credentials forbidden"
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: forbid_true_with_wildcard_origin
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-credentials-policy
|
|
|
|
- name: APP_SECURITY_CORS_MAX_AGE
|
|
# source: feature-security-operational-baseline 2026-05-22
|
|
# "preflight max-age 600s default"
|
|
type: duration
|
|
default: 600s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: spring_duration_shorthand
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:cors-preflight-max-age
|
|
|
|
- name: APP_SECURITY_AUTH_MODE
|
|
type: enum
|
|
default: jwt
|
|
allowed_values: [jwt, redis-session]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:auth-mode-exclusive
|
|
|
|
- name: APP_SESSION_COOKIE_NAME
|
|
type: string
|
|
default: CA_SESSION
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: bounded_cookie_name
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:cookie-hardened
|
|
|
|
- name: APP_SESSION_COOKIE_SECURE
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: must_be_true
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:cookie-hardened
|
|
|
|
- name: APP_SESSION_COOKIE_HTTP_ONLY
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: must_be_true
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:cookie-hardened
|
|
|
|
- name: APP_SESSION_COOKIE_SAME_SITE
|
|
type: enum
|
|
default: Lax
|
|
allowed_values: [Lax, Strict, None]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:cookie-hardened
|
|
|
|
- name: APP_SESSION_COOKIE_PATH
|
|
type: string
|
|
default: /
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: bounded_absolute_path
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:cookie-hardened
|
|
|
|
- name: APP_SESSION_CSRF_COOKIE_NAME
|
|
type: string
|
|
default: XSRF-TOKEN
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: bounded_cookie_name
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:csrf-enabled
|
|
|
|
- name: APP_SESSION_CSRF_HEADER_NAME
|
|
type: string
|
|
default: X-XSRF-TOKEN
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: bounded_header_name
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:csrf-enabled
|
|
|
|
- name: APP_SESSION_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:key-namespace
|
|
|
|
- name: APP_SESSION_IDLE_TIMEOUT
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 30m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_duration_le_30d
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:idle-expiry
|
|
|
|
- name: APP_SESSION_ABSOLUTE_LIFETIME
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 8h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_duration_le_30d
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:absolute-expiry
|
|
|
|
- name: APP_SESSION_TOUCH_INTERVAL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 1m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_duration_lt_idle
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:bounded-touch
|
|
|
|
- name: APP_SESSION_TOMBSTONE_TTL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 5m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_duration_gt_route_drain
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:logout-tombstone
|
|
|
|
- name: APP_SESSION_MAXIMUM_ENVELOPE_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 32768
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: int_range_64_1048576
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:serializer-bounded
|
|
|
|
- name: APP_SESSION_MAXIMUM_ATTRIBUTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 64
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: int_range_1_256
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:serializer-bounded
|
|
|
|
- name: APP_SESSION_MAXIMUM_SCALAR_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 8192
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_int_le_envelope
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:serializer-bounded
|
|
|
|
- name: APP_SECURITY_JWT_ISSUER
|
|
# source: feature-security-operational-baseline 2026-05-22
|
|
# "issuer mismatch | 401 | AUTH_ISSUER_MISMATCH"
|
|
type: url
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: url_required
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:jwt-issuer-set
|
|
|
|
- name: APP_SECURITY_JWT_AUDIENCE
|
|
# source: feature-security-operational-baseline 2026-05-22
|
|
# "audience mismatch | 401 | AUTH_AUDIENCE_MISMATCH"
|
|
type: csv_list
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-security-operational-baseline
|
|
validation: csv_non_empty
|
|
compatibility_impact: behavior-change
|
|
required_test: security-contract:jwt-audience-set
|
|
|
|
- name: APP_RATE_LIMIT_ENABLED
|
|
# 정확한 provider를 고르기 전까지 inbound 강제는 꺼져 있다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-rate-limit-contract:transport-provider-default-pair
|
|
|
|
# APP_RATE_LIMIT_CLIENT_IP_MODE는 지웠다 (2026-09-25, review follow-up I-5a): 그 값
|
|
# forwarded-headers-trusted는 인증하지 않은 호출자를 X-Forwarded-For의 맨 왼쪽 값으로 구분했는데, 그 값은
|
|
# 호출자가 쓴다. client IP는 getRemoteAddr()다. proxy 뒤라면
|
|
# APP_SERVER_FORWARD_HEADERS_STRATEGY=native와 server.tomcat.remoteip.internal-proxies를 설정한다.
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_ENABLED
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.enabled (APP_REDIS_ENABLED).
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-disabled-zero-side-effect
|
|
|
|
- name: APP_RATE_LIMIT_PROVIDER
|
|
type: enum
|
|
default: disabled
|
|
allowed_values: [disabled, redis]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:provider-explicit
|
|
|
|
- name: APP_RATE_LIMIT_FAILURE_POLICY
|
|
type: enum
|
|
default: fail-closed
|
|
allowed_values: [fail-closed]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:fail-closed-only
|
|
|
|
- name: APP_RATE_LIMIT_DEFAULT_POLICY_ID
|
|
type: string
|
|
default: api-default
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:default-policy-resolves
|
|
|
|
- name: APP_RATE_LIMIT_FAILURE_RETRY_AFTER
|
|
type: duration
|
|
default: 100ms
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: spring_duration_shorthand_non_zero_le_30d
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:failure-retry-bounded
|
|
|
|
- name: APP_RATE_LIMIT_HASH_KEY_VERSION
|
|
type: int
|
|
default: 1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: int_1_to_9999
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:hash-version-bounded
|
|
|
|
- name: APP_RATE_LIMIT_KEY_VERSION
|
|
type: int
|
|
default: 1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: int_1_to_9999
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:key-version-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_HOST
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.nodes (APP_REDIS_NODES).
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: non_empty_string_when_rate_limit_redis_enabled
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-host-required
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_PORT
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.nodes (APP_REDIS_NODES).
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 6379
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: port_range_1_65535
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-port-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_PASSWORD
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: must_not_be_local_dev_sentinel_in_prod
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-password-no-leak
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_TRUST_PEM
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.tls.trust-material-resource.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: non_blank_pem_when_coordination_role_is_bound
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:coordination-trust-material-no-leak
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: base64_min_32_bytes_when_rate_limit_redis_enabled
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-hmac-required
|
|
|
|
- name: APP_SESSION_REDIS_PASSWORD
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: non_blank_when_session_role_is_bound
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:session-password-no-leak
|
|
|
|
- name: APP_SESSION_REDIS_TRUST_PEM
|
|
# 폐기 2026-08-10: 이 값을 바인딩하던 session 세대를 지웠고, 대신한 것도 자기 Redis client를 갖지 않는다.
|
|
# 대체: app.redis.tls.trust-material-resource.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: non_blank_pem_when_session_role_is_bound
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:session-trust-material-no-leak
|
|
|
|
- name: APP_SESSION_REDIS_KEY_HMAC_SECRET
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: base64_min_32_bytes_when_redis_session_enabled
|
|
compatibility_impact: additive
|
|
required_test: redis-session-contract:key-hmac-no-leak
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_COMMAND_TIMEOUT
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: spring_duration_shorthand_non_zero_le_30s
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-timeout-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_COMMAND_BYTES
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.limits.max-batch-request-bytes.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 16384
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: int_16384_to_65536
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-command-bytes-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_QUEUED_COMMANDS
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.capacity.maximum-in-flight-commands.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 32
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: int_1_to_4096
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-queue-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_IN_FLIGHT_BYTES
|
|
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
|
|
# 대체: app.redis.capacity.maximum-in-flight-bytes.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 1048576
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: covers_rate_limit_command_and_le_268435456
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-byte-admission-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 폐기 2026-08-10: rate limiter는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
|
|
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:redis-namespace-bounded
|
|
|
|
- name: APP_RATE_LIMIT_POLICY_REVISION
|
|
type: string
|
|
default: v1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:policy-revision-bounded
|
|
|
|
- name: APP_RATE_LIMIT_ALGORITHM
|
|
type: enum
|
|
default: sliding-counter
|
|
allowed_values: [fixed-window, sliding-counter, token-bucket]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:algorithm-selectable
|
|
|
|
- name: APP_RATE_LIMIT_LIMIT
|
|
type: int
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: positive_lua_exact_integer
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:limit-bounded
|
|
|
|
- name: APP_RATE_LIMIT_WINDOW
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: spring_duration_shorthand_non_zero_le_1d
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:window-bounded
|
|
|
|
- name: APP_RATE_LIMIT_CAPACITY
|
|
type: int
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: positive_lua_exact_integer
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:capacity-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REFILL_TOKENS
|
|
type: int
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: positive_lua_exact_integer
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:refill-tokens-bounded
|
|
|
|
- name: APP_RATE_LIMIT_REFILL_PERIOD
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: spring_duration_shorthand_non_zero_le_1d
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:refill-period-bounded
|
|
|
|
- name: APP_RATE_LIMIT_MAXIMUM_COST
|
|
type: int
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: positive_lua_exact_integer
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:maximum-cost-bounded
|
|
|
|
- name: APP_RATE_LIMIT_CLEANUP_GRACE
|
|
type: duration
|
|
default: 5s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-distributed-rate-limit
|
|
validation: spring_duration_shorthand_non_zero_le_1d
|
|
compatibility_impact: additive
|
|
required_test: rate-limit-contract:cleanup-grace-bounded
|
|
|
|
- name: APP_IDEMPOTENCY_TTL
|
|
# app.capabilities.idempotency.replay-ttl: 끝난 응답을 다시 돌려줄 수 있는 기간. 모든 provider가
|
|
# 같은 값을 쓴다. IdempotencySettings는 기동할 때 72h보다 길거나, APP_IDEMPOTENCY_PROCESSING_LEASE보다
|
|
# 짧거나(re-review 2026-11-04 RR-03-11), APP_IDEMPOTENCY_FAILURE_RETENTION보다 긴 값(RR3-03-02, 소유자
|
|
# 결정 2026-11-04)을 거부한다. 이 키만 실패 보관 기간(기본 24h)보다 길게 올리면 기동이 실패하니 둘을 같이
|
|
# 올린다(RR5-03-01). 두 저장소 모두에서 기록 하나는 처리 lease에 이 값을 더한 만큼 남는다.
|
|
type: duration
|
|
default: 24h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
validation: spring_duration_shorthand_le_72h_ge_processing_lease_le_failure_retention
|
|
compatibility_impact: behavior-change
|
|
required_test: idempotency-contract:ttl-applied
|
|
|
|
- name: APP_IDEMPOTENCY_PROVIDER
|
|
# app.capabilities.idempotency.provider. redis와 postgresql은 각각 저장소만 기여한다. app-bootstrap이
|
|
# IdempotencyExecutor 하나를 만들고, 저장소가 정확히 하나가 아니면 기동을 거부한다. postgresql은 주
|
|
# data source를 쓰고, 기동할 때 자기 Flyway stream을 적용하고, PostgreSQL이 아닌 data source를 거부한다.
|
|
# 그래서 bootRunH2는 disabled나 redis로 돈다. 선택은 명시적이고 기본은 disabled다. classpath에 있다는
|
|
# 것만으로 고르는 구현은 없다.
|
|
# 2026-09-25: jdbc(V1 저장소)를 지웠다. 아직 이 값을 쓰는 배포는 바인딩에서 실패한다.
|
|
type: enum
|
|
default: disabled
|
|
allowed_values: [disabled, redis, postgresql]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: enum_strict
|
|
compatibility_impact: breaking
|
|
required_test: redis-idempotency-contract:provider-exclusive
|
|
|
|
- name: APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET
|
|
# 폐기 2026-09-22: Redis idempotency adapter는 호출자가 준 scope digest를 쓰고 이 비밀을 읽은 적이 없다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-12-31
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: base64_min_32_bytes_when_redis_idempotency_enabled
|
|
compatibility_impact: additive
|
|
required_test: redis-idempotency-contract:key-hmac-no-leak
|
|
|
|
- name: APP_IDEMPOTENCY_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 폐기 2026-08-10: idempotency store는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
|
|
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: redis-idempotency-contract:key-namespace
|
|
|
|
- name: APP_IDEMPOTENCY_PROCESSING_LEASE
|
|
# app.capabilities.idempotency.processing-lease: 시도 하나가 claim을 쥐는 기간. in-flight
|
|
# Retry-After(2s)보다 길고, 최대 1h이며, APP_IDEMPOTENCY_TTL보다 길지 않다. lease가 끝난 claim은 시작하지
|
|
# 않았을 때만 넘겨받는다. lease가 끝난 실행은 IDEMPOTENCY_RECOVERY_REQUIRED로 답하고 다시 돌리지 않는다.
|
|
type: duration
|
|
default: 30s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: duration_gt_in_flight_retry_after_2s_le_1h
|
|
compatibility_impact: additive
|
|
required_test: redis-idempotency-contract:processing-lease-bounded
|
|
|
|
- name: APP_IDEMPOTENCY_FAILURE_RETENTION
|
|
# app.capabilities.idempotency.failure-retention: executor가 실패로 표시한 기록(결과를 모른 채
|
|
# 버렸거나, 결과 없이 다시 시도할 수 있는 것)이 표시한 때부터 남는 기간. 최대 30d이고,
|
|
# IdempotencySettings는 기동할 때 APP_IDEMPOTENCY_TTL보다 짧은 값을 거부한다: 더 짧으면 버린 기록이 먼저
|
|
# 사라지고, 같은 key로 다시 보낸 요청이 일을 한 번 더 한다(re-review 2026-11-04 RR3-03-02, 소유자 결정
|
|
# 2026-11-04).
|
|
type: duration
|
|
default: 24h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: positive_duration_le_30d_ge_replay_ttl
|
|
compatibility_impact: behavior-change
|
|
required_test: redis-idempotency-contract:failure-retention-bounded
|
|
|
|
- name: APP_LEASE_PROVIDER
|
|
type: enum
|
|
default: disabled
|
|
allowed_values: [disabled, redis]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-lease-contract:provider-exclusive
|
|
|
|
- name: APP_LEASE_REDIS_KEY_HMAC_SECRET
|
|
# 폐기 2026-09-22: Redis lease adapter는 호출자가 준 resource digest를 쓰고 이 비밀을 읽은 적이 없다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-12-31
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: base64_min_32_bytes_when_redis_lease_enabled
|
|
compatibility_impact: additive
|
|
required_test: redis-lease-contract:key-hmac-no-leak
|
|
|
|
- name: APP_LEASE_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 폐기 2026-08-10: lease는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
|
|
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: lowercase_slug
|
|
compatibility_impact: additive
|
|
required_test: redis-lease-contract:key-namespace
|
|
|
|
- name: APP_LEASE_REDIS_DRIFT_BUDGET
|
|
type: duration
|
|
default: 10ms
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: non_negative_duration_lt_minimum_lease
|
|
compatibility_impact: additive
|
|
required_test: redis-lease-contract:drift-budget-bounded
|
|
|
|
# === 캐시 / Redis (feature-cache-consistency-contract + integration-adapter-templates) ===
|
|
|
|
- name: APP_CACHE_CANONICAL_DEFAULT_PROVIDER
|
|
# 기본 캐시 영역(canonical default semantic region)의 provider 선택. 옛 켜기 키는 따로 옮겨 가는 경로다.
|
|
type: enum
|
|
default: disabled
|
|
allowed_values: [disabled, redis]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-cache:canonical-cache-role-composition
|
|
|
|
- name: APP_REDIS_ENABLED
|
|
# 2026-09-25 capability 포장: cache-redis 모듈은 있으면 켜진다(모듈의
|
|
# config/module-defaults/cache-redis.yml이 이 키를 기본 true로 잇는다). false가 명시적으로 끄는 값이다.
|
|
# 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# false면 Redis 설정을 읽지 않고, Redis 비밀을 요구하지 않고, client·연결·thread·health contributor를
|
|
# 만들지 않는다. Redis가 켜진 뒤 어떤 capability를 조립할지는 role 선택자가 고른다. 그중 어느 것도 두
|
|
# 번째 켜고 끄기 키가 아니다.
|
|
property: app.redis.enabled
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: always-optional
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: redis-capability-activation:the-switch-off-leaves-no-redis-bean-and-needs-no-redis
|
|
|
|
|
|
- name: APP_CACHE_REDIS_POSITIVE_HARD_TTL
|
|
# 캐시 항목을 쓸 수 있는 기간. Redis의 실제 TTL은 이 값과 같고 다른 것이 아니다. 그래서 항목이 배포가
|
|
# 정한 사용 기간보다 오래 남거나 일찍 버려지지 않는다.
|
|
type: duration
|
|
default: 5m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_shorthand_ge_minimum_hard_ttl
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:cache-region-composition
|
|
|
|
- name: APP_CACHE_REDIS_NEGATIVE_TTL
|
|
# 권위 있는 「없음」을 캐시하는 기간. 「원천에 이것이 없다」는 사실은 값과 유통 기한이 달라서 값의
|
|
# TTL과 따로 둔다.
|
|
type: duration
|
|
default: 10s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_shorthand_non_zero
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:cache-region-composition
|
|
|
|
- name: APP_CACHE_REDIS_MAXIMUM_SCRIPT_CONNECTIONS
|
|
# 캐시 자신의 script lane 연결 수. idempotency·rate limit·lease가 함께 쓰는
|
|
# APP_REDIS_CAPACITY_MAXIMUM_SCRIPT_CONNECTIONS와 따로 두어, 캐시 채우기가 그 셋을 굶기지 않게 한다
|
|
# (review 2026-11-03 README 4절, RR-04-02).
|
|
property: app.capabilities.cache.maximum-script-connections
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: integer
|
|
default: 4
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.capabilities.cache.bindings.default=redis
|
|
reload_policy: restart-only
|
|
owner_branch: refactor/maturity-review-2026-11
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:cache-script-lane-separate-from-correctness
|
|
|
|
- name: APP_IDEMPOTENCY_REDIS_COMMAND_TIMEOUT
|
|
# owner-safe 전이 하나의 상한.
|
|
type: duration
|
|
default: 200ms
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_shorthand_non_zero
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:idempotency-store-composition
|
|
|
|
- name: APP_LEASE_REDIS_COMMAND_TIMEOUT
|
|
# lease 연산 하나의 상한.
|
|
type: duration
|
|
default: 200ms
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_shorthand_non_zero
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:lease-composition
|
|
|
|
- name: APP_LEASE_REDIS_CONTENTION_RETRY_AFTER
|
|
# 경합으로 acquire에 실패한 호출자에게 기다리라고 알려 줄 시간. drift 예산과 다르다: 하나는 진
|
|
# 호출자에게 주는 조언이고, 다른 하나는 이긴 쪽이 자기 lease 중 믿지 않는 부분이다.
|
|
type: duration
|
|
default: 50ms
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_shorthand_non_zero
|
|
compatibility_impact: additive
|
|
required_test: redis-capability:lease-composition
|
|
|
|
# --- Redis 런타임 설정 (app.redis.*) ----------------------------------
|
|
# APP_REDIS_ENABLED가 true일 때만 adapter-outbound-redis-runtime의 RedisRuntimeAutoConfiguration이
|
|
# 바인딩한다. application.yml은 Redis 없는 배포에 이 값을 넣지 않는다. .env.example은 운영자가
|
|
# 명시적으로 넣을 값을 적어 둘 뿐이다. verifyEnvKeys가 이 레지스트리를 런타임 모듈의 설정 메타데이터와
|
|
# 대조한다.
|
|
|
|
- name: APP_REDIS_DATABASE
|
|
# Cluster는 database 0만 지원한다. 0이 아니면 거기서 기동이 실패한다.
|
|
property: app.redis.database
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: integer
|
|
default: 0
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_MODE
|
|
# standalone | sentinel | cluster.
|
|
property: app.redis.mode
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: enum
|
|
default: "standalone"
|
|
allowed_values: [standalone, sentinel, cluster]
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_NAMESPACE_DOMAIN
|
|
property: app.redis.namespace.domain
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: string
|
|
default: "shared"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_NAMESPACE_ENVIRONMENT
|
|
property: app.redis.namespace.environment
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: string
|
|
default: "local"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_NAMESPACE_SERVICE
|
|
property: app.redis.namespace.service
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: string
|
|
default: "sample-service"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_NODES
|
|
# host:port CSV. Cluster와 Sentinel은 모든 seed node를 받는다.
|
|
property: app.redis.nodes
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: csv
|
|
default: "localhost:6379"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: csv_nonempty
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_TIMEOUT_BATCH
|
|
property: app.redis.timeout.batch
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: duration
|
|
default: "2s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_TIMEOUT_FAST
|
|
# 단일 key 명령 profile. 5s를 넘으면 기동 때 경고를 남긴다.
|
|
property: app.redis.timeout.fast
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: duration
|
|
default: "500ms"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
- name: APP_REDIS_TIMEOUT_SCRIPT
|
|
property: app.redis.timeout.script
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: duration
|
|
default: "1s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:typed-settings-bound-and-validated
|
|
|
|
# --- Redis 런타임 조립 설정 (app.redis.*) ----------------------
|
|
# 인증, Sentinel 탐색, TLS, 수명 주기, Cluster 라우팅, 용량. 다른 app.redis.*와 규칙이 같다:
|
|
# APP_REDIS_ENABLED가 true일 때만 바인딩하고, application.yml과 .env에는 일부러 두지 않는다.
|
|
|
|
- name: APP_REDIS_AUTHENTICATION_ADVANCED_CREDENTIAL_REFERENCE
|
|
# 등록된 script가 실행될 계정을 가리키는 참조. 애플리케이션 참조와 같은
|
|
# secret://<acl-account>@<source>/<name> 형식이다. 비우면 script가 애플리케이션 계정으로 돌고 기동 때 그렇다고
|
|
# 경고를 남긴다. Compose Redis lane은 compose/redis/acl/lane-fixture-accounts.acl의 fixture 계정인
|
|
# secret://ca-skeleton-application-advanced@environment/REDIS_LANE_ADVANCED_PASSWORD를 쓴다.
|
|
property: app.redis.authentication.advanced-credential-reference
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED
|
|
property: app.redis.authentication.anonymous-access-accepted
|
|
owner_module: adapter-outbound-cache-redis
|
|
# Redis가 자격 증명 없이 돈다는 것을 명시적으로 인정하는 값. 자격 증명 참조가 없을 때 이 값이 없으면
|
|
# 기동이 실패한다. 그대로 기동하면 인증 없는 client가 만들어지고, `default` ACL 사용자를 끈 배포에서는
|
|
# 명령 하나도 돌리지 못한다 — 실패가 기동에서 첫 요청으로 옮겨 가고, 빠진 설정이 아니라 장애처럼 보인다.
|
|
# true로 두면 배포는 돌고 그 trade-off를 로그에 남긴다.
|
|
# 이 값을 쓰는 Compose lane은 없다: Redis lane은 대신 fixture 계정으로 인증한다. 이 값이 남기는 경고가 바로
|
|
# lane의 「기동은 조용하다」 검사가 잡으려는 것이기 때문이다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true이고 자격 증명 참조를 설정하지 않았을 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:authentication-required-unless-anonymous-accepted
|
|
|
|
- name: APP_REDIS_AUTHENTICATION_CREDENTIAL_REFERENCE
|
|
# 애플리케이션 ACL 계정 자격 증명을 가리키는 참조. 값은 secret manager에 있다.
|
|
# 형식: secret://<acl-account>@<source>/<name>. environment source는 변수 <name>을 읽는다. 계정 부분이
|
|
# 없으면 client가 `default`로 인증하는데, 단단히 설정한 Redis는 그 사용자를 끈다. Compose Redis lane은
|
|
# compose/redis/acl/lane-fixture-accounts.acl의 fixture 계정인
|
|
# secret://ca-skeleton-application@environment/REDIS_LANE_APPLICATION_PASSWORD를 쓴다.
|
|
property: app.redis.authentication.credential-reference
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_CAPACITY_MAXIMUM_IN_FLIGHT_COMMANDS
|
|
property: app.redis.capacity.maximum-in-flight-commands
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: integer
|
|
default: 64
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_CAPACITY_MAXIMUM_SCRIPT_CONNECTIONS
|
|
# 실제 SCRIPT lane 연결 수는 연결마다의 명령 queue와 따로 제한한다.
|
|
property: app.redis.capacity.maximum-script-connections
|
|
owner_module: adapter-outbound-redis-runtime
|
|
type: integer
|
|
default: 8
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-cache-redis-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: redis-runtime:script-lane-physical-connections-bounded
|
|
|
|
- name: APP_REDIS_CAPACITY_REJECT_WHEN_DISCONNECTED
|
|
# true면 연결이 끊긴 동안 명령을 거부한다. false면 driver의 offline queue를 되살리는데, 다시 연결될 때 쌓인 쓰기를 끊긴 동안의 순서와 상관없이 몰아서 다시 보낸다.
|
|
property: app.redis.capacity.reject-when-disconnected
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_CLUSTER_MAXIMUM_REDIRECTS
|
|
property: app.redis.cluster.maximum-redirects
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: integer
|
|
default: 5
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_CLUSTER_TOPOLOGY_REFRESH_PERIOD
|
|
property: app.redis.cluster.topology-refresh-period
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "30s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_ACQUIRE_TIMEOUT
|
|
# lane이 연결을 빌릴 때, 돌려받은 연결을 기다리는 시간. 넘으면 보내지 않은 것으로 거부한다.
|
|
property: app.redis.lifecycle.acquire-timeout
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "2s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_CLIENT_NAME
|
|
property: app.redis.lifecycle.client-name
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: "ca-skeleton"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_CONNECT_TIMEOUT
|
|
property: app.redis.lifecycle.connect-timeout
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "2s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_DRAIN_TIMEOUT
|
|
# 종료할 때 연결을 닫기 전에 처리 중인 명령을 기다리는 시간.
|
|
property: app.redis.lifecycle.drain-timeout
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "6s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_SHUTDOWN_QUIET_PERIOD
|
|
property: app.redis.lifecycle.shutdown-quiet-period
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "100ms"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_LIFECYCLE_SHUTDOWN_TIMEOUT
|
|
property: app.redis.lifecycle.shutdown-timeout
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: duration
|
|
default: "3s"
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: duration_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_SENTINEL_CREDENTIAL_REFERENCE
|
|
property: app.redis.sentinel.credential-reference
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
# 있을 때만 적용한다: RedisTopologyClientFactory가 sentinel 자격 증명 provider를 ifPresent로 설정한다.
|
|
# 그래서 sentinel이 인증 없는 탐색을 받는 Sentinel 배포는 이 값 없이 뜬다. 예전에 적었던 무조건
|
|
# "app.redis.mode=sentinel"은 런타임이 강제한 적 없는 요구였다.
|
|
required_when: app.redis.mode=sentinel이고 sentinel이 인증을 요구할 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_SENTINEL_MASTER_NAME
|
|
property: app.redis.sentinel.master-name
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.mode=sentinel
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_SENTINEL_NODES
|
|
property: app.redis.sentinel.nodes
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: csv
|
|
default: app.redis.nodes
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
# 설계상 app.redis.nodes로 돌아간다. 그래서 nodes에 sentinel을 적고 다른 것은 말하지 않은 배포가 잘못된
|
|
# 설정이 아니라 흔한 경우다.
|
|
required_when: app.redis.mode=sentinel이고 app.redis.nodes에 sentinel이 없을 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: csv_nonempty
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_TLS_CLIENT_CERTIFICATE_RESOURCE
|
|
property: app.redis.tls.client-certificate-resource
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
# key manager는 이 값이 있을 때만 설정한다. 보통의 단방향 TLS에는 client 인증서가 필요 없으니, TLS가
|
|
# 켜질 때마다 요구하는 것은 런타임이 한 적 없는 주장이었다.
|
|
required_when: app.redis.tls.enabled=true이고 서버가 mutual TLS를 요구할 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_TLS_CLIENT_KEY_REFERENCE
|
|
property: app.redis.tls.client-key-reference
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
# 켜고 끄는 값이 아니라 두 설정 사이의 관계다: key 없는 client 인증서로는 key manager를 만들 수 없다.
|
|
# RedisRuntimeSettings.validate가 강제하고 RedisRuntimeSettingsTest가 다룬다. 레지스트리의 글로 쓴 조건은
|
|
# 거기서 증명한다.
|
|
required_when: app.redis.tls.client-certificate-resource를 설정했을 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_TLS_ENABLED
|
|
property: app.redis.tls.enabled
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_TLS_HOSTNAME_VERIFICATION
|
|
# 이 값을 끄면 trust material이 서명한 모든 인증서를 어떤 host에 대해서도 받는다.
|
|
property: app.redis.tls.hostname-verification
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: app.redis.enabled=true
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
|
|
- name: APP_REDIS_TLS_TRUST_MATERIAL_RESOURCE
|
|
property: app.redis.tls.trust-material-resource
|
|
owner_module: adapter-outbound-cache-redis
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
# trust manager는 이 값이 있을 때만 설치한다. 없으면 JDK 기본 신뢰 앵커를 쓰고, 공개 CA가 발급한 서버
|
|
# 인증서에는 그것으로 충분하다.
|
|
required_when: app.redis.tls.enabled=true이고 서버 인증서가 공개 신뢰 체인에 없을 때
|
|
reload_policy: restart-only
|
|
owner_branch: redis-optionality-and-composition
|
|
validation: nonblank_when_required
|
|
compatibility_impact: additive
|
|
required_test: redis-sdk:runtime-composition-binds-and-validates
|
|
- name: APP_CACHE_REDIS_ENABLED
|
|
# source: feature-integration-adapter-templates 2026-05-22
|
|
# "Redis | disabled optional module | cache consistency" + Adapter Template Defaults 표
|
|
# 폐기 2026-08-10: 두 번째 Redis 전체 스위치였고, 이를 바인딩하던 settings class를 옛 Redis 세대와 함께
|
|
# 지워서 이 키는 어디에도 닿지 않는다. 전역 켜기는 APP_REDIS_ENABLED 하나가 정한다. 캐시 role은
|
|
# app.capabilities.cache.bindings.default가 고른다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고
|
|
# 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
deprecated_alias_for: APP_REDIS_ENABLED
|
|
removal_deadline: 2026-11-30
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:redis-disabled-default
|
|
|
|
- name: APP_CACHE_REDIS_CLIENT_MODE
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: enum
|
|
default: managed
|
|
allowed_values: [managed, external]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: enum_strict
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:redis-client-mode-explicit
|
|
|
|
- name: APP_CACHE_REDIS_HOST
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
# source: feature-cache-consistency-contract — Redis adapter (켜면 endpoint가 필요하다)
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-cache-consistency-contract
|
|
validation: non_empty_string_when_redis_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: cache-contract:redis-host-when-enabled
|
|
|
|
- name: APP_CACHE_REDIS_PORT
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
# source: feature-cache-consistency-contract — Redis adapter endpoint
|
|
type: int
|
|
default: 6379
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-cache-consistency-contract
|
|
validation: port_range_1_65535
|
|
compatibility_impact: behavior-change
|
|
required_test: cache-contract:redis-port-bound
|
|
|
|
- name: APP_CACHE_REDIS_PASSWORD
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: must_not_be_local_dev_sentinel_in_prod
|
|
compatibility_impact: additive
|
|
required_test: secrets-contract:redis-password-no-leak
|
|
|
|
- name: APP_CACHE_REDIS_TRUST_PEM
|
|
# 폐기 2026-08-10: 캐시는 이제 자기 Redis client를 갖지 않아서 이 값을 읽는 코드가 없다.
|
|
# 대체: app.redis.tls.trust-material-resource (APP_REDIS_TLS_TRUST_MATERIAL_RESOURCE). Redis client 하나가 모든 capability에 이 값을 쓴다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: non_blank_pem_when_cache_role_is_bound
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:cache-trust-material-no-leak
|
|
|
|
- name: APP_REDIS_SEMANTIC_PROBE_MINIMUM_INTERVAL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 5s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_1s_to_60s
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:semantic-probe-cadence-bounded
|
|
|
|
- name: APP_REDIS_SENTINEL_DISCOVERY_REFRESH_PERIOD
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 30s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_5s_to_5m_inclusive
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:sentinel-discovery-refresh-period-bounded
|
|
|
|
- name: APP_REDIS_SEMANTIC_PROBE_MAXIMUM_STALENESS
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 15s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability-completion
|
|
validation: spring_duration_gte_probe_minimum_and_lte_5m
|
|
compatibility_impact: additive
|
|
required_test: redis-contract:semantic-probe-staleness-bounded
|
|
|
|
- name: APP_CACHE_REDIS_KEY_HMAC_SECRET
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: base64_min_32_bytes_when_redis_enabled
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-hmac-secret-bounded
|
|
|
|
- name: APP_CACHE_REDIS_COMMAND_TIMEOUT
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 2s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: spring_duration_shorthand_non_zero_le_30s
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-command-timeout-bounded
|
|
|
|
- name: APP_CACHE_REDIS_MAXIMUM_QUEUED_COMMANDS
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 8
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: int_1_to_4096
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-command-queue-bounded
|
|
|
|
- name: APP_CACHE_REDIS_MAXIMUM_IN_FLIGHT_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 16777216
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: covers_maximum_value_and_le_268435456
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-command-byte-admission-bounded
|
|
|
|
- name: APP_CACHE_REDIS_POSITIVE_SOFT_TTL
|
|
type: duration
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-cache-resilience
|
|
validation: optional_spring_duration_non_zero_le_positive_hard_ttl
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-soft-hard-ttl-order
|
|
|
|
- name: APP_CACHE_REDIS_TTL_JITTER
|
|
# 폐기 2026-11-02: 바인딩하는 settings class가 없다. 읽던 곳은 샘플 모듈 application.yml의 블록 하나뿐이었고
|
|
# 그것도 바인딩되지 않았다(07-10). 샘플과 함께 지웠다. 아직 이 키를 쓰는 배포에 아무 일도 하지 않는다고
|
|
# 알려 주려고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2027-02-28
|
|
type: float
|
|
default: 0.10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-cache-resilience
|
|
validation: decimal_0_to_0_5
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-ttl-jitter-bounded
|
|
|
|
- name: APP_CACHE_REDIS_MINIMUM_HARD_TTL
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-cache-resilience
|
|
validation: spring_duration_shorthand_non_zero_le_configured_hard_ttls
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-hard-ttl-minimum
|
|
|
|
- name: APP_CACHE_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 폐기 2026-08-10: 캐시는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을
|
|
# 이어 prefix 넷이 생겼고, 배포를 가두려던 ACL 패턴은 그중 어느 것과도 맞지 않았다. 아직 이 키를 쓰는
|
|
# 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: lowercase_slug
|
|
compatibility_impact: behavior-change
|
|
required_test: cache-contract:redis-namespace-environment-bound
|
|
|
|
- name: APP_CACHE_REDIS_SEMANTIC_REGION
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: string
|
|
default: default
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: lowercase_slug
|
|
compatibility_impact: behavior-change
|
|
required_test: cache-contract:redis-semantic-region-bound
|
|
|
|
- name: APP_CACHE_REDIS_MAXIMUM_VALUE_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 1048576
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: codex-phase-a-ci-recovery
|
|
validation: int_1_to_16777216
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-value-size-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_ENABLED
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: boolean_strict_cache_only
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-disabled-default
|
|
|
|
- name: APP_CACHE_REDIS_L1_MAXIMUM_ENTRIES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 10000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: int_1_to_1000000
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-cardinality-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_MAXIMUM_WEIGHT_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 67108864
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: int_1_to_1073741824_accounting_proxy
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-weight-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_MAXIMUM_ENTRY_WEIGHT_BYTES
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 1048576
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: positive_not_above_l1_maximum_weight
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-entry-weight-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_TTL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 30s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: spring_duration_shorthand_non_zero_le_1h
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-ttl-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_GENERATION_RECHECK_INTERVAL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: duration
|
|
default: 5s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: spring_duration_shorthand_non_zero_le_l1_ttl
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-generation-recheck-bounded
|
|
|
|
- name: APP_CACHE_REDIS_L1_INVALIDATION_QUEUE_CAPACITY
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
type: int
|
|
default: 1024
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-production-capability
|
|
validation: int_1_to_65536
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-l1-invalidation-queue-bounded
|
|
|
|
- name: APP_CACHE_DEFAULT_TTL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
# source: feature-cache-consistency-contract 2026-05-22
|
|
# "TTL | explicit per key family | no-cache for sensitive data | immortal cache forbidden"
|
|
type: duration
|
|
default: 300s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-cache-consistency-contract
|
|
validation: spring_duration_shorthand_non_zero
|
|
compatibility_impact: behavior-change
|
|
required_test: cache-contract:default-ttl-bounded
|
|
|
|
- name: APP_CACHE_NEGATIVE_TTL
|
|
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
|
|
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2026-11-30
|
|
# source: feature-cache-consistency-contract 2026-05-22
|
|
# "negative cache 정책 = 존재하지 않는 row는 짧은 TTL(60s) 캐싱 허용"
|
|
type: duration
|
|
default: 60s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-cache-consistency-contract
|
|
validation: spring_duration_shorthand
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:negative-ttl-bounded
|
|
|
|
# === 메시징 / Kafka (feature-domain-event-outbox-contract + integration-adapter-templates) ===
|
|
|
|
- name: APP_MESSAGING_BROKER
|
|
# source: messaging multi-broker redesign 2026-06-16 — 활성 broker 하나를 고른다
|
|
# (app.messaging.broker=<brokerId>). 메시징 라이브러리(dev.cakit.messaging)가 읽는다. 옛 Kafka 전용 APP_MESSAGING_KAFKA_ENABLED를
|
|
# 대신한다. 애플리케이션 bridge는 이제 읽지 않는다: 읽던 옛 KafkaSender seam은 canonical outbox와 함께
|
|
# 지웠다(2026-09-28).
|
|
type: string
|
|
# Kafka 모듈의 config/module-defaults/messaging.yml이 기본값을 등록된 유일한 broker인 kafka로 둔다.
|
|
default: kafka
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: none
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:messaging-broker-selection
|
|
|
|
- name: APP_MESSAGING_PRODUCER_ID
|
|
# source: canonical messaging platform bridge 2026-09-18
|
|
# IntegrationEventPublishPort가 쓰는, 메시지를 내는 서비스의 논리 이름(명시값).
|
|
# 비었거나 없음 = canonical 플랫폼 bridge를 내놓지 않는다. 이름을 짐작하지 않는다.
|
|
# outbox relay를 포함해 모든 발행이 그 bridge를 거치므로, 메시징 모듈이 있고 켜진 상태에서 값이 비면 기동을
|
|
# 거부한다(2026-09-28 canonical outbox).
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_MESSAGING_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: none
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:messaging-platform-producer-id
|
|
|
|
- name: APP_MESSAGING_KAFKA_BROKERS
|
|
# source: feature-domain-event-outbox-contract — "Kafka는 optional integration adapter"
|
|
# (broker를 켜면 endpoint가 필요하다)
|
|
# Kafka 모듈의 config/module-defaults/messaging.yml을 거쳐 app.messaging.brokers.kafka.bootstrap-servers
|
|
# (메시징 플랫폼의 Kafka transport)로 간다. spring.kafka.bootstrap-servers는 읽지 않는다.
|
|
type: csv_list
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: csv_of_host_port_when_kafka_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:kafka-brokers-when-enabled
|
|
|
|
# === 알림 adapter (feature-integration-adapter-templates) ===
|
|
|
|
- name: APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED
|
|
# source: R0 Slack webhook provider 스위치. app.notification.slack-webhook.enabled로 이어진다
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-slack-provider-selection
|
|
|
|
- name: APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED
|
|
# source: R0 Google email provider 스위치. app.notification.google-email.enabled로 이어진다
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-email-provider-selection
|
|
|
|
# === HTTP Client 플랫폼 (app.httpclient.*) ===
|
|
#
|
|
# 여기에는 enabled 키만 등록한다. client별 설정은 index가 붙은 목록이라, application.yml에 틀로 적으면 모든
|
|
# 배포에 이름 없는 client가 생긴다. 그래서 배포와 상관없는 값이 없어 이 레지스트리에 둘 것이 없고,
|
|
# docs/httpclient/env-fields.yaml에 등록한다. 그 manifest는 HttpClientPlatformSettings에서 나오고 양쪽으로
|
|
# 강제된다: 항목이 없는 필드는 HttpClientPlatformEnvManifestTest가 실패하고, 필드가 없는 APP_HTTPCLIENT_
|
|
# 변수는 기동이 실패한다.
|
|
|
|
- name: APP_HTTPCLIENT_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
|
|
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# false인 동안 플랫폼 블록을 전혀 바인딩하지 않는다: 바인딩하는 자동 설정을 처리하지 않으므로 bean,
|
|
# connection pool, TLS context, 자격 증명, thread, gateway가 생기지 않고, 잘못된 HTTP client 설정이 이 배포의
|
|
# 기동을 실패시킬 수 없다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: httpclient-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: httpclient-platform:off-state-zero-side-effects-and-env-manifest-parity
|
|
|
|
- name: APP_HTTPCLIENT_ROTATION_DRAIN_TIMEOUT
|
|
# 인증서를 교체한 뒤, 물러난 런타임 세대가 처리 중인 것을 마저 끝낼 수 있는 기간. 이 시간이 지나면
|
|
# 그 connection pool을 닫는다. 교체는 자료를 제자리에서 바꾸지 않고 세대를 바꾼다. pool이 옛 신원으로 맺은
|
|
# 소켓을 들고 있기 때문이다. 이 값이 옛 신원이 일을 끝낼 수 있는 시간이다.
|
|
type: duration
|
|
default: 30s
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: httpclient-platform-activation-boundary
|
|
compatibility_impact: additive
|
|
required_test: httpclient-platform:off-state-zero-side-effects-and-env-manifest-parity
|
|
|
|
# === Fileserver HTTP platform (app.fileserver-platform.*) ===
|
|
|
|
- name: APP_FILESERVER_PLATFORM_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
|
|
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# false인 동안 플랫폼 블록을 전혀 바인딩하지 않는다: 바인딩하는 자동 설정을 처리하지 않으므로 bean, route,
|
|
# thread, schema 검사, 파일 시스템 호출이 생기지 않는다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_INSTANCE_ID
|
|
# writer lease의 소유자. 인스턴스마다 달라야 한다. 기동 관문은 기본값을 단일 인스턴스로 보고, 지원할 수
|
|
# 없는 공유 메타데이터 claim을 거부한다.
|
|
type: string
|
|
default: local-node
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DEFAULT_NAMESPACE
|
|
# namespace를 적지 않은 요청에 쓰는 namespace.
|
|
type: string
|
|
default: default
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TARGET_NAMESPACES
|
|
# copy와 move가 기본 namespace(늘 허용) 밖에 쓸 수 있는 namespace. 비면 기본 namespace만이고, 다른
|
|
# 대상은 ACCESS_DENIED다.
|
|
type: csv_list
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: storage_namespace_list
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_STORAGE_ROOT
|
|
# 자기 volume 위의 절대 경로. 상대 경로는 프로세스 실행 위치를 기준으로 풀리는데, 그 위치가 container와
|
|
# 테스트에서 달라서 거부한다.
|
|
type: string
|
|
default: /var/lib/backend/files
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: absolute_path_outside_forbidden_ancestors
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_STORAGE_PUBLISH_MODE
|
|
# atomic-move-required는 확인 과정이 원자적 이름 바꾸기를 증명하지 못하면 기동을 실패시킨다.
|
|
type: string
|
|
default: atomic-move-preferred
|
|
allowed_values: [atomic-move-required, atomic-move-preferred, metadata-pointer]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_STORAGE_BUFFER_SIZE
|
|
# 모든 전송의 할당을 제한한다. 그래서 메모리에 머무는 바이트가 파일 크기에 따라 늘지 않는다.
|
|
type: data_size
|
|
default: 128KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: between_4kb_and_8mb
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_STORAGE_FORBIDDEN_ROOT_ANCESTORS
|
|
# web root 아래의 저장소 root는 모든 업로드를 공개 파일로 만들고, config root 아래면 설정 변경으로
|
|
# 만든다. 둘 다 바인딩할 때 거부한다.
|
|
type: csv_list
|
|
default: /app,/etc,/usr/share/nginx/html
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: absolute_path_list
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_FILE_SIZE
|
|
# spring.servlet.multipart.max-file-size도 이 값이 정한다. 둘에 자리표시자 하나다: servlet 상한이 더
|
|
# 작으면 Fileserver 코드(오류 매핑 포함)에 닿기 전에 업로드를 거부한다.
|
|
type: data_size
|
|
default: 100MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_REQUEST_SIZE
|
|
# Also drives spring.servlet.multipart.max-request-size.
|
|
type: data_size
|
|
default: 110MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: at_least_max_file_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_INITIAL_RESERVATION
|
|
# 길이를 밝히지 않은 업로드에 잡아 두는 할당량.
|
|
type: data_size
|
|
default: 8MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: at_most_max_file_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_PARTS
|
|
# multipart/batch 요청 하나의 part 수 상한.
|
|
type: integer
|
|
default: 16
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_TTL
|
|
# 업로드 자원을 회수할 수 있게 되기까지의 수명.
|
|
type: duration
|
|
default: 1h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_RESERVATION_TTL
|
|
# 업로드가 끝나지 않은 할당량 예약의 수명.
|
|
type: duration
|
|
default: 24h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_LEASE_DURATION
|
|
# writer lease. 전송하는 동안 이 값의 1/3마다 갱신한다. 갱신하지 못한 전송은 다음 실제 쓰기 전에
|
|
# 막힌다(fenced).
|
|
type: duration
|
|
default: 30s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_UPLOAD_REQUIRE_CONTENT_LENGTH
|
|
# true면 Content-Length 없는 raw 업로드를 411로 거부한다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_CACHE_CONTROL
|
|
# 모든 다운로드 응답에 붙이는 Cache-Control.
|
|
type: string
|
|
default: private, no-store
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_INLINE_ALLOWED
|
|
# inline 표시는 기본으로 꺼져 있다. script가 돌 수 있는 내용은 설정과 상관없이 attachment로 보낸다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_MAX_RANGES
|
|
# 여러 범위 요청은 켜야 쓴다. 둘 이상이면 응답이 multipart/byteranges다.
|
|
type: integer
|
|
default: 1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: between_1_and_8
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_MAX_RANGE_BYTES
|
|
# 범위 하나 profile에도 적용한다. 그래서 거의 모든 배포가 쓰는 기본 설정에서도 상한이 실제로
|
|
# 작동한다.
|
|
type: data_size
|
|
default: 100MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_ZERO_COPY_ENABLED
|
|
# 바이트를 복사하는 곳만 바꾼다. 헤더나 상태 코드는 바꾸지 않는다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_ZERO_COPY_MINIMUM_BYTES
|
|
# 이보다 작으면 syscall 준비 비용이 아끼는 것보다 크다.
|
|
type: data_size
|
|
default: 16MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TRANSFER_CORE_SIZE
|
|
# 크기가 정해진 전송 pool. 거절은 다시 시도할 수 있는 429가 되고, 호출자 스레드에서 돌리지 않는다.
|
|
type: integer
|
|
default: 8
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer_at_most_max_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TRANSFER_MAX_SIZE
|
|
# 전송 pool의 상한.
|
|
type: integer
|
|
default: 32
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TRANSFER_QUEUE_CAPACITY
|
|
# 크기가 정해진 queue. 무한 queue는 빠른 429를 결국 heap 고갈로 바꾼다.
|
|
type: integer
|
|
default: 64
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TRANSFER_AWAIT_SECONDS
|
|
# 종료 때 남은 일 정리 시간과 전송마다 호출자가 기다리는 시간.
|
|
type: integer
|
|
default: 300
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_SECURITY_ACCESS_POLICY
|
|
# 허용하는 기본값이 없다. `required`는 배포가 FileAccessPolicyPort bean을 주지 않으면 기동을
|
|
# 실패시킨다. `unenforced`는 production profile에서 거부한다.
|
|
type: string
|
|
default: required
|
|
allowed_values: [required, role-based, unenforced]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: enum_in_allowed_values
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_SECURITY_READ_ROLES
|
|
# role 기반 정책에서 읽기 연산에 받는 role.
|
|
type: csv_list
|
|
default: ROLE_FILE_READ
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_role_list
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_SECURITY_WRITE_ROLES
|
|
# role 기반 정책에서 쓰기 연산에 받는 role.
|
|
type: csv_list
|
|
default: ROLE_FILE_WRITE
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_role_list
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_SECURITY_ADMIN_ROLES
|
|
# 관리 기능(management plane)에 받는 role. admin route는 application 정책만이 아니라 servlet chain에서도
|
|
# 이 role을 요구한다.
|
|
type: csv_list
|
|
default: ROLE_FILE_ADMIN
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_role_list
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_VERIFICATION_TIMEOUT
|
|
# 업로드 하나의 검증 사슬 전체 예산.
|
|
type: duration
|
|
default: 5s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_VERIFICATION_REQUIRE_MEDIA_TYPE_VERDICT
|
|
# true면 형식을 알아내지 못한 파일을 공개하지 않고 거부한다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_VERIFICATION_INLINE_SAFE_PROFILE
|
|
# true면 script가 돌 수 있는 내용을 격리하지 않고 받는다. 다운로드를 신뢰하는 origin에서 inline으로
|
|
# 절대 내주지 않을 때만 안전하다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_INSTANCE_UPLOAD_PERMITS
|
|
# 인스턴스마다 받는 동시 업로드 수.
|
|
type: integer
|
|
default: 16
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_SCOPE_UPLOAD_PERMITS
|
|
# 호출자(principal)마다 받는 동시 업로드 수.
|
|
type: integer
|
|
default: 4
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer_at_most_instance_permits
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_DIRECT_DOWNLOAD_PERMITS
|
|
# 인스턴스마다 받는 동시 직접 다운로드 수.
|
|
type: integer
|
|
default: 64
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_SOFT_HIGH_WATER
|
|
# 새 업로드를 덜어내기 시작하는 저장소 사용 비율.
|
|
type: string
|
|
default: 0.70
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: fraction_below_hard_high_water
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_HARD_HIGH_WATER
|
|
# 모든 업로드를 거부하는 저장소 사용 비율.
|
|
type: string
|
|
default: 0.85
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: fraction_within_zero_and_one
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_QUOTA_NAMESPACE_LIMIT
|
|
# namespace 하나가 가질 수 있는 최대 바이트(살아 있는 예약과 확정된 사용량의 합). 비면 무제한이다. 정한
|
|
# 상한을 넘는 예약은 QUOTA_EXCEEDED(413)로 거부한다.
|
|
type: data_size
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size_when_set
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_ADMIN_ENABLED
|
|
# 관리 기능(management plane). 데이터 기능과 따로 정한다. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다:
|
|
# 이 값만 켜면 이제 bean 그래프를 반쯤 만들지 않고 아무 일도 하지 않는다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_ADMIN_ORPHAN_MINIMUM_AGE
|
|
# 참조가 없는 객체가 scan에 이름이 오르기까지 있어야 하는 기간. 그보다 어린 것은 버려진 것이 아니라
|
|
# 확정하는 중이라고 본다.
|
|
type: duration
|
|
default: 1h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_CLEANUP_ENABLED
|
|
# 뒤에서 도는 회수. 기본으로 켜져 있다: 없으면 취소·만료된 staging과 거부·삭제된 내용이 volume에 남아,
|
|
# 결국 높은 수위(high-water mark)가 업로드를 막는다. 끄면 기동 때 경고를 남긴다(다른 노드나 관리 기능이
|
|
# 대신 회수해야 한다).
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_CLEANUP_INTERVAL
|
|
# batch 사이의 고정 지연. 일정의 유일한 주인이다. 두 번째 기본값을 가진 @Scheduled 자리표시자를 두지
|
|
# 않는다.
|
|
type: duration
|
|
default: 60s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_CLEANUP_MAX_ITEMS
|
|
# batch 하나의 항목 수 상한. 밀린 일이 scheduler를 독차지하지 못하게 한다.
|
|
type: integer
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_CLEANUP_MAX_BYTES
|
|
# batch 하나의 바이트 상한.
|
|
type: data_size
|
|
default: 1GB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_CLEANUP_RETRY_BACKOFF
|
|
# 실패한 정리 항목을 다시 시도하기 전 지연.
|
|
type: duration
|
|
default: 5m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_TUS_ENABLED
|
|
# tus 1.0. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_HTTPBIS_DRAFT12_ENABLED
|
|
# 승인되지 않은 초안이라 계약이 예고 없이 바뀔 수 있다. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_NGINX_ENABLED
|
|
# 앞단 proxy에 맡기기. 기동할 때 내부 매핑을 실제로 써 보고 확인한다. proxy가 풀지 못하는 매핑은 빈
|
|
# 본문으로 200을 답하므로, 그대로 두지 않고 실패시킨다(fail closed).
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_NGINX_INTERNAL_PREFIX
|
|
# proxy가 저장소 root로 풀어 주는 내부 위치.
|
|
type: string
|
|
default: /__files/
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: internal_uri_prefix
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_NGINX_OBJECT_SUFFIX
|
|
# 내부 URI에서 shard로 나눈 객체 key 뒤에 붙이는 접미사.
|
|
type: string
|
|
default: .bin
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_NGINX_MINIMUM_SIZE
|
|
# 이보다 작은 요청은 맡기지 않고 애플리케이션이 직접 내준다.
|
|
type: data_size
|
|
default: 16MB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_OBSERVABILITY_METRICS_ENABLED
|
|
# false면 metrics port도 fingerprint도 만들지 않고 key도 요구하지 않는다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
- name: APP_FILESERVER_PLATFORM_OBSERVABILITY_FINGERPRINT_KEY
|
|
# 파일 식별자에 거는 key 있는 HMAC. 셀 수 있는 식별자의 key 없는 digest는 되돌릴 수 있으므로, metrics가
|
|
# 켜졌는데 이 값이 비면 기동이 실패한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: fileserver-http-platform-activation-boundary
|
|
validation: non_empty_when_metrics_enabled
|
|
compatibility_impact: additive
|
|
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
|
|
|
|
# === 파일 / 업로드 (feature-file-resource-handling-contract) ===
|
|
|
|
- name: APP_ASYNC_EXECUTOR_CORE_SIZE
|
|
# source: feature-background-job-async-contract 2026-05-22
|
|
# "executor pool sizing default = core=10, max=50, queue=200"
|
|
type: int
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-background-job-async-contract
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: async-contract:executor-core-size
|
|
|
|
- name: APP_ASYNC_EXECUTOR_MAX_SIZE
|
|
# source: feature-background-job-async-contract 2026-05-22
|
|
# "core=10, max=50, queue=200"
|
|
type: int
|
|
default: 50
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-background-job-async-contract
|
|
validation: positive_int_ge_core
|
|
compatibility_impact: behavior-change
|
|
required_test: async-contract:executor-max-size
|
|
|
|
- name: APP_ASYNC_EXECUTOR_QUEUE_CAPACITY
|
|
# source: feature-background-job-async-contract 2026-05-22
|
|
# "queue=200" + "unbounded queue forbidden"
|
|
type: int
|
|
default: 200
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-background-job-async-contract
|
|
validation: positive_int_bounded
|
|
compatibility_impact: behavior-change
|
|
required_test: async-contract:executor-queue-bounded
|
|
|
|
# === 알림 전달 플랫폼 (NTF-025 — 설정 표면) ===
|
|
# application.yml에 app.notification.platform 트리가 있고 기본으로 꺼져 있다. 모든 키가 같은 줄에 기본값을
|
|
# 가지므로, 플랫폼을 끈 배포는 아무것도 주지 않아도 된다. 참고: docs/notification/configuration-reference.md.
|
|
|
|
- name: APP_PERSISTENCE_JPA_ENABLED
|
|
# source: five-adapter-runtime-remediation §5.1 — 관계형 영속성 스위치. persistence-jpa 모듈이 직접
|
|
# 가진다(config/module-defaults/persistence-jpa.yml). 모듈은 빌드 한 줄로 고르고, 있는 동안 켜진다. false면
|
|
# 이 모듈의 bean(entity scan, repository, store, 기동 관문)을 끈다. 빌드 줄을 지우면 기능과 이 키를 읽는 유일한
|
|
# 곳이 함께 사라진다. 옛 app.jpa-platform.enabled는 이 키처럼 읽혔지만 부가 bean 셋만 막았다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:persistence-jpa-disabled-safe
|
|
- name: APP_JPA_HIBERNATE_BATCH_SIZE
|
|
property: spring.jpa.properties.hibernate.jdbc.batch_size
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: integer
|
|
default: 50
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_ORDER_INSERTS
|
|
property: spring.jpa.properties.hibernate.order_inserts
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_ORDER_UPDATES
|
|
property: spring.jpa.properties.hibernate.order_updates
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_DEFAULT_BATCH_FETCH_SIZE
|
|
property: spring.jpa.properties.hibernate.default_batch_fetch_size
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: integer
|
|
default: 0
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: non_negative_integer
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_GENERATE_STATISTICS
|
|
property: spring.jpa.properties.hibernate.generate_statistics
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_PERSISTENCE_MONGO_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
|
|
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# source: five-adapter-runtime-remediation §5.1 — MongoDB 영속성 켜고 끄기.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:persistence-mongo-disabled-safe
|
|
- name: APP_PERSISTENCE_MONGO_ACTIVE_PROFILE
|
|
# source: five-adapter-runtime-remediation §5.1 — Mongo profile을 정확히 하나 고른다. 런타임은 sync client
|
|
# 하나와 pool 하나를 만든다. map에 있지만 고르지 않은 profile은 비밀을 풀지도, client를 만들지도 않는다.
|
|
type: string
|
|
default: ""
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_MONGO_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: nonblank-when-required
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:persistence-mongo-active-profile
|
|
- name: SPRING_MONGODB_URI
|
|
# source: persistence-mongo techlead review C1. Spring Boot 4는 이 자체 키를 spring.mongodb.uri로 쓴다.
|
|
# 유효한 연결 출처 둘 중 하나다. 다른 하나는 고른 typed profile의 uri-secret을 MongoCredentialResolver로 푼
|
|
# 값이다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
required_when: app.persistence-mongo.enabled=true이고 활성 profile의 uri-secret이 없을 때
|
|
reload_policy: restart-only
|
|
owner_branch: persistence-mongo-runtime-remediation
|
|
validation: mongodb_uri_when_selected_as_connection_source
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:persistence-mongo-connection-source
|
|
|
|
- name: APP_MESSAGING_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
|
|
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# source: five-adapter-runtime-remediation §5.1 — broker 발행 켜고 끄기.
|
|
# APP_MESSAGING_BROKER는 어느 transport인지만 고르고, 이제 사실상의 스위치가 아니다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:messaging-disabled-safe
|
|
# === 선택형 WebSocket 빌드 조립 계약 ===
|
|
# 고른 조립에 websocket leaf가 있으면 이 키들이 app.websocket.*로 바로 이어진다. 기본 bootJar에는 그 leaf가
|
|
# 없다. 있을지는 빌드할 때 정하고, 이 행들이 런타임에 들어 있다는 뜻은 아니다.
|
|
|
|
- name: APP_WEBSOCKET_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를
|
|
# 기본 true로 잇는다). false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이
|
|
# 보통의 꺼진 상태다.
|
|
property: app.websocket.enabled
|
|
owner_module: adapter-inbound-websocket
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-realtime-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_ENDPOINT
|
|
property: app.websocket.endpoint
|
|
owner_module: adapter-inbound-websocket
|
|
type: string
|
|
default: /ws
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-realtime-review-remediation
|
|
validation: absolute_normalized_path
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_ALLOWED_ORIGINS
|
|
property: app.websocket.allowed-origins
|
|
owner_module: adapter-inbound-websocket
|
|
type: csv
|
|
default: http://localhost:3000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-realtime-review-remediation
|
|
validation: explicit_http_origins
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_BROADCAST_DESTINATION
|
|
property: app.websocket.broadcast-destination
|
|
owner_module: adapter-inbound-websocket
|
|
type: string
|
|
default: /topic/events
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-realtime-review-remediation
|
|
validation: normalized_topic_path
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_CHANNEL_QUEUE_CAPACITY
|
|
property: app.websocket.channel-queue-capacity
|
|
owner_module: adapter-inbound-websocket
|
|
type: integer
|
|
default: 10000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: refactor/review-followup
|
|
validation: positive_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_MESSAGE_SIZE_LIMIT
|
|
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 bytes.
|
|
property: app.websocket.message-size-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: data_size
|
|
default: 64KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_SEND_BUFFER_SIZE_LIMIT
|
|
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 bytes.
|
|
property: app.websocket.send-buffer-size-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: data_size
|
|
default: 512KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_SEND_TIME_LIMIT
|
|
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 ms.
|
|
property: app.websocket.send-time-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: duration
|
|
default: 10s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_TIME_TO_FIRST_MESSAGE
|
|
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 ms.
|
|
property: app.websocket.time-to-first-message
|
|
owner_module: adapter-inbound-websocket
|
|
type: duration
|
|
default: 60s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_MAX_CONNECTIONS
|
|
# 노드마다의 새 STOMP session 상한(review 03-06). 그 다음 session은 1013으로 닫는다. 1000 x 512KB 송신
|
|
# 버퍼라 최악의 송신 버퍼링이 512 MiB 근처로 묶인다.
|
|
property: app.websocket.max-connections
|
|
owner_module: adapter-inbound-websocket
|
|
type: integer
|
|
default: 1000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_OBJECTSTORAGE_ENABLED
|
|
# 2026-11-03 RR-06-07: Compose smoke wrapper가 객체 저장소와 상관없는 모든 lane에 거는 명시적 끄기 값.
|
|
# relaxed binding으로 바인딩되면서 어느 레지스트리에도 없어, env 계약이 읽히지 않는 이름과 구별하지 못했다.
|
|
# 모듈은 있으면 켜진다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
property: app.object-storage.enabled
|
|
owner_module: adapter-outbound-objectstorage
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: refactor/maturity-review-2026-11
|
|
validation: boolean
|
|
compatibility_impact: none
|
|
required_test: off-state-zero-side-effects-and-env-round-trip
|
|
- name: APP_GRPC_SERVER_ENABLED
|
|
# 2026-11-03 RR-06-07: Compose lane이 거는 gRPC 서버의 명시적 끄기 값(아무도 읽지 않던
|
|
# CASKELETON_GRPC_ENABLED를 대신했다). 모듈은 있으면 켜진다. 빌드에 모듈이 없는 것이 보통의 꺼진
|
|
# 상태다.
|
|
property: app.grpc.server.enabled
|
|
owner_module: adapter-inbound-grpc
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: refactor/maturity-review-2026-11
|
|
validation: boolean
|
|
compatibility_impact: none
|
|
required_test: off-state-zero-side-effects-and-env-round-trip
|
|
- name: APP_GRAPHQL_ENABLED
|
|
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
|
|
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# source: five-adapter-runtime-remediation §5.1 — GraphQL transport 켜고 끄기.
|
|
# false면 /graphql route를 내지 않는다. Spring GraphQL이 스스로 내는 route도 포함이다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:graphql-disabled-safe
|
|
- name: APP_GRAPHQL_DEPLOYMENT_MODE
|
|
# source: five-adapter-runtime-remediation §5.1 / GQL-INT-002 — app.graphql.production과
|
|
# app.graphql.environment를 대신한다. 둘의 기본값이 production=false와 environment=PRODUCTION_PUBLIC이라,
|
|
# 익명 principal과 기본 허용 권한 검사는 한 축을 읽고 다른 축은 production이라 주장했다.
|
|
type: enum
|
|
default: ""
|
|
allowed_values: [LOCAL, DEV, PRODUCTION_INTERNAL, PRODUCTION_PUBLIC]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: enum
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:graphql-deployment-mode
|
|
- name: APP_GRAPHQL_VALIDATION_POLICY_VERSION
|
|
property: app.graphql.validation-policy-version
|
|
owner_module: adapter-inbound-graphql
|
|
type: string
|
|
default: v1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_OBSERVED_OPERATION_NAMES
|
|
property: app.graphql.observed-operation-names
|
|
owner_module: adapter-inbound-graphql
|
|
type: csv
|
|
default: ""
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: csv
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_GRAPHIQL_ENABLED
|
|
property: app.graphql.console.graphiql-enabled
|
|
owner_module: adapter-inbound-graphql
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_INTROSPECTION_ENABLED
|
|
property: app.graphql.console.introspection-enabled
|
|
owner_module: adapter-inbound-graphql
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_MAXIMUM_PAGE_SIZE
|
|
property: app.graphql.limits.maximum-page-size
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_MAXIMUM_COMPLEXITY
|
|
property: app.graphql.limits.maximum-complexity
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_ENTRIES
|
|
property: app.graphql.limits.preparsed-cache-entries
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 1000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_WEIGHT
|
|
property: app.graphql.limits.preparsed-cache-weight
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10000000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS
|
|
property: app.graphql.limits.preparsed-cache-expire-after-access
|
|
owner_module: adapter-inbound-graphql
|
|
type: duration
|
|
default: 30m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PER_PARENT_FETCH_WARNING_THRESHOLD
|
|
property: app.graphql.limits.per-parent-fetch-warning-threshold
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_OUTBOX_ENABLED
|
|
# source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — outbox 기능 스위치.
|
|
# 아래 relay-enabled는 scheduler만 시작한다. 둘을 섞으면 relay를 끈 배포도 DB 없는 런타임에는 없는 store
|
|
# port 위에 outbox metrics를 조립했다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:outbox-capability-disabled-safe
|
|
- name: APP_OUTBOX_RELAY_ENABLED
|
|
# source: five-adapter-runtime-remediation §6.3 MSG-INT-001 — relay scheduler를 시작한다.
|
|
# APP_OUTBOX_ENABLED, APP_PERSISTENCE_JPA_ENABLED, APP_MESSAGING_ENABLED와 APP_MESSAGING_PRODUCER_ID가
|
|
# 필요하다. 예전 기본값은 broker가 빈 채로 true라 모든 기동을 거부했다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-five-adapter-activation
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:outbox-relay-dependency
|
|
- name: APP_NOTIFICATION_PLATFORM_ENABLED
|
|
# 2026-09-25 capability 포장: notification-platform 모듈은 있으면 켜진다(모듈의
|
|
# config/module-defaults/notification.yml이 이 키를 기본 true로 잇는다). false가 명시적으로 끄는 값이고
|
|
# 아무것도 바인딩하지 않는다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
|
|
# source: NTF-025.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-platform-disabled-safe
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_DEFAULT_LOCALE
|
|
# I-6b: locale을 적지 않은 제출을 그릴 locale. 접수 use case가 적용한다. 예전에는 HTTP controller가 host
|
|
# JVM의 Locale.getDefault()를 골라, 같은 요청이 노드마다 다르게 그려졌다.
|
|
type: string
|
|
default: ko-KR
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: none
|
|
compatibility_impact: behavior-change
|
|
required_test: application-contract:notification-default-locale
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY
|
|
# source: NTF-INT-007 — 저장된 수신자 연락처(주소와 전화번호)를 암호화한다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.contact-encryption-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY
|
|
# source: NTF-INT-007 — 연락처의 blind index. 조회에 평문이 필요 없게 한다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.contact-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY
|
|
# source: NTF-INT-007 — provider가 전달 결과를 보내는 callback URL에 서명한다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.callback-signing-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY
|
|
# source: NTF-INT-007 — 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.provider-credential-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY
|
|
# source: NTF-INT-007 — 저장된 알림 변수와 보관한 callback 본문을 암호화한다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.payload-encryption-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY
|
|
# source: NTF-INT-007 — provider 쪽 식별자인 provider request id의 key 있는 hash.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.provider-request-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY
|
|
# source: NTF-INT-007 — callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다.
|
|
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
|
|
# app.notification.platform.secrets.callback-fingerprint-hmac-key. 플랫폼이 기동할 때 값을 풀고,
|
|
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: base64_at_least_32_bytes_and_distinct_per_purpose
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY_ID
|
|
# source: NTF-INT-007 — CONTACT_ENCRYPTION key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.CONTACT_ENCRYPTION.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — CONTACT_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.CONTACT_LOOKUP_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY_ID
|
|
# source: NTF-INT-007 — CALLBACK_SIGNING key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.CALLBACK_SIGNING.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY_ID
|
|
# source: NTF-INT-007 — PROVIDER_CREDENTIAL key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.PROVIDER_CREDENTIAL.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY_ID
|
|
# source: NTF-INT-007 — PAYLOAD_ENCRYPTION key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.PAYLOAD_ENCRYPTION.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — PROVIDER_REQUEST_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.PROVIDER_REQUEST_LOOKUP_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — CALLBACK_FINGERPRINT_HMAC key가 만드는 모든 envelope에 적는 id.
|
|
# key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의
|
|
# APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY 행이다. 바인딩 위치:
|
|
# app.notification.platform.secrets.active-key-ids.CALLBACK_FINGERPRINT_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ENABLED
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: boolean
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_PRIMARY
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: boolean
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ENVIRONMENT
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: PRODUCTION
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: non_blank
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: non_blank_when_ses_enabled
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_TIMEOUT
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: duration
|
|
default: 10s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_MAX_CONCURRENCY
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: int
|
|
default: 8
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_int
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_RATE_PER_SECOND
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: int
|
|
default: 20
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_int
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ENDPOINT
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: https://email.us-east-1.amazonaws.com
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: absolute_https_or_loopback_uri
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_REGION
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: us-east-1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: non_blank
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: email_address_when_ses_enabled
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: non_blank_when_ses_enabled
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_CONFIGURATION_SET
|
|
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: optional_non_blank
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-ses-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS
|
|
# source: 2026-09-24 module review Critical #10 — 기본 SES profile이 받는 SES 이벤트 callback의 SNS topic.
|
|
# SNS 서명이 맞다는 것은 AWS가 보냈다는 것만 증명하고, topic은 누구나 가질 수 있다. 그래서 callback을 켰는데
|
|
# 이 값이 비면 바인딩이 실패한다.
|
|
type: csv
|
|
default: ""
|
|
allowed_values: null
|
|
classification: security-relevant
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-24-notification-critical-remediation
|
|
validation: non_empty_when_ses_and_callbacks_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-ses-callback-topic-allowlist
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED
|
|
# source: NTF-INT-001 — 기본 SMTP provider profile 켜고 끄기. false면 조립에서 통째로 뺀다.
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY
|
|
# source: NTF-INT-001 — 이 profile이 EMAIL의 주 경로인지. 채널마다 주 경로는 정확히 하나다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_ENVIRONMENT
|
|
# source: NTF-INT-001 — profile이 밝힌 환경. 모든 발송 기록에 실린다.
|
|
type: string
|
|
default: local
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_CREDENTIAL_PROFILE
|
|
# source: NTF-INT-001 — relay 자격 증명을 푸는 credential profile.
|
|
type: string
|
|
default: default
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT
|
|
# source: NTF-INT-001 — 이 profile의 시도마다 provider timeout.
|
|
type: duration
|
|
default: 10s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: duration_spring_shorthand
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_MAX_CONCURRENCY
|
|
# source: NTF-INT-001 — 이 profile이 동시에 처리할 수 있는 시도 수.
|
|
type: int
|
|
default: 4
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_RATE_PER_SECOND
|
|
# source: NTF-INT-001 — profile의 시도 속도 제한.
|
|
type: int
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY
|
|
# source: NTF-INT-001 — 모든 메시지를 보내는 envelope 발신자.
|
|
type: string
|
|
default: no-reply@example.invalid
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: email_address
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY
|
|
# source: NTF-INT-001 — SMTP 발송이 도는, 크기가 정해진 executor의 크기.
|
|
type: int
|
|
default: 4
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_int
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-smtp-provider-assembled
|
|
|
|
- name: SPRING_MAIL_HOST
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.host
|
|
owner_module: adapter-outbound-notification
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: non_blank_when_required
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PORT
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.port
|
|
owner_module: adapter-outbound-notification
|
|
type: integer
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: integer_1_to_65535_when_required
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_USERNAME
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.username
|
|
owner_module: adapter-outbound-notification
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: sensitive-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: optional_non_blank
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PASSWORD
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.password
|
|
owner_module: adapter-outbound-notification
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: secret
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: secret_when_configured
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.properties.mail.smtp.starttls.enable
|
|
owner_module: adapter-outbound-notification
|
|
type: boolean
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: true_when_smtp_enabled_unless_implicit_tls
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.properties.mail.smtp.starttls.required
|
|
owner_module: adapter-outbound-notification
|
|
type: boolean
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: true_when_starttls_enabled
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_CONNECTIONTIMEOUT
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.properties.mail.smtp.connectiontimeout
|
|
owner_module: adapter-outbound-notification
|
|
type: integer
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_millis_when_required
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_TIMEOUT
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.properties.mail.smtp.timeout
|
|
owner_module: adapter-outbound-notification
|
|
type: integer
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_millis_when_required
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_WRITETIMEOUT
|
|
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
|
|
# 검증하고 쓰는 JavaMailSender가 읽는다.
|
|
property: spring.mail.properties.mail.smtp.writetimeout
|
|
owner_module: adapter-outbound-notification
|
|
type: integer
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-21-notification-review-remediation
|
|
validation: positive_millis_when_required
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:notification-smtp-transport
|
|
|
|
- name: APP_OPENAPI_DOCS_ENABLED
|
|
# source: five-adapter-runtime-remediation §9 — /v3/api-docs를 내줄지. application-prod.yml이 false로
|
|
# 고정한다. 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는
|
|
# 경고는 아무도 읽지 않는다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: main
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:openapi-exposure-decided
|
|
|
|
- name: APP_OPENAPI_UI_ENABLED
|
|
# source: five-adapter-runtime-remediation §9 — Swagger UI를 내줄지. application-prod.yml이 false로 고정한다.
|
|
# 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는 경고는
|
|
# 아무도 읽지 않는다.
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: main
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: env-contract:openapi-exposure-decided
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MODE
|
|
# source: NTF-025 — SERVING은 동작하는 provider 없이 기동을 거부한다. INGEST_ONLY는 저장만 하고 보내지 않는다.
|
|
# 상수는 INGEST_ONLY다. 이 행은 ACCEPT_ONLY라 했는데, NotificationPlatformMode에 그런 이름은 없었다. 그래서
|
|
# 레지스트리를 따른 운영자는 문서에 없는 값을 지목하는 바인딩 실패를 받았다. NotificationModeSsotTest가 아래
|
|
# 목록을 enum에서 만든다.
|
|
type: enum
|
|
default: SERVING
|
|
allowed_values: [SERVING, INGEST_ONLY]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: enum_of_notification_platform_mode
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-platform-mode
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CLAIM_BATCH_SIZE
|
|
# source: NTF-025 — scheduler 한 번이 claim하는 수신자 전달 수. 1..1000이고 밖이면 바인딩에서 거부한다
|
|
type: integer
|
|
default: 50
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: integer_1_to_1000
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-dispatch-bounds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_LEASE_DURATION
|
|
# source: NTF-025 — provider 호출과 그 timeout보다 길어야 한다. 아니면 살아 있는 worker의 전달을 다른 worker가 claim한다
|
|
type: duration
|
|
default: 2m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-lease-fencing
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_POLL_INTERVAL
|
|
# source: NTF-025 — 지난 차례에 claim한 것이 없을 때 scheduler가 일을 다시 묻는 간격
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-dispatch-bounds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_CONCURRENCY
|
|
# source: NTF-025 — 프로세스 전체에서 처리 중인 provider 호출 수 상한
|
|
type: integer
|
|
default: 64
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-dispatch-bounds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_ADDITIONAL_ATTEMPTS
|
|
# source: NTF-025 — 첫 시도 뒤의 재시도 수. 0이면 한 번 시도하고 재시도하지 않는다
|
|
type: integer
|
|
default: 4
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-retry-policy
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_ESTIMATED_DISPATCH_DURATION
|
|
# source: NTF-025 — lease·재시도 계획에 쓰는 발송 지연 추정값
|
|
type: duration
|
|
default: 2s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-dispatch-bounds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_QUEUE_AGE
|
|
# source: NTF-025 — 이 시간이 지나면 queue의 전달은 늦게 보내지 않고 만료된다
|
|
type: duration
|
|
default: 24h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-expiry
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_ALLOW_AMBIGUOUS_FALLBACK
|
|
# source: NTF-025 — 결과를 읽지 못한 애매한 시도가 provider에 닿았다. 다른 경로로 넘기면 두 번 보낼 위험이 있다
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-ambiguity
|
|
|
|
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SHUTDOWN_GRACE
|
|
# source: NTF-025 — 프로세스 종료 때 worker 정리 시간의 상한
|
|
type: duration
|
|
default: 20s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-shutdown-grace
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_BACKLOG_DEPTH
|
|
# source: NTF-OBS-001 — 기한이 됐는데 claim되지 않은 전달의 readiness 기준
|
|
type: integer
|
|
default: 100000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_DUE_AGE
|
|
# source: NTF-OBS-001 — 기한이 된 가장 오래된 전달의 readiness 기준
|
|
type: duration
|
|
default: 10m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_STUCK_LEASES
|
|
# source: NTF-OBS-001 — 만료되거나 멈춘 전달 lease의 readiness 기준
|
|
type: integer
|
|
default: 50
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_PENDING_PROJECTIONS
|
|
# source: NTF-OBS-001 — 적용되지 않은 provider 이벤트 projection의 readiness 기준
|
|
type: integer
|
|
default: 50000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_FAILED_PROJECTIONS
|
|
# source: NTF-OBS-001 — 실패한 provider 이벤트 projection의 readiness 기준
|
|
type: integer
|
|
default: 1000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_PENDING_PROJECTION_AGE
|
|
# source: NTF-OBS-001 — 가장 오래 기다린 projection의 readiness 기준
|
|
type: duration
|
|
default: 15m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_RECONCILIATION_AGE
|
|
# source: NTF-OBS-001 — 가장 오래 풀리지 않은 대조(reconciliation)의 readiness 기준
|
|
type: duration
|
|
default: 30m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_negative_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-serving-thresholds
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED
|
|
# source: NTF-025 — 플랫폼이 provider callback endpoint를 내놓을지
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: boolean
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-callback-ingestion
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES
|
|
# source: NTF-025 — 상한 65251 = 암호문 칸 크기에서 가장 큰 envelope(version, key-id 길이, 255바이트 key id, AES-GCM nonce와 tag)를 뺀 값. 더 크면 바인딩에서 거부한다
|
|
type: integer
|
|
default: 65251
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: integer_1_to_65251
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-callback-body-bound
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW
|
|
# source: NTF-025 — callback 시각이 로컬 시각과 이만큼 넘게 다르면 replay로 본다
|
|
# review 05-20 — 1h는 SNS의 HTTP/S 재시도 기간 전체(최대 3,600 s)를 덮는다. 그 안의 replay는 ledger 중복이다
|
|
type: duration
|
|
default: 1h
|
|
allowed_values: null
|
|
classification: security-relevant
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: positive_duration
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-callback-replay
|