Skip to content

Commit 2753592

Browse files
committed
docs: fix kind quickstart helm instructions
1 parent 9b1ec99 commit 2753592

1 file changed

Lines changed: 20 additions & 19 deletions

File tree

docs/content/setup/quickstart-kind.md

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ description: >
77

88
This guide walks you through deploying kcp on a [kind](https://kind.sigs.k8s.io/) (Kubernetes in Docker) cluster using Helm, setting up multiple workspaces, and configuring access for different teams using client certificates.
99

10+
This guide covers the Helm-based deployment. A kcp-operator-based walkthrough will be added in a follow-up.
11+
1012
## Prerequisites
1113

1214
Before starting, ensure you have the following tools installed:
@@ -28,7 +30,7 @@ apiVersion: kind.x-k8s.io/v1alpha4
2830
nodes:
2931
- role: control-plane
3032
extraPortMappings:
31-
- containerPort: 8443
33+
- containerPort: 30443
3234
hostPort: 8443
3335
protocol: TCP
3436
EOF
@@ -45,7 +47,7 @@ kubectl cluster-info --context kind-kcp
4547
kcp requires cert-manager for TLS certificate management:
4648

4749
```bash
48-
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.14.4/cert-manager.yaml
50+
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.19.2/cert-manager.yaml
4951
```
5052

5153
Wait for cert-manager to be ready:
@@ -71,30 +73,29 @@ helm repo add kcp https://kcp-dev.github.io/helm-charts
7173
helm repo update
7274
```
7375

74-
Create a values file for the kind deployment:
76+
Install kcp:
7577

7678
```bash
77-
cat <<EOF > kcp-values.yaml
78-
externalHostname: kcp.dev.local
79-
80-
kcpFrontProxy:
81-
service:
82-
type: NodePort
83-
nodePort: 8443
84-
85-
# Development settings
86-
audit:
87-
enabled: false
88-
EOF
79+
helm upgrade --install kcp kcp/kcp \
80+
--namespace kcp \
81+
--create-namespace \
82+
--set externalHostname=kcp.dev.local \
83+
--set kcpFrontProxy.service.type=NodePort \
84+
--set kcpFrontProxy.service.nodePort=30443 \
85+
--set audit.enabled=false \
86+
--wait
8987
```
9088

91-
Install kcp:
89+
Set up host aliases so in-cluster kcp components can resolve `kcp.dev.local`:
9290

9391
```bash
94-
helm upgrade --install kcp kcp/kcp \
92+
KCP_FRONT_PROXY_IP=$(kubectl get svc kcp-front-proxy -n kcp -o jsonpath='{.spec.clusterIP}')
93+
helm upgrade kcp kcp/kcp \
9594
--namespace kcp \
96-
--create-namespace \
97-
--values kcp-values.yaml \
95+
--reuse-values \
96+
--set kcp.hostAliases.enabled=true \
97+
--set kcp.hostAliases.values[0].ip=${KCP_FRONT_PROXY_IP} \
98+
--set kcp.hostAliases.values[0].hostnames[0]=kcp.dev.local \
9899
--wait
99100
```
100101

0 commit comments

Comments
 (0)