Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
9b55eb07
Commit
9b55eb07
authored
Dec 03, 2021
by
Dmitrijs Finaskins
Committed by
Marcel Amirault
Dec 03, 2021
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update zero_downtime.md to fix Vale issues
parent
ebea6df2
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
11 additions
and
11 deletions
+11
-11
doc/update/zero_downtime.md
doc/update/zero_downtime.md
+11
-11
No files found.
doc/update/zero_downtime.md
View file @
9b55eb07
...
...
@@ -29,9 +29,9 @@ If you meet all the requirements above, follow these instructions in order. Ther
|
[
Geo
](
#geo-deployment
)
| GitLab EE with Geo enabled |
|
[
Multi-node / HA with Geo
](
#multi-node--ha-deployment-with-geo
)
| GitLab CE/EE on multiple nodes |
Each type of deployment
will require
that you hot reload the
`puma`
and
`sidekiq`
processes on all nodes running these
Each type of deployment
requires
that you hot reload the
`puma`
and
`sidekiq`
processes on all nodes running these
services after you've upgraded. The reason for this is that those processes each load the GitLab Rails application which reads and loads
the database schema into memory when starting up. Each of these processes
will need
to be reloaded (or restarted in the case of
`sidekiq`
)
the database schema into memory when starting up. Each of these processes
needs
to be reloaded (or restarted in the case of
`sidekiq`
)
to re-read any database changes that have been made by post-deployment migrations.
Most of the time you can safely upgrade from a patch release to the next minor
...
...
@@ -176,14 +176,14 @@ Upgrades on web (Puma) nodes must be done in a rolling manner, one after
another, ensuring at least one node is always up to serve traffic. This is
required to ensure zero-downtime.
Puma
will enter a blackout period as part of the upgrade, during which they
continue to accept connections but
will
mark their respective health check
Puma
enters a blackout period as part of the upgrade, during which nodes
continue to accept connections but mark their respective health check
endpoints to be unhealthy. On seeing this, the load balancer should disconnect
them gracefully.
Puma
will restart
only after completing all the currently processing requests.
Puma
restarts
only after completing all the currently processing requests.
This ensures data and service integrity. Once they have restarted, the health
check end points
will b
e marked healthy.
check end points
ar
e marked healthy.
The nodes must be updated in the following order to update an HA instance using
load balancer to latest GitLab version.
...
...
@@ -254,7 +254,7 @@ the application.
Before you update the main application you need to update Praefect.
Out of your Praefect nodes, pick one to be your Praefect deploy node.
This is where you
will
install the new Omnibus package first and run
This is where you install the new Omnibus package first and run
database migrations.
**Praefect deploy node**
...
...
@@ -360,7 +360,7 @@ node throughout the process.
-
If you're using PgBouncer:
You
'll
need to bypass PgBouncer and connect directly to the database master
You need to bypass PgBouncer and connect directly to the database master
before running migrations.
Rails uses an advisory lock when attempting to run a migration to prevent
...
...
@@ -457,7 +457,7 @@ following command to get address of current Redis primary
```
-
If your application node is running a version older than GitLab 12.7.0, you
will
have to run the underlying
`redis-cli`
command (which
`get-redis-master`
have to run the underlying
`redis-cli`
command (which
`get-redis-master`
command uses) to fetch information about the primary.
1.
Get the address of one of the sentinel nodes specified as
...
...
@@ -653,7 +653,7 @@ setting `gitlab_rails['auto_migrate'] = false` in
This section describes the steps required to upgrade a multi-node / HA
deployment with Geo. Some steps must be performed on a particular node. This
node
will be
known as the “deploy node” and is noted through the following
node
is
known as the “deploy node” and is noted through the following
instructions.
Updates must be performed in the following order:
...
...
@@ -737,7 +737,7 @@ sudo touch /etc/gitlab/skip-auto-reconfigure
1.
If you're using PgBouncer:
You
'll
need to bypass PgBouncer and connect directly to the database master
You need to bypass PgBouncer and connect directly to the database master
before running migrations.
Rails uses an advisory lock when attempting to run a migration to prevent
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment