Commit 6d7bb6b1 authored by Russell Dickenson's avatar Russell Dickenson

Merge branch 'eread/update-gitaly-and-nfs-deprecation-notice' into 'master'

Update NFS for Git repositories deprecation notices

See merge request gitlab-org/gitlab!64148
parents 89ca2cd1 fd226cd8
...@@ -47,14 +47,8 @@ E --> F ...@@ -47,14 +47,8 @@ E --> F
End users do not have direct access to Gitaly. Gitaly manages only Git repository access for GitLab. End users do not have direct access to Gitaly. Gitaly manages only Git repository access for GitLab.
Other types of GitLab data aren't accessed using Gitaly. Other types of GitLab data aren't accessed using Gitaly.
<!-- vale gitlab.FutureTense = NO -->
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Read the [deprecation notice](#nfs-deprecation-notice).
considered and customer technical support will be considered out of scope.
[Read more about Gitaly and NFS](#nfs-deprecation-notice).
<!-- vale gitlab.FutureTense = YES -->
## Configure Gitaly ## Configure Gitaly
...@@ -134,9 +128,8 @@ appropriately by: ...@@ -134,9 +128,8 @@ appropriately by:
### Moving beyond NFS ### Moving beyond NFS
WARNING: WARNING:
From GitLab 13.0, using NFS for Git repositories is deprecated. In GitLab 14.0, Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
support for NFS for Git repositories is scheduled to be removed. Upgrade to unavailable from GitLab 15.0. No further enhancements are planned for this feature.
Gitaly Cluster as soon as possible.
[Network File System (NFS)](https://en.wikipedia.org/wiki/Network_File_System) [Network File System (NFS)](https://en.wikipedia.org/wiki/Network_File_System)
is not well suited to Git workloads which are CPU and IOPS sensitive. is not well suited to Git workloads which are CPU and IOPS sensitive.
...@@ -360,22 +353,21 @@ The second facet presents the only real solution. For this, we developed ...@@ -360,22 +353,21 @@ The second facet presents the only real solution. For this, we developed
## NFS deprecation notice ## NFS deprecation notice
<!-- vale gitlab.FutureTense = NO --> Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
unavailable from GitLab 15.0. No further enhancements are planned for this feature.
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be
considered and customer technical support will be considered out of scope.
Additional information: Additional information:
- [Recommended NFS mount options and known issues with Gitaly and NFS](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). - [Recommended NFS mount options and known issues with Gitaly and NFS](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
- [GitLab statement of support](https://about.gitlab.com/support/statement-of-support.html#gitaly-and-nfs). - [GitLab statement of support](https://about.gitlab.com/support/statement-of-support.html#gitaly-and-nfs).
<!-- vale gitlab.FutureTense = YES -->
GitLab recommends: GitLab recommends:
- Creating a [Gitaly Cluster](#gitaly-cluster) as soon as possible. - Creating a [Gitaly Cluster](#gitaly-cluster) as soon as possible.
- [Moving your repositories](praefect.md#migrate-to-gitaly-cluster) from NFS-based storage to Gitaly - [Moving your repositories](praefect.md#migrate-to-gitaly-cluster) from NFS-based storage to Gitaly
Cluster. Cluster.
We welcome your feedback on this process: raise a support ticket, or [comment on the epic](https://gitlab.com/groups/gitlab-org/-/epics/4916). We welcome your feedback on this process. You can:
- Raise a support ticket.
- [Comment on the epic](https://gitlab.com/groups/gitlab-org/-/epics/4916).
...@@ -20,11 +20,13 @@ file system performance, see ...@@ -20,11 +20,13 @@ file system performance, see
## Gitaly and NFS deprecation ## Gitaly and NFS deprecation
WARNING: Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories are no longer unavailable from GitLab 15.0. No further enhancements are planned for this feature.
considered and customer technical support is considered out of scope.
[Read more about Gitaly and NFS](gitaly/index.md#nfs-deprecation-notice) and Read:
[the correct mount options to use](#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
- The [Gitaly and NFS deprecation notice](gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
## Known kernel version incompatibilities ## Known kernel version incompatibilities
...@@ -368,9 +370,8 @@ sudo ufw allow from <client_ip_address> to any port nfs ...@@ -368,9 +370,8 @@ sudo ufw allow from <client_ip_address> to any port nfs
### Upgrade to Gitaly Cluster or disable caching if experiencing data loss ### Upgrade to Gitaly Cluster or disable caching if experiencing data loss
WARNING: WARNING:
From GitLab 13.0, using NFS for Git repositories is deprecated. Engineering support for NFS for Git repositories is deprecated. Read the
As of GitLab 14.0, NFS-related issues with Gitaly are no longer addressed. Read [Gitaly and NFS deprecation notice](gitaly/index.md#nfs-deprecation-notice).
more about [Gitaly and NFS deprecation](gitaly/index.md#nfs-deprecation-notice).
Customers and users have reported data loss on high-traffic repositories when using NFS for Git repositories. Customers and users have reported data loss on high-traffic repositories when using NFS for Git repositories.
For example, we have seen: For example, we have seen:
......
...@@ -2344,10 +2344,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag ...@@ -2344,10 +2344,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
<div align="right"> <div align="right">
<a type="button" class="btn btn-default" href="#setup-components"> <a type="button" class="btn btn-default" href="#setup-components">
......
...@@ -2362,10 +2362,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag ...@@ -2362,10 +2362,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
<div align="right"> <div align="right">
<a type="button" class="btn btn-default" href="#setup-components"> <a type="button" class="btn btn-default" href="#setup-components">
......
...@@ -965,10 +965,13 @@ possible. However, if you intend to use GitLab Pages, ...@@ -965,10 +965,13 @@ possible. However, if you intend to use GitLab Pages,
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
<div align="right"> <div align="right">
<a type="button" class="btn btn-default" href="#setup-components"> <a type="button" class="btn btn-default" href="#setup-components">
......
...@@ -2062,10 +2062,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag ...@@ -2062,10 +2062,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
## Supported modifications for lower user counts (HA) ## Supported modifications for lower user counts (HA)
......
...@@ -2373,10 +2373,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag ...@@ -2373,10 +2373,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
<div align="right"> <div align="right">
<a type="button" class="btn btn-default" href="#setup-components"> <a type="button" class="btn btn-default" href="#setup-components">
......
...@@ -2056,10 +2056,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag ...@@ -2056,10 +2056,13 @@ to use GitLab Pages, this currently [requires NFS](troubleshooting.md#gitlab-pag
See how to [configure NFS](../nfs.md). See how to [configure NFS](../nfs.md).
WARNING: WARNING:
From GitLab 14.0, enhancements and bug fixes for NFS for Git repositories will no longer be Engineering support for NFS for Git repositories is deprecated. Technical support is planned to be
considered and customer technical support will be considered out of scope. unavailable from GitLab 15.0. No further enhancements are planned for this feature.
[Read more about Gitaly and NFS](../gitaly/index.md#nfs-deprecation-notice) and
[the correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss). Read:
- The [Gitaly and NFS deprecation notice](../gitaly/index.md#nfs-deprecation-notice).
- About the [correct mount options to use](../nfs.md#upgrade-to-gitaly-cluster-or-disable-caching-if-experiencing-data-loss).
<div align="right"> <div align="right">
<a type="button" class="btn btn-default" href="#setup-components"> <a type="button" class="btn btn-default" href="#setup-components">
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment