# 환경 공통 기본값과 배포 토폴로지. 환경별 차이는 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=로 덮어쓴다. 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