Skip to content

πŸ“š Documentation needed for commit testΒ #36

Description

@github-actions

Summary

Commit 19f074ef introduces a significant infrastructure component β€” deploying the AKS MCP Server via Helm with Azure Workload Identity β€” that requires documentation updates.

What Changed

infra/aks-mcp.tf

New helm_release resource (aks_mcp) that:

  • Pulls the aks-mcp Helm chart from oci://ghcr.io/azure/aks-mcp/charts
  • Reuses the pre-created workload identity Service Account from kubernetes.tf
  • Sets pod label azure.workload.identity/use: true for federated token pickup
  • Injects AZURE_CLIENT_ID and AZURE_TENANT_ID as environment variables
  • Exposes service on port 8000, matching .copilot/mcp-config.json

infra/outputs.tf

New Terraform output aks_mcp_port_forward_command:

kubectl port-forward -n aks-mcp svc/aks-mcp 8000:8000

Why Documentation Is Needed

  • New integration: AKS MCP Server via Helm chart from GHCR
  • Architectural change: new service added to the AKS cluster
  • Security config: Azure Workload Identity / federated credentials
  • Developer-facing procedure: port-forward command needed for local MCP access

Suggested Documentation Updates

  1. README.md or infra/README.md β€” Add section on the AKS MCP Server: what it is, how Workload Identity authenticates it, the port-forward command, and the relationship to .copilot/mcp-config.json.
  2. infra/ docs β€” Document the aks_mcp_chart_version Terraform variable.
  3. .copilot/ docs β€” Note that localhost:8000 depends on the port-forward being active before using MCP tooling locally.

No Breaking Changes

This is an additive infrastructure change. However, developers need to run the port-forward command before using MCP tooling locally.

References

  • Commit: 19f074efb950f019670ee47ebfa36240476a0b7e
  • Files changed: infra/aks-mcp.tf, infra/outputs.tf
  • Helm chart: oci://ghcr.io/azure/aks-mcp/charts/aks-mcp

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions