diff options
Diffstat (limited to 'doc/administration/terraform_state.md')
-rw-r--r-- | doc/administration/terraform_state.md | 20 |
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/administration/terraform_state.md b/doc/administration/terraform_state.md index 2b738f975ba..90b030e6e13 100644 --- a/doc/administration/terraform_state.md +++ b/doc/administration/terraform_state.md @@ -4,7 +4,7 @@ group: Environments info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments --- -# Terraform state administration **(FREE)** +# Terraform state administration **(FREE SELF)** > [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/2673) in GitLab 12.10. @@ -14,7 +14,7 @@ files. The files are encrypted before being stored. This feature is enabled by d The storage location of these files defaults to: - `/var/opt/gitlab/gitlab-rails/shared/terraform_state` for Linux package installations. -- `/home/git/gitlab/shared/terraform_state` for source installations. +- `/home/git/gitlab/shared/terraform_state` for self-compiled installations. These locations can be configured using the options described below. @@ -59,7 +59,7 @@ For self-compiled installations: enabled: false ``` -1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect. +1. Save the file and [restart GitLab](restart_gitlab.md#self-compiled-installations) for the changes to take effect. ## Using local storage @@ -88,7 +88,7 @@ For self-compiled installations: storage_path: /mnt/storage/terraform_state ``` -1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect. +1. Save the file and [restart GitLab](restart_gitlab.md#self-compiled-installations) for the changes to take effect. ## Using object storage **(FREE SELF)** @@ -102,8 +102,8 @@ This configuration relies on valid credentials to be configured already. The following settings are: -- Nested under `terraform_state:` and then `object_store:` on source installations. - Prefixed by `terraform_state_object_store_` on Linux package installations. +- Nested under `terraform_state:` and then `object_store:` on self-compiled installations. | Setting | Description | Default | |---------|-------------|---------| @@ -180,7 +180,9 @@ This section describes the earlier configuration format. See [the available connection settings for different providers](object_storage.md#configure-the-connection-settings). -**In Omnibus installations:** +::Tabs + +:::TabTitle Linux package (Omnibus) 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines; replacing with the values you want: @@ -210,7 +212,7 @@ See [the available connection settings for different providers](object_storage.m 1. Save the file and [reconfigure GitLab](restart_gitlab.md#reconfigure-a-linux-package-installation) for the changes to take effect. 1. [Migrate any existing local states to the object storage](#migrate-to-object-storage) -**In installations from source:** +:::TabTitle Self-compiled (source) 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines: @@ -228,5 +230,7 @@ See [the available connection settings for different providers](object_storage.m region: eu-central-1 ``` -1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect. +1. Save the file and [restart GitLab](restart_gitlab.md#self-compiled-installations) for the changes to take effect. 1. [Migrate any existing local states to the object storage](#migrate-to-object-storage) + +::EndTabs |