diff options
Diffstat (limited to 'doc/user/clusters/agent/install/index.md')
| -rw-r--r-- | doc/user/clusters/agent/install/index.md | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/doc/user/clusters/agent/install/index.md b/doc/user/clusters/agent/install/index.md index 5b07dbd56d9..b8caf6d0837 100644 --- a/doc/user/clusters/agent/install/index.md +++ b/doc/user/clusters/agent/install/index.md @@ -137,7 +137,7 @@ By default, the Helm installation command generated by GitLab: - Creates a `Secret` resource for the agent's access token. To instead bring your own secret with a token, omit the token (`--set token=...`) and instead use `--set config.secretName=<your secret name>`. - Creates a `Deployment` resource for the `agentk` pod. -To see the full list of customizations available, see the Helm chart's [default values file](https://gitlab.com/gitlab-org/charts/gitlab-agent/-/blob/main/values.yaml). +To see the full list of customizations available, see the Helm chart's [README](https://gitlab.com/gitlab-org/charts/gitlab-agent/-/blob/main/README.md#values). ##### Use the agent when KAS is behind a self-signed certificate @@ -224,13 +224,19 @@ For the best experience, the version of the agent installed in your cluster shou ### Update the agent version +NOTE: +Instead of using `--reuse-values`, you should specify all needed values. +If you use `--reuse-values`, you might miss new defaults or use deprecated values. +To retrieve previous `--set` arguments, use `helm get values <release name>`. +You can save the values to a file with `helm get values gitlab-agent > agent.yaml`, and pass the file to Helm with `-f`: +`helm upgrade gitlab-agent gitlab/gitlab-agent -f agent.yaml`. This safely replaces the behavior of `--reuse-values`. + To update the agent to the latest version, you can run: ```shell helm repo update helm upgrade --install gitlab-agent gitlab/gitlab-agent \ --namespace gitlab-agent \ - --reuse-values ``` To set a specific version, you can override the `image.tag` value. For example, to install version `v14.9.1`, run: @@ -238,7 +244,6 @@ To set a specific version, you can override the `image.tag` value. For example, ```shell helm upgrade gitlab-agent gitlab/gitlab-agent \ --namespace gitlab-agent \ - --reuse-values \ --set image.tag=v14.9.1 ``` |