Document how to apply configuration changes to a deployed server
Problem to solve
There's no clear docs on how to apply configuration changes to an already deployed GitLab instance.
The deployment doc only mentions how to make the initial deployment.
If you are just following that prescriptively without paying attention to the currently deployed version, a "Deploy the helm chart" might have a side-effect of updating the GitLab deployment to the latest version available (at least with the last helm repo update
).
Further details
Discussed in gitlab-org&8595 (comment 1068105117).
Proposal
There's some "hidden" information how to apply configuration changes in the k8s cheatsheet, but they're buried down.
We must create a new doc or a subsection somewhere with the following info (to verify with the engineers):
-
Get current values and redirect them to yaml file (analogous to the
/etc/gitlab/gitlab.rb
values):helm get values <release name> > gitlab.yaml
-
Edit
gitlab.yaml
and add your configuration changes. -
Apply the changes:
helm upgrade <release name> <chart path> -f gitlab.yaml
Who can address the issue
The Technical Writing team.