설계: docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md
계획/진행 기록: docs/superpowers/plans/2026-09-25-capability-module-packaging.md
- Wave 0: 규칙 고정(AGENTS.md capability 완료 기준·테스트 규칙) + 차단 결함 7건
(compose overlay 검사, redis-sdk CI job, 적용된 V9/V13 원복 + V16, @EnableScheduling,
messaging bridge 순서, prod 에러 상세 validator, sample loggers read-only)
- Wave 1: 데이터·보안 Critical 10건 (durable operation 25P02, operation 유스케이스 이동,
outbox 재인코딩, Kafka TLS/SASL, 알림 트랜잭션, SNS 서명, tus checksum, GraphQL fragment,
Redis lane, gRPC FAILED_TERMINAL)
- Wave 2: 리팩터링 잔재·실험용 자리 삭제, outbox v1 fencing(V17), 멱등성 V2 정본화
- Wave 3: 라이브러리형 코드 정리(동작하지 않는 설정·인터페이스·gate 제거, web-advanced 분리)
- Wave 4: capability 11개를 "있으면 켜짐" 모듈로 포장, 끄는 장치 제거, 기본 조립 web-only,
qualificationBootJar 분리
- Wave 5: 빌드 로직 축소(17.2k -> 10.8k줄), sample 테스트 컨벤션 적용
삭제한 코드는 docs/capability-status.md "제거된 코드" 표에 복구 커밋(208077fd)과 함께 기록.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
203 lines
9.6 KiB
YAML
203 lines
9.6 KiB
YAML
# Redis SDK topology evidence.
|
|
#
|
|
# The lanes in infra/redis-sdk answer what the deterministic in-memory gateway cannot — Sentinel
|
|
# promotion behaviour, Cluster redirects, ACL coverage. docs/redis/support-matrix.md records which
|
|
# lane produced which evidence, and RedisSupportMatrixTest refuses an evidence claim that does not
|
|
# name the test class behind it.
|
|
#
|
|
# Three cadences, because the cost and the question differ:
|
|
#
|
|
# pull_request standalone only, current supported version. The cheapest lane that can still
|
|
# catch "this change cannot talk to a real Redis at all". A PR gate that starts
|
|
# three topologies is a PR gate people learn to ignore.
|
|
# schedule the full supported-version x topology matrix, nightly. This is where Sentinel
|
|
# promotion and Cluster redirect evidence comes from.
|
|
# workflow_dispatch one lane on demand, for reproducing a specific failure.
|
|
#
|
|
# A release candidate uses the nightly matrix run for its tag: `release-candidate` selects the full
|
|
# matrix on demand so an RC does not have to wait for the next scheduled run.
|
|
#
|
|
# Each lane has its own endpoint. A sentinel is not a data node and a cluster node is not the whole
|
|
# cluster, so the address, port, and (for Sentinel) the monitored primary's name are per-lane rather
|
|
# than one hardcoded 6379 that happens to be right for standalone only.
|
|
#
|
|
# The Gradle task is fail-closed on its own account: an unknown mode, a missing endpoint, a lane
|
|
# with no tagged test class, and a run that executed zero tests are all errors. This workflow does
|
|
# not need to re-check those, but it does have to keep the evidence, which is why every run uploads
|
|
# the JUnit XML together with the commit SHA, the server version and the resolved image digest. An
|
|
# evidence artifact that cannot say which image produced it is not evidence.
|
|
name: redis-sdk-topology
|
|
|
|
on:
|
|
pull_request:
|
|
paths:
|
|
- "src/adapter/outbound/redis-runtime/**"
|
|
- "src/adapter/outbound/redis-sdk/**"
|
|
- "src/adapter/outbound/cache-redis/**"
|
|
- "infra/redis-sdk/**"
|
|
- ".github/workflows/redis-sdk-topology.yml"
|
|
# Every Gradle job here installs its toolchain through this composite action, so a change to
|
|
# it changes what this gate runs.
|
|
- ".github/actions/setup-gradle-java/action.yml"
|
|
schedule:
|
|
# 02:30 UTC daily. Nightly, not hourly: the matrix starts real servers.
|
|
- cron: "30 2 * * *"
|
|
workflow_dispatch:
|
|
inputs:
|
|
topology:
|
|
description: standalone, sentinel, cluster, tls, or release-candidate for the full matrix
|
|
required: true
|
|
default: standalone
|
|
type: choice
|
|
options: [standalone, sentinel, cluster, tls, release-candidate]
|
|
redis_version:
|
|
description: server version tag
|
|
required: true
|
|
default: "7.4"
|
|
type: string
|
|
|
|
permissions:
|
|
contents: read
|
|
|
|
jobs:
|
|
# The matrix is computed rather than duplicated per trigger, so adding a supported version is one
|
|
# edit and no trigger can silently keep testing an old set.
|
|
lanes:
|
|
runs-on: ubuntu-latest
|
|
outputs:
|
|
matrix: ${{ steps.select.outputs.matrix }}
|
|
steps:
|
|
- id: select
|
|
run: |
|
|
set -euo pipefail
|
|
case "${{ github.event_name }}" in
|
|
pull_request)
|
|
matrix='{"include":[{"topology":"standalone","redis_version":"7.4"}]}'
|
|
;;
|
|
schedule)
|
|
matrix='{"include":[
|
|
{"topology":"standalone","redis_version":"7.2"},
|
|
{"topology":"standalone","redis_version":"7.4"},
|
|
{"topology":"standalone","redis_version":"8.2"},
|
|
{"topology":"sentinel","redis_version":"7.2"},
|
|
{"topology":"sentinel","redis_version":"7.4"},
|
|
{"topology":"sentinel","redis_version":"8.2"},
|
|
{"topology":"cluster","redis_version":"7.2"},
|
|
{"topology":"cluster","redis_version":"7.4"},
|
|
{"topology":"cluster","redis_version":"8.2"},
|
|
{"topology":"tls","redis_version":"7.4"},
|
|
{"topology":"tls","redis_version":"8.2"}]}'
|
|
;;
|
|
*)
|
|
if [ "${{ inputs.topology }}" = "release-candidate" ]; then
|
|
matrix='{"include":[
|
|
{"topology":"standalone","redis_version":"7.2"},
|
|
{"topology":"standalone","redis_version":"7.4"},
|
|
{"topology":"standalone","redis_version":"8.2"},
|
|
{"topology":"sentinel","redis_version":"7.2"},
|
|
{"topology":"sentinel","redis_version":"7.4"},
|
|
{"topology":"sentinel","redis_version":"8.2"},
|
|
{"topology":"cluster","redis_version":"7.2"},
|
|
{"topology":"cluster","redis_version":"7.4"},
|
|
{"topology":"cluster","redis_version":"8.2"},
|
|
{"topology":"tls","redis_version":"7.4"},
|
|
{"topology":"tls","redis_version":"8.2"}]}'
|
|
else
|
|
matrix='{"include":[{"topology":"${{ inputs.topology }}","redis_version":"${{ inputs.redis_version }}"}]}'
|
|
fi
|
|
;;
|
|
esac
|
|
printf 'matrix=%s\n' "$(printf '%s' "$matrix" | tr -d '\n ')" >> "$GITHUB_OUTPUT"
|
|
|
|
topology-evidence:
|
|
needs: lanes
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
strategy:
|
|
fail-fast: false
|
|
matrix: ${{ fromJson(needs.lanes.outputs.matrix) }}
|
|
steps:
|
|
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # actions/checkout@v4.2.2
|
|
- uses: ./.github/actions/setup-gradle-java
|
|
- name: Start the topology
|
|
env:
|
|
REDIS_VERSION: ${{ matrix.redis_version }}
|
|
run: docker compose -f "infra/redis-sdk/${{ matrix.topology }}/compose.yml" up -d --wait
|
|
- name: Record the image digest
|
|
id: image
|
|
run: |
|
|
set -euo pipefail
|
|
# The tag says 7.4; the digest says which 7.4. Evidence that names only the tag cannot be
|
|
# reproduced once the tag moves.
|
|
#
|
|
# This used to end in `|| echo 'unresolved'`, which absorbed the failure that `set -e` was
|
|
# there to catch: the manifest below recorded `image_digest=unresolved`, the upload
|
|
# satisfied `if-no-files-found: error`, and the lane went green holding exactly the
|
|
# artifact this workflow's header calls "not evidence". Compose pulls the image in the
|
|
# step before this one, so RepoDigests is populated; if it is not, the run has nothing to
|
|
# certify and says so.
|
|
digest="$(docker image inspect --format '{{index .RepoDigests 0}}' \
|
|
"redis:${{ matrix.redis_version }}")"
|
|
if [[ -z "$digest" ]]; then
|
|
echo "::error::no repository digest for redis:${{ matrix.redis_version }}; this run cannot say which image produced its evidence"
|
|
exit 1
|
|
fi
|
|
printf 'digest=%s\n' "$digest" >> "$GITHUB_OUTPUT"
|
|
- name: Run the topology contracts
|
|
working-directory: src
|
|
run: |
|
|
set -euo pipefail
|
|
# Each leaf declares the lanes its tests qualify; a mode a leaf does not declare fails
|
|
# closed, so each topology names exactly the leaves that have classes for it.
|
|
runtime=:adapter:outbound:redis-runtime:redisTopologyTest
|
|
sdk=:adapter:outbound:redis-sdk:redisTopologyTest
|
|
semantic=:adapter:outbound:cache-redis:redisTopologyTest
|
|
case '${{ matrix.topology }}' in
|
|
standalone) port=6379; extra=''; tasks="$runtime $sdk $semantic" ;;
|
|
sentinel) port=27010; extra='-Predis.topology.master=skeleton'; tasks="$runtime $sdk" ;;
|
|
cluster) port=7100; extra=''; tasks="$runtime $sdk $semantic" ;;
|
|
# The TLS lane's CA is generated at start-up, so the trust material is extracted from
|
|
# the lane rather than checked in. A checked-in key is a secret in the repository
|
|
# however loudly the file is named "test".
|
|
tls)
|
|
port=6390
|
|
docker compose -f ../infra/redis-sdk/tls/compose.yml cp redis:/tls/ca.crt "$RUNNER_TEMP/redis-lane-ca.pem"
|
|
extra="-Predis.topology.trust-material=$RUNNER_TEMP/redis-lane-ca.pem"
|
|
tasks="$runtime"
|
|
;;
|
|
*) echo "unknown topology"; exit 1 ;;
|
|
esac
|
|
./gradlew $tasks --continue --console=plain \
|
|
-Predis.topology.host=localhost \
|
|
-Predis.topology.port="$port" \
|
|
-Predis.topology.mode='${{ matrix.topology }}' \
|
|
$extra
|
|
- name: Write the evidence manifest
|
|
if: always()
|
|
run: |
|
|
set -euo pipefail
|
|
out=src/build/redis-topology-evidence
|
|
mkdir -p "$out"
|
|
cat > "$out/evidence-manifest.txt" <<MANIFEST
|
|
commit=${{ github.sha }}
|
|
workflow_run=${{ github.run_id }}
|
|
trigger=${{ github.event_name }}
|
|
topology=${{ matrix.topology }}
|
|
redis_version=${{ matrix.redis_version }}
|
|
image_digest=${{ steps.image.outputs.digest }}
|
|
MANIFEST
|
|
- name: Preserve the evidence
|
|
if: always()
|
|
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2
|
|
with:
|
|
name: redis-topology-${{ matrix.topology }}-${{ matrix.redis_version }}
|
|
path: |
|
|
src/build/redis-topology-evidence/**
|
|
src/adapter/outbound/*/build/test-results/redisTopologyTest/**
|
|
src/adapter/outbound/*/build/reports/tests/redisTopologyTest/**
|
|
if-no-files-found: error
|
|
retention-days: 90
|
|
- name: Stop the topology
|
|
if: always()
|
|
run: docker compose -f "infra/redis-sdk/${{ matrix.topology }}/compose.yml" down -v
|