157 lines
6.4 KiB
YAML
157 lines
6.4 KiB
YAML
# 환경 공통 기본값과 배포 토폴로지. 환경별 차이는 values-{env}.yaml이 덮어쓴다.
|
|
#
|
|
# 이 Chart의 설계 원칙:
|
|
# 1. MCP 배포 하나는 Tool Service 하나만 본다(ADR-0007).
|
|
# bundle 목록은 항상 한 항목이며 template이 만든다.
|
|
# 2. 배포 대상 전체를 아래 deployments 한 곳에 적는다.
|
|
# 설치할 때 --set deploymentKey=<key>로 하나를 고른다.
|
|
# 배포가 10개든 20개든 파일 수가 늘지 않고, 전체 매핑을 한 화면에서 검토할 수 있다.
|
|
# 3. 환경 축(namespace·이미지·등급별 replica)과 배포 축(어느 Tool Service를 보는가)을 섞지 않는다.
|
|
# values-{env}.yaml에는 deployments가 없고, deployments에는 환경 정보가 없다.
|
|
# 4. identity는 "{배포 이름}-{global.env}"로 조립한다.
|
|
# Redis key namespace이므로 환경끼리 겹치면 서로 Tool snapshot을 덮어쓴다.
|
|
# 사람이 손으로 적지 않게 해 실수를 구조적으로 막는다.
|
|
# 5. 외부에서는 환경별 한 host 아래 publicPath로 구분한다. Route는 Service만 선택하고
|
|
# 컨테이너가 같은 path를 직접 처리하므로 Registry의 1:1 경계는 바뀌지 않는다(ADR-0009).
|
|
|
|
# 설치할 배포를 고르는 key. 반드시 --set으로 지정한다.
|
|
# 기본값을 두지 않는 이유는, 지정을 빠뜨렸을 때 엉뚱한 배포가 조용히 설치되는 것보다
|
|
# 렌더링 실패가 낫기 때문이다.
|
|
deploymentKey: ""
|
|
|
|
global:
|
|
# 배포 환경. identity 접미사와 NetworkPolicy 판단에 쓰인다.
|
|
env: dev
|
|
# Agent Builder가 있는 namespace. Route를 우회한 Pod 직접 호출을 이 namespace로 제한한다.
|
|
# MCP와 Tool Service는 같은 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
|
|
|
|
# 배포 대상 전체. 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에서 유일해야 한다
|
|
#
|
|
# 같은 업무의 두 등급이 같은 namePrefix를 공유하는 것은 의도된 구성이다(ADR-0007).
|
|
# 등급을 이름에 넣으면 Tool 재분류가 Tool name 변경이 되어 Agent Builder 재등록을 부른다.
|
|
# 그 안에서 Tool 이름이 겹치지 않게 하는 것은 Tool Service 책임이다.
|
|
#
|
|
# 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
|
|
|
|
# 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·클러스터 장애는 분할로 막히지 않는다(ADR-0007).
|
|
tiers:
|
|
critical:
|
|
replicas: 2
|
|
# 배포·노드 drain 중에도 최소 1개를 남긴다.
|
|
podDisruptionBudget: true
|
|
# replica를 서로 다른 노드에 두려고 시도한다. 노드가 부족하면 그대로 배치한다.
|
|
spreadAcrossNodes: true
|
|
standard:
|
|
replicas: 1
|
|
podDisruptionBudget: false
|
|
spreadAcrossNodes: false
|
|
|
|
image:
|
|
# TODO: 사내 컨테이너 registry 경로 확정 시 교체한다.
|
|
repository: image-registry.openshift-image-registry.svc:5000/ax-hub/ax-hub-mcp-server
|
|
tag: "0.1.0"
|
|
pullPolicy: IfNotPresent
|
|
|
|
mcp:
|
|
# 요청 시점에 Tool Service 매니페스트를 다시 확인할 TTL(초).
|
|
# 요청이 없는 동안에는 Tool Service를 호출하지 않는다.
|
|
refreshTtlSeconds: 300
|
|
|
|
toolService:
|
|
# MCP와 같은 namespace에 있으므로 서비스 이름 + 아래 값으로 주소가 완성된다.
|
|
port: 8080
|
|
manifestPath: /tool-manifest
|
|
basePath: /mcp
|
|
|
|
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
|