Commit a66db7be authored by Evan Read's avatar Evan Read Committed by Achilleas Pipinellis

Docs review for MR 25586

parent d119fd49
...@@ -1022,10 +1022,9 @@ planned for a subsequent release. ...@@ -1022,10 +1022,9 @@ planned for a subsequent release.
buildpack](#custom-buildpacks). buildpack](#custom-buildpacks).
- Auto Test may fail because of a mismatch between testing frameworks. In this - Auto Test may fail because of a mismatch between testing frameworks. In this
case, you may need to customize your `.gitlab-ci.yml` with your test commands. case, you may need to customize your `.gitlab-ci.yml` with your test commands.
- Auto Deploy may fail if it is unable to create a Kubernetes namespace and - Auto Deploy will fail if GitLab can not create a Kubernetes namespace and
service account for your project. See the service account for your project. For help debugging this issue, see
[troubleshooting failed deployments](../../user/project/clusters/index.md#troubleshooting-failed-deployment-jobs) [Troubleshooting failed deployment jobs](../../user/project/clusters/index.md#troubleshooting-failed-deployment-jobs).
section to debug why these resources were not created.
### Disable the banner instance wide ### Disable the banner instance wide
......
...@@ -548,25 +548,23 @@ service account of the cluster integration. ...@@ -548,25 +548,23 @@ service account of the cluster integration.
### Troubleshooting failed deployment jobs ### Troubleshooting failed deployment jobs
GitLab will create a namespace and service account specifically for your GitLab will create a namespace and service account specifically for your
deployment jobs. These resources are created just before the deployment deployment jobs, immediately before the jobs starts.
job starts. Sometimes there may be errors that cause their creation to fail.
In such instances, your job will fail with the message: However, sometimes GitLab can not create them. In such instances, your job will fail with the message:
```The job failed to complete prerequisite tasks``` ```text
The job failed to complete prerequisite tasks
```
You will need to check the [logs](../../../administration/logs.md) to debug To find the cause of this error when creating a namespace and service account, check the [logs](../../../administration/logs.md#sidekiqlog).
why the namespace and service account creation failed.
A common reason for failure is that the token you gave GitLab did not have Common reasons for failure include:
[`cluster-admin`](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles)
privileges as GitLab expects.
Another common problem is caused by a missing `KUBECONFIG` or `KUBE_TOKEN`. - The token you gave GitLab did not have [`cluster-admin`](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles)
To be passed to your job, it must have a matching privileges required by GitLab.
[`environment:name`](../../../ci/environments.md#defining-environments). If - Missing `KUBECONFIG` or `KUBE_TOKEN` variables. To be passed to your job, they must have a matching
your job has no `environment:name` set, it will not be passed the Kubernetes [`environment:name`](../../../ci/environments.md#defining-environments). If your job has no
credentials. `environment:name` set, it will not be passed the Kubernetes credentials.
## Monitoring your Kubernetes cluster **[ULTIMATE]** ## Monitoring your Kubernetes cluster **[ULTIMATE]**
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment