Skip to content

Commit 40feb15

Browse files
authored
Merge pull request #8248 from k8s-infra-cherrypick-robot/cherry-pick-8239-to-release-1.3
[release-1.3] 📖 Add cloud-provider-azure helm install to quickstart
2 parents 0d66df5 + 143cf21 commit 40feb15

File tree

1 file changed

+23
-3
lines changed

1 file changed

+23
-3
lines changed

docs/book/src/user/quick-start.md

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ If using a [provider] that does not support v1beta1 or v1alpha4 yet, please foll
1616

1717
- Install and setup [kubectl] in your local environment
1818
- Install [kind] and [Docker]
19+
- Install [Helm]
1920

2021
### Install and/or configure a Kubernetes cluster
2122

@@ -1357,18 +1358,36 @@ Note: To use the default clusterctl method to retrieve kubeconfig for a workload
13571358
{{#/tab }}
13581359
{{#/tabs }}
13591360
1361+
### Install a Cloud Provider
1362+
1363+
The Kubernetes in-tree cloud provider implementations are being [removed](https://github.com/kubernetes/enhancements/tree/master/keps/sig-cloud-provider/2395-removing-in-tree-cloud-providers) in favor of external cloud providers (also referred to as "out-of-tree"). This requires deploying a new component called the cloud-controller-manager which is responsible for running all the cloud specific controllers that were previously run in the kube-controller-manager. To learn more, see [this blog post](https://kubernetes.io/blog/2019/04/17/the-future-of-cloud-providers-in-kubernetes/).
1364+
1365+
{{#tabs name:"tab-install-cloud-provider" tabs:"Azure"}}
1366+
{{#tab Azure}}
1367+
1368+
Install the official cloud-provider-azure Helm chart on the workload cluster:
1369+
1370+
```bash
1371+
helm install --kubeconfig=./capi-quickstart.kubeconfig --repo https://raw.githubusercontent.com/kubernetes-sigs/cloud-provider-azure/master/helm/repo cloud-provider-azure --generate-name --set infra.clusterName=capi-quickstart --set cloudControllerManager.clusterCIDR="192.168.0.0/16"
1372+
```
1373+
1374+
For more information, see the [CAPZ book](https://capz.sigs.k8s.io/topics/addons.html).
1375+
1376+
{{#/tab }}
1377+
{{#/tabs }}
1378+
13601379
### Deploy a CNI solution
13611380
13621381
Calico is used here as an example.
13631382
13641383
{{#tabs name:"tab-deploy-cni" tabs:"Azure,vcluster,KubeVirt,others..."}}
13651384
{{#tab Azure}}
13661385
1367-
Azure [does not currently support Calico networking](https://docs.projectcalico.org/reference/public-cloud/azure). As a workaround, it is recommended that Azure clusters use the Calico spec below that uses VXLAN.
1386+
Install the official Calico Helm chart on the workload cluster:
13681387
13691388
```bash
1370-
kubectl --kubeconfig=./capi-quickstart.kubeconfig \
1371-
apply -f https://raw.githubusercontent.com/kubernetes-sigs/cluster-api-provider-azure/main/templates/addons/calico.yaml
1389+
helm repo add projectcalico https://docs.tigera.io/calico/charts --kubeconfig=./capi-quickstart.kubeconfig && \
1390+
helm install calico projectcalico/tigera-operator --kubeconfig=./capi-quickstart.kubeconfig -f https://raw.githubusercontent.com/kubernetes-sigs/cluster-api-provider-azure/main/templates/addons/calico/values.yaml --namespace tigera-operator --create-namespace
13721391
```
13731392
13741393
After a short while, our nodes should be running and in `Ready` state,
@@ -1564,6 +1583,7 @@ See the [clusterctl] documentation for more detail about clusterctl supported ac
15641583
[clusterctl]: ../clusterctl/overview.md
15651584
[Docker]: https://www.docker.com/
15661585
[GCP provider]: https://github.com/kubernetes-sigs/cluster-api-provider-gcp
1586+
[Helm]: https://helm.sh/docs/intro/install/
15671587
[Hetzner provider]: https://github.com/syself/cluster-api-provider-hetzner
15681588
[IBM Cloud provider]: https://github.com/kubernetes-sigs/cluster-api-provider-ibmcloud
15691589
[infrastructure provider]: ../reference/glossary.md#infrastructure-provider

0 commit comments

Comments
 (0)