debian-mirror-gitlab/doc/administration/read_only_gitlab.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

126 lines
3.6 KiB
Markdown
Raw Normal View History

2021-01-03 14:25:43 +05:30
---
2022-07-23 23:45:48 +05:30
stage: Systems
2021-01-03 14:25:43 +05:30
group: Distribution
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2021-01-03 14:25:43 +05:30
---
2021-03-11 19:13:27 +05:30
# Place GitLab into a read-only state **(FREE SELF)**
2021-01-03 14:25:43 +05:30
2021-04-17 20:07:23 +05:30
NOTE:
In GitLab 13.9 and later, the recommended method to
place GitLab in a read-only state is to enable
[maintenance mode](../administration/maintenance_mode/index.md).
2021-01-03 14:25:43 +05:30
In some cases, you might want to place GitLab under a read-only state.
The configuration for doing so depends on your desired outcome.
## Make the repositories read-only
2022-01-26 12:08:38 +05:30
The first thing you want to accomplish is to ensure that no changes can be
2021-01-03 14:25:43 +05:30
made to your repositories. There's two ways you can accomplish that:
2021-09-04 01:27:46 +05:30
- Either stop Puma to make the internal API unreachable:
2021-01-03 14:25:43 +05:30
```shell
2021-09-04 01:27:46 +05:30
sudo gitlab-ctl stop puma
2021-01-03 14:25:43 +05:30
```
- Or, open up a Rails console:
```shell
sudo gitlab-rails console
```
And set the repositories for all projects read-only:
```ruby
Project.all.find_each { |project| project.update!(repository_read_only: true) }
```
When you're ready to revert this, you can do so with the following command:
```ruby
Project.all.find_each { |project| project.update!(repository_read_only: false) }
```
## Shut down the GitLab UI
If you don't mind shutting down the GitLab UI, then the easiest approach is to
2022-01-26 12:08:38 +05:30
stop `sidekiq` and `puma`, and you effectively ensure that no
2021-01-03 14:25:43 +05:30
changes can be made to GitLab:
```shell
sudo gitlab-ctl stop sidekiq
2021-09-04 01:27:46 +05:30
sudo gitlab-ctl stop puma
2021-01-03 14:25:43 +05:30
```
When you're ready to revert this:
```shell
sudo gitlab-ctl start sidekiq
2021-09-04 01:27:46 +05:30
sudo gitlab-ctl start puma
2021-01-03 14:25:43 +05:30
```
## Make the database read-only
2022-08-13 15:12:31 +05:30
If you want to allow users to use the GitLab UI, ensure that
2021-01-03 14:25:43 +05:30
the database is read-only:
2021-11-18 22:05:49 +05:30
1. Take a [GitLab backup](../raketasks/backup_restore.md)
2021-01-03 14:25:43 +05:30
in case things don't go as expected.
2021-03-11 19:13:27 +05:30
1. Enter PostgreSQL on the console as an administrator user:
2021-01-03 14:25:43 +05:30
```shell
sudo \
-u gitlab-psql /opt/gitlab/embedded/bin/psql \
-h /var/opt/gitlab/postgresql gitlabhq_production
```
2021-10-27 15:23:28 +05:30
1. Create the `gitlab_read_only` user. The password is set to `mypassword`,
2021-01-03 14:25:43 +05:30
change that to your liking:
```sql
-- NOTE: Use the password defined earlier
CREATE USER gitlab_read_only WITH password 'mypassword';
GRANT CONNECT ON DATABASE gitlabhq_production to gitlab_read_only;
GRANT USAGE ON SCHEMA public TO gitlab_read_only;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO gitlab_read_only;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO gitlab_read_only;
-- Tables created by "gitlab" should be made read-only for "gitlab_read_only"
-- automatically.
ALTER DEFAULT PRIVILEGES FOR USER gitlab IN SCHEMA public GRANT SELECT ON TABLES TO gitlab_read_only;
ALTER DEFAULT PRIVILEGES FOR USER gitlab IN SCHEMA public GRANT SELECT ON SEQUENCES TO gitlab_read_only;
```
1. Get the hashed password of the `gitlab_read_only` user and copy the result:
```shell
sudo gitlab-ctl pg-password-md5 gitlab_read_only
```
1. Edit `/etc/gitlab/gitlab.rb` and add the password from the previous step:
```ruby
postgresql['sql_user_password'] = 'a2e20f823772650f039284619ab6f239'
postgresql['sql_user'] = "gitlab_read_only"
```
1. Reconfigure GitLab and restart PostgreSQL:
```shell
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart postgresql
```
2022-08-13 15:12:31 +05:30
When you're ready to revert the read-only state, remove the added
2021-01-03 14:25:43 +05:30
lines in `/etc/gitlab/gitlab.rb`, and reconfigure GitLab and restart PostgreSQL:
```shell
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart postgresql
```
2022-08-13 15:12:31 +05:30
After you verify all works as expected, remove the `gitlab_read_only`
2021-01-03 14:25:43 +05:30
user from the database.