{{/* 설치 대상이 실제로 존재하는지 확인하고, 없으면 읽을 수 있는 메시지로 멈춘다. 검사를 하지 않으면 오타가 "nil pointer" 같은 내부 오류로 나타나 원인을 찾기 어렵다. 값을 반환하지 않으므로 각 template 파일의 첫 줄에서 한 번 부른다. */}} {{- define "mcp-server.validate" -}} {{- $key := required "deploymentKey를 지정해야 한다. 예: --set deploymentKey=processing-critical" .Values.deploymentKey -}} {{- $deployment := index .Values.deployments $key -}} {{- if not $deployment -}} {{- fail (printf "values.yaml의 deployments에 '%s'가 없다. 오타이거나 아직 토폴로지에 추가하지 않은 배포다." $key) -}} {{- end -}} {{- if not (index .Values.tiers $deployment.tier) -}} {{- fail (printf "values.yaml의 tiers에 '%s' 등급이 없다. deployments의 tier와 tiers의 key가 어긋났다." $deployment.tier) -}} {{- end -}} {{- required "global.mcpHost에 환경별 공개 MCP host를 지정해야 한다." .Values.global.mcpHost -}} {{- required "route.sourceAllowlist에 Agent Builder의 고정 egress CIDR을 지정해야 한다." .Values.route.sourceAllowlist -}} {{- $publicPath := required (printf "deployments.%s.publicPath를 지정해야 한다." $key) $deployment.publicPath -}} {{- if not (regexMatch "^/mcp/[a-z0-9-]+$" $publicPath) -}} {{- fail (printf "deployments.%s.publicPath는 /mcp/<영문 소문자·숫자·하이픈> 형식이어야 한다: %s" $key $publicPath) -}} {{- end -}} {{- end -}} {{/* 리소스 이름. 하나의 namespace에 여러 MCP 배포가 들어가므로 배포마다 다른 이름을 쓴다. */}} {{- define "mcp-server.name" -}} {{- include "mcp-server.validate" . -}} {{- (index .Values.deployments .Values.deploymentKey).name -}} {{- end -}} {{/* Redis key namespace가 되는 식별자. 환경 접미사를 여기서 자동으로 붙인다. 사람이 values에 직접 적으면 dev/test/prod가 같은 값을 갖는 실수가 나고, 그 순간 서로의 Tool snapshot을 덮어쓴다. */}} {{- define "mcp-server.identity" -}} {{- printf "%s-%s" (include "mcp-server.name" .) .Values.global.env -}} {{- end -}} {{/* 이 MCP가 보는 Tool Service의 host:port. MCP와 Tool Service는 같은 namespace이므로 서비스 이름만으로 FQDN이 완성된다. 호출 대상 주소는 오직 이 설정에서만 온다(계약 v0.2 §1). 매니페스트 응답은 이 값을 바꿀 수 없다. */}} {{- define "mcp-server.toolServiceHost" -}} {{- include "mcp-server.validate" . -}} {{- $deployment := index .Values.deployments .Values.deploymentKey -}} {{- printf "%s.%s.svc.cluster.local:%v" $deployment.service .Release.Namespace .Values.toolService.port -}} {{- end -}} {{- define "mcp-server.labels" -}} app: {{ include "mcp-server.name" . }} app.kubernetes.io/name: {{ include "mcp-server.name" . }} app.kubernetes.io/instance: {{ .Release.Name }} app.kubernetes.io/component: mcp-server app.kubernetes.io/part-of: ax-hub ax-hub/tier: {{ (index .Values.deployments .Values.deploymentKey).tier }} {{- end -}} {{- define "mcp-server.selectorLabels" -}} app: {{ include "mcp-server.name" . }} {{- end -}}