diff options
| author | Drew Blessing <drew@gitlab.com> | 2017-05-17 10:16:01 -0500 |
|---|---|---|
| committer | Drew Blessing <drew@gitlab.com> | 2017-05-17 14:37:48 -0500 |
| commit | acb72a8e6053fd8ffe197c294f6e86f3792a4f66 (patch) | |
| tree | 20709eb17cc82d302f31fc487a5ebe9a0a78afdf /doc/administration/high_availability | |
| parent | 65382a9763c604799f34ef7e0b3839fc707ffdc4 (diff) | |
| download | gitlab-ce-acb72a8e6053fd8ffe197c294f6e86f3792a4f66.tar.gz | |
Add warning about AWS EFS and performance
Diffstat (limited to 'doc/administration/high_availability')
| -rw-r--r-- | doc/administration/high_availability/nfs.md | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/administration/high_availability/nfs.md b/doc/administration/high_availability/nfs.md index c5125dc6d5a..82bb5689d0a 100644 --- a/doc/administration/high_availability/nfs.md +++ b/doc/administration/high_availability/nfs.md @@ -7,6 +7,23 @@ supported natively in NFS version 4. NFSv3 also supports locking as long as Linux Kernel 2.6.5+ is used. We recommend using version 4 and do not specifically test NFSv3. +## AWS Elastic File System (EFS) not recommended + +Customers and users have reported that AWS EFS does not perform well for GitLab's +use-case. There are several issues that can cause problems. For these reasons +GitLab recommends against using EFS with GitLab. + +- EFS bases allowed IOPS on volume size. The larger the volume, the more IOPS + are allocated. For smaller volumes, users may experience decent performance + for a period of time due to 'Burst Credits'. Over a period of weeks to months + credits may run out and performance will bottom out. +- For larger volumes, allocated IOPS may not be the problem. Workloads where + many small files are written in a serialized manner are not well-suited for EFS. + EBS with an NFS server on top will perform much better. + +For more details on another person's experience with EFS, see +[Amazon's Elastic File System: Burst Credits]()https://www.rawkode.io/2017/04/amazons-elastic-file-system-burst-credits/ + ### Recommended options When you define your NFS exports, we recommend you also add the following |