koseokmin
4f60f4f01b
GitOps 저장소도 ArgoCD Application도 아직 없어, 그때까지 이 저장소가 push 방식 파이프라인(.gitea/workflows/)을 임시로 소유한다. 무엇을 포기하는지와 넘길 때 할 일은 deploy/README.md에 적었다. Chart는 portal과 bundles 두 배포 모델을 모두 렌더링한다. ADR-0013이 ADR-0007을 대체했으므로 운영은 portal이 기준이지만, bundles 경로를 언제 삭제할지는 아직 정하지 않았다. - .gitea/workflows/ci.yaml, deploy-openshift.yaml - deploy/ci/render-manifests.sh, deploy/examples/ - Chart: mode 분기, selectedDeployment/tier helper, imagePullSecrets, toolService.apiKeySecret 참조 - extension-points.md에 미결 항목 9~12 추가 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
192 lines
8.2 KiB
YAML
192 lines
8.2 KiB
YAML
# 환경 공통 기본값과 배포 토폴로지. 환경별 차이는 values-{env}.yaml이 덮어쓴다.
|
|
#
|
|
# 내부망 운영은 이 Chart를 사용하지 않는다(ADR-0013 결정 7). 아래 원칙과 deployments 목록은
|
|
# 배포 하나가 Tool Service 하나를 보는 mcp.bundles 구성(ADR-0007/0009)을 전제한다.
|
|
# Portal이 endpoint 원천인 구성에서는 배포 하나가 N개 route를 서비스하므로 이 토폴로지가 성립하지 않는다.
|
|
# 자세한 배경은 deploy/README.md 머리말에 있다.
|
|
#
|
|
# 이 Chart의 설계 원칙:
|
|
# 1. 배포 모델이 두 가지다. mode가 그 축을 고른다.
|
|
# portal — route↔Tool Service 매핑의 원천이 Portal이다(ADR-0013). 배포 하나가 N route를
|
|
# 서비스하고 route key는 /mcp/{routeKey} URI에서만 온다. 현재 애플리케이션 코드의 경로다.
|
|
# bundles — 배포 하나가 Tool Service 하나만 보고 매핑을 배포 시점에 못박는다(ADR-0007).
|
|
# ADR-0013이 대체했지만 코드 경로가 남아 있어 1:1 검증·격리 배포에 쓸 수 있다.
|
|
# 2. 환경 축(namespace·이미지·등급별 replica)과 배포 축(무엇을 보는가)을 섞지 않는다.
|
|
# values-{env}.yaml에는 deployments가 없고, deployments에는 환경 정보가 없다.
|
|
# 3. identity는 "{배포 이름}-{global.env}"로 조립한다.
|
|
# Redis key namespace이므로 환경끼리 겹치면 서로 Tool snapshot을 덮어쓴다.
|
|
# 사람이 손으로 적지 않게 해 실수를 구조적으로 막는다.
|
|
# 4. 공개 path는 Route와 컨테이너가 동일하게 사용하고 rewrite하지 않는다(ADR-0009).
|
|
|
|
# 배포 모델. portal | bundles
|
|
# 기본값을 portal로 둔 이유는 현재 애플리케이션이 실제로 도는 경로이기 때문이다.
|
|
mode: portal
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# mode=portal 축
|
|
# ---------------------------------------------------------------------------
|
|
portal:
|
|
# 이 환경에 설치되는 단일 MCP 배포. route가 늘어도 배포는 늘지 않는다.
|
|
deployment:
|
|
name: axhub-mcp
|
|
tier: critical
|
|
# route key는 이 path 아래 URI segment에서 온다. 여기에 routeKey를 적지 않는다.
|
|
publicPath: /mcp
|
|
# Portal registry 조회 주소. 환경마다 다르므로 values-{env}.yaml이 소유한다.
|
|
# 기본값을 두지 않는 이유는, 빠뜨린 설치가 조용히 성공하는 것보다 렌더링 실패가 낫기 때문이다.
|
|
registryUrl: ""
|
|
refreshIntervalSeconds: 300
|
|
# Portal 조회가 실패한 cold start에서만 읽는 Redis fallback key.
|
|
# 포털이 registry를 써 넣는 key와 반드시 같아야 한다.
|
|
registryRedisKey: axhub:mcp:portal-registry
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# mode=bundles 축
|
|
# ---------------------------------------------------------------------------
|
|
# 설치할 배포를 고르는 key. mode=bundles일 때 반드시 --set으로 지정한다.
|
|
# 기본값을 두지 않는 이유는, 지정을 빠뜨렸을 때 엉뚱한 배포가 조용히 설치되는 것보다
|
|
# 렌더링 실패가 낫기 때문이다.
|
|
deploymentKey: ""
|
|
|
|
# 배포 대상 전체. map의 key가 곧 bundle id가 된다.
|
|
#
|
|
# name Deployment/Service/ConfigMap/NetworkPolicy 이름. 같은 namespace에서 유일해야 한다
|
|
# service 이 MCP가 보는 Tool Service의 Kubernetes Service 이름. 주소는 template이 조립한다
|
|
# namePrefix 이 Tool Service가 쓰는 Tool 이름 접두사. 업무 단위이며 등급을 넣지 않는다
|
|
# tier 가용성 등급. 아래 tiers의 key여야 한다
|
|
# publicPath Agent Builder가 등록할 외부 MCP path. 전체 topology에서 유일해야 한다
|
|
#
|
|
# TODO: Tool 목록이 확정되면 실제 Tool Service 이름으로 교체하고, 없는 배포는 삭제한다.
|
|
deployments:
|
|
processing-critical:
|
|
name: processing-critical-mcp
|
|
service: processing-critical-tools
|
|
namePrefix: "processing."
|
|
tier: critical
|
|
publicPath: /mcp/processing-critical
|
|
processing-standard:
|
|
name: processing-standard-mcp
|
|
service: processing-standard-tools
|
|
namePrefix: "processing."
|
|
tier: standard
|
|
publicPath: /mcp/processing-standard
|
|
swring-critical:
|
|
name: swring-critical-mcp
|
|
service: swring-critical-tools
|
|
namePrefix: "swring."
|
|
tier: critical
|
|
publicPath: /mcp/swring-critical
|
|
swring-standard:
|
|
name: swring-standard-mcp
|
|
service: swring-standard-tools
|
|
namePrefix: "swring."
|
|
tier: standard
|
|
publicPath: /mcp/swring-standard
|
|
information-critical:
|
|
name: information-critical-mcp
|
|
service: information-critical-tools
|
|
namePrefix: "information."
|
|
tier: critical
|
|
publicPath: /mcp/information-critical
|
|
information-standard:
|
|
name: information-standard-mcp
|
|
service: information-standard-tools
|
|
namePrefix: "information."
|
|
tier: standard
|
|
publicPath: /mcp/information-standard
|
|
hr-critical:
|
|
name: hr-critical-mcp
|
|
service: hr-critical-tools
|
|
namePrefix: "hr."
|
|
tier: critical
|
|
publicPath: /mcp/hr-critical
|
|
hr-standard:
|
|
name: hr-standard-mcp
|
|
service: hr-standard-tools
|
|
namePrefix: "hr."
|
|
tier: standard
|
|
publicPath: /mcp/hr-standard
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# 모드 공통
|
|
# ---------------------------------------------------------------------------
|
|
global:
|
|
# 배포 환경. identity 접미사와 NetworkPolicy 판단에 쓰인다.
|
|
env: dev
|
|
# Agent Builder가 있는 namespace. Route를 우회한 Pod 직접 호출을 이 namespace로 제한한다.
|
|
# TODO: 실제 namespace 확정 시 교체한다.
|
|
agentBuilderNamespace: ax-hub-agentbuilder-dev
|
|
# Actuator management 포트에 접근할 관제 namespace.
|
|
monitoringNamespace: openshift-monitoring
|
|
# 환경별 공개 MCP host. 실제 OpenShift apps domain으로 교체한다.
|
|
mcpHost: mcp-dev.apps.example.internal
|
|
|
|
# OpenShift Router와 MCP 컨테이너가 같은 publicPath를 사용한다. rewrite하지 않는다.
|
|
route:
|
|
# Agent Builder 최대 대기 시간과 맞춘 공개 HTTP 연결 timeout이다.
|
|
timeout: 300s
|
|
# 문서용 TEST-NET이다. 실제 환경에서는 Agent Builder의 고정 egress CIDR로 교체한다.
|
|
sourceAllowlist: 192.0.2.0/24
|
|
|
|
# 등급별 가용성 기준. 환경별 values가 덮어쓴다.
|
|
#
|
|
# 다만 나누는 것만으로 가용성이 생기지는 않는다. 같은 노드 배치, namespace 쿼터,
|
|
# 공통 Redis·클러스터 장애는 분할로 막히지 않는다.
|
|
# portal 모드에서는 배포가 하나이므로 등급별 물리 분리가 성립하지 않는다(ADR-0013 전제 2).
|
|
tiers:
|
|
critical:
|
|
replicas: 2
|
|
# 배포·노드 drain 중에도 최소 1개를 남긴다.
|
|
podDisruptionBudget: true
|
|
# replica를 서로 다른 노드에 두려고 시도한다. 노드가 부족하면 그대로 배치한다.
|
|
spreadAcrossNodes: true
|
|
standard:
|
|
replicas: 1
|
|
podDisruptionBudget: false
|
|
spreadAcrossNodes: false
|
|
|
|
image:
|
|
# TODO: 사내 컨테이너 registry 경로 확정 시 교체한다.
|
|
# CI가 --set image.tag=<commit sha>로 덮어쓴다.
|
|
repository: image-registry.openshift-image-registry.svc:5000/ax-hub/ax-hub-mcp-server
|
|
tag: "0.1.0"
|
|
pullPolicy: IfNotPresent
|
|
# 사내 registry가 인증을 요구할 때만 채운다. 예: [{name: harbor-pull}]
|
|
pullSecrets: []
|
|
|
|
mcp:
|
|
# Tool Service 매니페스트 조회 주기(초).
|
|
refreshIntervalSeconds: 30
|
|
refreshJitterSeconds: 5
|
|
|
|
toolService:
|
|
# bundles 모드에서만 쓴다. MCP와 Tool Service가 같은 namespace라는 전제다.
|
|
port: 8080
|
|
manifestPath: /tool-manifest
|
|
basePath: /mcp
|
|
# Tool Service 호출용 API key를 담은 Secret. name이 비어 있으면 환경변수를 주입하지 않고
|
|
# 애플리케이션 기본값을 쓴다. 운영에서는 반드시 채운다.
|
|
apiKeySecret:
|
|
name: ""
|
|
key: tool-server-api-key
|
|
|
|
redis:
|
|
host: redis
|
|
port: 6379
|
|
|
|
ports:
|
|
http: 8080
|
|
management: 9090
|
|
|
|
resources:
|
|
requests:
|
|
cpu: 250m
|
|
memory: 512Mi
|
|
limits:
|
|
cpu: "1"
|
|
memory: 1Gi
|
|
|
|
# 진행 중인 tools/call은 Tool timeout 상한(30초) + 응답 쓰기만큼 걸릴 수 있다.
|
|
# Spring drain(40초)보다 길어야 drain이 끝나기 전에 Pod이 죽지 않는다.
|
|
terminationGracePeriodSeconds: 45
|