Resolve "Add troubleshooting section to capture errors with installing applications to a Kubernetes cluster"
This commit is contained in:
parent
aeeba4be36
commit
ecae2c4892
|
@ -314,12 +314,6 @@ install it manually.
|
|||
|
||||
## Installing applications
|
||||
|
||||
NOTE: **Note:**
|
||||
Before starting the installation of applications, make sure that time is synchronized
|
||||
between your GitLab server and your Kubernetes cluster. Otherwise, installation could fail
|
||||
and you may get errors like `Error: remote error: tls: bad certificate`
|
||||
in the `stdout` of pods created by GitLab in your Kubernetes cluster.
|
||||
|
||||
GitLab provides a one-click install for various applications which can
|
||||
be added directly to your configured cluster. Those applications are
|
||||
needed for [Review Apps](../../../ci/review_apps/index.md) and
|
||||
|
@ -378,6 +372,29 @@ Upgrades will reset values back to the values built into the `runner`
|
|||
chart plus the values set by
|
||||
[`values.yaml`](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/vendor/runner/values.yaml)
|
||||
|
||||
### Troubleshooting applications
|
||||
|
||||
Applications can fail with the following error:
|
||||
|
||||
```text
|
||||
Error: remote error: tls: bad certificate
|
||||
```
|
||||
|
||||
To avoid installation errors:
|
||||
|
||||
- Before starting the installation of applications, make sure that time is synchronized
|
||||
between your GitLab server and your Kubernetes cluster.
|
||||
- Ensure certificates are not out of sync. When installing applications, GitLab expects a new cluster with no previous installation of Tiller.
|
||||
|
||||
You can confirm that the certificates match via `kubectl`:
|
||||
|
||||
```sh
|
||||
kubectl get configmaps/values-content-configuration-ingress -n gitlab-managed-apps -o \
|
||||
"jsonpath={.data['cert\.pem']}" | base64 -d > a.pem
|
||||
kubectl get secrets/tiller-secret -n gitlab-managed-apps -o "jsonpath={.data['ca\.crt']}" | base64 -d > b.pem
|
||||
diff a.pem b.pem
|
||||
```
|
||||
|
||||
## Getting the external endpoint
|
||||
|
||||
NOTE: **Note:**
|
||||
|
|
Loading…
Reference in New Issue