|
2 | 2 |
|
3 | 3 | This is a guide on how to get started with CAPV (Cluster API Provider vSphere). To learn more about cluster API in more depth, check out the the [cluster api docs page](https://cluster-api.sigs.k8s.io/).
|
4 | 4 |
|
5 |
| -- [Getting Started](#getting-started) |
6 |
| - - [Bootstrapping a Management Cluster with clusterctl](#bootstrapping-a-management-cluster-with-clusterctl) |
7 |
| - - [Install Requirements](#install-requirements) |
8 |
| - - [clusterctl](#clusterctl) |
9 |
| - - [Docker](#docker) |
10 |
| - - [Kind](#kind) |
11 |
| - - [kubectl](#kubectl) |
12 |
| - - [vSphere Requirements](#vsphere-requirements) |
13 |
| - - [vCenter Credentials](#vcenter-credentials) |
14 |
| - - [Uploading the CAPV Machine Image](#uploading-the-capv-machine-image) |
15 |
| - - [Generating YAML for the Bootstrap Cluster](#generating-yaml-for-the-bootstrap-cluster) |
16 |
| - - [Using clusterctl](#using-clusterctl) |
17 |
| - - [Managing Workload Clusters using the Management Cluster](#managing-workload-clusters-using-the-management-cluster) |
| 5 | +* [Getting Started](#getting-started) |
| 6 | + * [Bootstrapping a Management Cluster with clusterctl](#bootstrapping-a-management-cluster-with-clusterctl) |
| 7 | + * [Install Requirements](#install-requirements) |
| 8 | + * [clusterctl](#clusterctl) |
| 9 | + * [Docker](#docker) |
| 10 | + * [Kind](#kind) |
| 11 | + * [kubectl](#kubectl) |
| 12 | + * [vSphere Requirements](#vsphere-requirements) |
| 13 | + * [vCenter Credentials](#vcenter-credentials) |
| 14 | + * [Uploading the CAPV Machine Image](#uploading-the-capv-machine-image) |
| 15 | + * [Generating YAML for the Bootstrap Cluster](#generating-yaml-for-the-bootstrap-cluster) |
| 16 | + * [Using clusterctl](#using-clusterctl) |
| 17 | + * [Managing Workload Clusters using the Management Cluster](#managing-workload-clusters-using-the-management-cluster) |
18 | 18 |
|
19 | 19 | ## Bootstrapping a Management Cluster with clusterctl
|
20 | 20 |
|
|
99 | 99 |
|
100 | 100 | With the above environment variable file it is now possible to generate the manifests needed to bootstrap the management cluster. The following command uses Docker to run an image that has all of the necessary templates and tools to generate the YAML manifests. Additionally, the `envvars.txt` file created above is mounted inside the the image in order to provide the generation routine with its default values.
|
101 | 101 |
|
102 |
| -**Note** It's important to ensure you are leveraging an up to date version of the manifests container image below. Problems with this typically manifest themselves on workstations that have tested previous versions of CAPV. You can delete your existing manifest image by using ```docker rmi gcr.io/cluster-api-provider-vsphere/release/manifests``` or change the below command to use a specific manifest image version (i.e. `release/manifests:0.5.2-beta.0`) |
| 102 | +**Note** It's important to ensure you are leveraging an up to date version of the manifests container image below. Problems with this typically manifest themselves on workstations that have tested previous versions of CAPV. You can delete your existing manifest image by using ```docker rmi gcr.io/cluster-api-provider-vsphere/release/manifests``` or change the below command to use a specific manifest image version (i.e. `release/manifests:v0.5.4`) |
103 | 103 |
|
104 | 104 | You can issue the below command to generate the required manifest files.
|
105 | 105 |
|
106 | 106 | ```shell
|
107 | 107 | $ docker run --rm \
|
108 | 108 | -v "$(pwd)":/out \
|
109 | 109 | -v "$(pwd)/envvars.txt":/envvars.txt:ro \
|
110 |
| - gcr.io/cluster-api-provider-vsphere/release/manifests:latest \ |
| 110 | + gcr.io/cluster-api-provider-vsphere/release/manifests:v0.5.4 \ |
111 | 111 | -c management-cluster
|
112 | 112 |
|
113 | 113 | Generated ./out/management-cluster/cluster.yaml
|
@@ -149,7 +149,7 @@ Using the same Docker command as above, generate resources for a new cluster, th
|
149 | 149 | $ docker run --rm \
|
150 | 150 | -v "$(pwd)":/out \
|
151 | 151 | -v "$(pwd)/envvars.txt":/envvars.txt:ro \
|
152 |
| - gcr.io/cluster-api-provider-vsphere/release/manifests:latest \ |
| 152 | + gcr.io/cluster-api-provider-vsphere/release/manifests:v0.5.4 \ |
153 | 153 | -c workload-cluster-1
|
154 | 154 | ```
|
155 | 155 |
|
|
0 commit comments