|
2 | 2 |
|
3 | 3 | This is a guide on how to troubleshoot issues related to the Cluster API provider for vSphere (CAPV).
|
4 | 4 |
|
5 |
| -* [Troubleshooting](#troubleshooting) |
6 |
| - * [Debugging issues](#debugging-issues) |
7 |
| - * [Bootstrapping with logging](#bootstrapping-with-logging) |
8 |
| - * [Adjusting log levels](#adjusting-log-levels) |
9 |
| - * [Adjusting the CAPI manager log level](#adjusting-the-capi-manager-log-level) |
10 |
| - * [Adjusting the CAPV manager log level](#adjusting-the-capv-manager-log-level) |
11 |
| - * [Adjusting the `clusterctl` log level](#adjusting-the-clusterctl-log-level) |
12 |
| - * [Accessing the logs in the bootstrap cluster](#accessing-the-logs-in-the-bootstrap-cluster) |
13 |
| - * [Exporting the kubeconfig](#exporting-the-kubeconfig) |
14 |
| - * [Following the CAPI manager logs](#following-the-capi-manager-logs) |
15 |
| - * [Following the CAPV manager logs](#following-the-capv-manager-logs) |
16 |
| - * [Following Kubernetes core component logs](#following-kubernetes-core-component-logs) |
17 |
| - * [The API server](#the-api-server) |
18 |
| - * [The controller manager](#the-controller-manager) |
19 |
| - * [The scheduler](#the-scheduler) |
20 |
| - * [Common issues](#common-issues) |
21 |
| - * [Ensure prerequisites are up to date](#ensure-prerequisites-are-up-to-date) |
22 |
| - * [`envvars.txt` is a directory](#envvarstxt-is-a-directory) |
23 |
| - * [Failed to retrieve kubeconfig secret](#failed-to-retrieve-kubeconfig-secret) |
24 |
| - * [Timed out while failing to retrieve kubeconfig secret](#timed-out-while-failing-to-retrieve-kubeconfig-secret) |
25 |
| - * [Cannot access the vSphere endpoint](#cannot-access-the-vsphere-endpoint) |
26 |
| - * [A VM with the same name already exists](#a-vm-with-the-same-name-already-exists) |
27 |
| - * [A static IP address must include the segment length](#a-static-ip-address-must-include-the-segment-length) |
28 |
| - * [Multiple networks](#multiple-networks) |
29 |
| - * [Multiple default routes](#multiple-default-routes) |
30 |
| - * [Preferring an IP address](#preferring-an-ip-address) |
| 5 | +- [Troubleshooting](#troubleshooting) |
| 6 | + - [Debugging issues](#debugging-issues) |
| 7 | + - [Bootstrapping with logging](#bootstrapping-with-logging) |
| 8 | + - [Adjusting log levels](#adjusting-log-levels) |
| 9 | + - [Adjusting the CAPI manager log level](#adjusting-the-capi-manager-log-level) |
| 10 | + - [Adjusting the CAPV manager log level](#adjusting-the-capv-manager-log-level) |
| 11 | + - [Adjusting the `clusterctl` log level](#adjusting-the-clusterctl-log-level) |
| 12 | + - [Accessing the logs in the bootstrap cluster](#accessing-the-logs-in-the-bootstrap-cluster) |
| 13 | + - [Exporting the kubeconfig](#exporting-the-kubeconfig) |
| 14 | + - [Following the CAPI manager logs](#following-the-capi-manager-logs) |
| 15 | + - [Following the CAPV manager logs](#following-the-capv-manager-logs) |
| 16 | + - [Following Kubernetes core component logs](#following-kubernetes-core-component-logs) |
| 17 | + - [The API server](#the-api-server) |
| 18 | + - [The controller manager](#the-controller-manager) |
| 19 | + - [The scheduler](#the-scheduler) |
| 20 | + - [Common issues](#common-issues) |
| 21 | + - [Ensure prerequisites are up to date](#ensure-prerequisites-are-up-to-date) |
| 22 | + - [`envvars.txt` is a directory](#envvarstxt-is-a-directory) |
| 23 | + - [Failed to retrieve kubeconfig secret](#failed-to-retrieve-kubeconfig-secret) |
| 24 | + - [Timed out while failing to retrieve kubeconfig secret](#timed-out-while-failing-to-retrieve-kubeconfig-secret) |
| 25 | + - [Cannot access the vSphere endpoint](#cannot-access-the-vsphere-endpoint) |
| 26 | + - [A VM with the same name already exists](#a-vm-with-the-same-name-already-exists) |
| 27 | + - [A static IP address must include the segment length](#a-static-ip-address-must-include-the-segment-length) |
| 28 | + - [Multiple networks](#multiple-networks) |
| 29 | + - [Multiple default routes](#multiple-default-routes) |
| 30 | + - [Preferring an IP address](#preferring-an-ip-address) |
31 | 31 |
|
32 | 32 | ## Debugging issues
|
33 | 33 |
|
@@ -55,7 +55,7 @@ The following steps may be used to adjust the CAPI manager's log level:
|
55 | 55 | - args:
|
56 | 56 | - --logtostderr
|
57 | 57 | - -v=6
|
58 |
| - - command: |
| 58 | + command: |
59 | 59 | - /manager
|
60 | 60 | image: us.gcr.io/k8s-artifacts-prod/cluster-api/cluster-api-controller:v0.1.7
|
61 | 61 | name: manager
|
@@ -210,7 +210,7 @@ Make sure the path to the `envvars.txt` file is correct before using it to gener
|
210 | 210 | When bootstrapping the management cluster, the vSphere manager log may emit errors similar to the following:
|
211 | 211 |
|
212 | 212 | ```shell
|
213 |
| -E0726 17:12:54.812485 1 actuator.go:217] [cluster-actuator]/cluster.k8s.io/v1alpha1/default/v0.4.0-beta.2 "msg"="target cluster is not ready" "error"="unable to get client for target cluster: failed to retrieve kubeconfig secret for Cluster \"management-cluster\" in namespace \"default\": secret not found" |
| 213 | +E0726 17:12:54.812485 1 actuator.go:217] [cluster-actuator]/cluster.k8s.io/v1alpha1/default/v0.4.0-beta.2 "msg"="target cluster is not ready" "error"="unable to get client for target cluster: failed to retrieve kubeconfig secret for Cluster \"management-cluster\" in namespace \"default\": secret not found" |
214 | 214 | ```
|
215 | 215 |
|
216 | 216 | The above error does not mean there is a problem. Kubernetes components operate in a reconciliation model -- a message loops attempts to reconcile the desired state over and over until it is achieved or a timeout occurs.
|
|
0 commit comments