summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDiana Stanley <dstanley@gitlab.com>2019-06-18 11:59:47 -0700
committerDiana Stanley <dstanley@gitlab.com>2019-06-18 11:59:47 -0700
commit17b32d6713ca98a3f8692f1778217b2c1fdcf34f (patch)
treecb3d4be8b7e3b22abb50953d0a3a55d4670ee52d
parent2ffd71f8f1e7957ada82733b36a568ab316d60f2 (diff)
downloadgitlab-ce-17b32d6713ca98a3f8692f1778217b2c1fdcf34f.tar.gz
Update gitaly docs to enumerate how to eliminate NFS altogether
-rw-r--r--doc/administration/gitaly/index.md18
1 files changed, 18 insertions, 0 deletions
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