From 17b32d6713ca98a3f8692f1778217b2c1fdcf34f Mon Sep 17 00:00:00 2001 From: Diana Stanley Date: Tue, 18 Jun 2019 11:59:47 -0700 Subject: [PATCH 1/4] Update gitaly docs to enumerate how to eliminate NFS altogether --- doc/administration/gitaly/index.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md index 53a85dfad6c..f363baaece9 100644 --- a/doc/administration/gitaly/index.md +++ b/doc/administration/gitaly/index.md @@ -432,6 +432,24 @@ gitaly_enabled=false When you run `service gitlab restart` Gitaly will be disabled on this particular machine. +## Eliminating NFS altogether + +If you are planning to use gitaly without NFS for your storage needs +and want to eliminate NFS from your environment altogether, there are +a few things that you need to do: + +1) make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk +2) configure [database lookup of ssh keys](https://docs.gitlab.com/ee/administration/operations/fast_ssh_key_lookup.html) + to eliminate the need for a shared authorized_keys file +3) configure [object storage for job artifacts](https://docs.gitlab.com/ee/administration/job_artifacts.html#using-object-storage) + including [live tracing](https://docs.gitlab.com/ee/administration/job_traces.html#new-live-trace-architecture) +4) configure [object storage for LFS objects](https://docs.gitlab.com/ee/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) +5) configure [object storage for uploads](https://docs.gitlab.com/ee/administration/uploads.html#using-object-storage-core-only) + +NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): Pages. +There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196) +to eliminate the need for NFS to support Pages. + ## Troubleshooting Gitaly in production Since GitLab 11.6, Gitaly comes with a command-line tool called From 4605e64d88f838720487ceee7ed5098e115e30e0 Mon Sep 17 00:00:00 2001 From: Diana Stanley Date: Tue, 18 Jun 2019 12:15:35 -0700 Subject: [PATCH 2/4] Modify to conform to style guide --- doc/administration/gitaly/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md index f363baaece9..82105c91205 100644 --- a/doc/administration/gitaly/index.md +++ b/doc/administration/gitaly/index.md @@ -438,13 +438,13 @@ If you are planning to use gitaly without NFS for your storage needs and want to eliminate NFS from your environment altogether, there are a few things that you need to do: -1) make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk -2) configure [database lookup of ssh keys](https://docs.gitlab.com/ee/administration/operations/fast_ssh_key_lookup.html) + 1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk + 1. Configure [database lookup of ssh keys](https://docs.gitlab.com/ee/administration/operations/fast_ssh_key_lookup.html) to eliminate the need for a shared authorized_keys file -3) configure [object storage for job artifacts](https://docs.gitlab.com/ee/administration/job_artifacts.html#using-object-storage) + 1. Configure [object storage for job artifacts](https://docs.gitlab.com/ee/administration/job_artifacts.html#using-object-storage) including [live tracing](https://docs.gitlab.com/ee/administration/job_traces.html#new-live-trace-architecture) -4) configure [object storage for LFS objects](https://docs.gitlab.com/ee/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) -5) configure [object storage for uploads](https://docs.gitlab.com/ee/administration/uploads.html#using-object-storage-core-only) + 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ee/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) + 1. Configure [object storage for uploads](https://docs.gitlab.com/ee/administration/uploads.html#using-object-storage-core-only) NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): Pages. There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196) From 57ab4323702333a95b589a130b138dcb731d3144 Mon Sep 17 00:00:00 2001 From: Diana Stanley Date: Tue, 18 Jun 2019 13:19:41 -0700 Subject: [PATCH 3/4] Prefer cd path over ee path in docs links --- doc/administration/gitaly/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md index 82105c91205..747993de63f 100644 --- a/doc/administration/gitaly/index.md +++ b/doc/administration/gitaly/index.md @@ -439,12 +439,12 @@ and want to eliminate NFS from your environment altogether, there are a few things that you need to do: 1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk - 1. Configure [database lookup of ssh keys](https://docs.gitlab.com/ee/administration/operations/fast_ssh_key_lookup.html) + 1. Configure [database lookup of ssh keys](https://docs.gitlab.com/ce/administration/operations/fast_ssh_key_lookup.html) to eliminate the need for a shared authorized_keys file - 1. Configure [object storage for job artifacts](https://docs.gitlab.com/ee/administration/job_artifacts.html#using-object-storage) - including [live tracing](https://docs.gitlab.com/ee/administration/job_traces.html#new-live-trace-architecture) - 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ee/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) - 1. Configure [object storage for uploads](https://docs.gitlab.com/ee/administration/uploads.html#using-object-storage-core-only) + 1. Configure [object storage for job artifacts](https://docs.gitlab.com/ce/administration/job_artifacts.html#using-object-storage) + including [live tracing](https://docs.gitlab.com/ce/administration/job_traces.html#new-live-trace-architecture) + 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ce/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) + 1. Configure [object storage for uploads](https://docs.gitlab.com/ce/administration/uploads.html#using-object-storage-core-only) NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): Pages. There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196) From 205ca18ba401c02eec4692b2cc2a7f322488e008 Mon Sep 17 00:00:00 2001 From: Mike Lewis Date: Wed, 19 Jun 2019 19:15:53 +0000 Subject: [PATCH 4/4] Minor edits to Eliminating NFS section --- doc/administration/gitaly/index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md index 747993de63f..da8f1ee1529 100644 --- a/doc/administration/gitaly/index.md +++ b/doc/administration/gitaly/index.md @@ -434,21 +434,21 @@ particular machine. ## Eliminating NFS altogether -If you are planning to use gitaly without NFS for your storage needs +If you are planning to use Gitaly without NFS for your storage needs and want to eliminate NFS from your environment altogether, there are a few things that you need to do: - 1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk - 1. Configure [database lookup of ssh keys](https://docs.gitlab.com/ce/administration/operations/fast_ssh_key_lookup.html) - to eliminate the need for a shared authorized_keys file + 1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk. + 1. Configure [database lookup of SSH keys](https://docs.gitlab.com/ce/administration/operations/fast_ssh_key_lookup.html) + to eliminate the need for a shared authorized_keys file. 1. Configure [object storage for job artifacts](https://docs.gitlab.com/ce/administration/job_artifacts.html#using-object-storage) - including [live tracing](https://docs.gitlab.com/ce/administration/job_traces.html#new-live-trace-architecture) - 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ce/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage) - 1. Configure [object storage for uploads](https://docs.gitlab.com/ce/administration/uploads.html#using-object-storage-core-only) + including [live tracing](https://docs.gitlab.com/ce/administration/job_traces.html#new-live-trace-architecture). + 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ce/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage). + 1. Configure [object storage for uploads](https://docs.gitlab.com/ce/administration/uploads.html#using-object-storage-core-only). -NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): Pages. +NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): [GitLab Pages](../../user/project/pages/index.md). There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196) -to eliminate the need for NFS to support Pages. +to eliminate the need for NFS to support GitLab Pages. ## Troubleshooting Gitaly in production