Skip to content

deploy-controller.md

Latest commit

 

History

History
46 lines (29 loc) · 1.13 KB

deploy-controller.md

File metadata and controls

46 lines (29 loc) · 1.13 KB
Raw

Deploy the controller (in-cluster)

This guide shows how to deploy the coder-k8s controller to a Kubernetes cluster using the manifests in deploy/.

1. Create the namespace

The deployment manifests expect a coder-system namespace:

kubectl create namespace coder-system

2. Install the CRDs

Install the CoderControlPlane CRD:

kubectl apply -f config/crd/bases/

3. Apply RBAC

kubectl apply -f deploy/rbac.yaml

4. Deploy coder-k8s

kubectl apply -f deploy/deployment.yaml

deploy/deployment.yaml defaults to --app=all, which runs the controller, aggregated API server, and MCP server in a single pod.

For split deployments, you can still run individual components by setting --app=controller, --app=aggregated-apiserver, or --app=mcp-http in the Deployment args.

5. Verify

kubectl rollout status deployment/coder-k8s -n coder-system
kubectl get pods -n coder-system

Customizing the image

By default, deploy/deployment.yaml uses ghcr.io/coder/coder-k8s:latest. For a different image tag, edit the deployment manifest before applying it.