GitLab システム管理者 - ハンズオンラボ: Omnibus のバックアップとリストア

このハンズオンガイドでは、GitLab Omnibus インスタンスのバックアップとリストア方法を紹介します。

推定所要時間: 30 分

目的

このラボの目的は、仮想マシン上の GitLab インスタンスをバックアップし、以前の状態にリストアする方法を示すことです。GitLab インスタンスのバックアップ/リストアの詳細については、こちらをクリックしてください。

GitLab インスタンスサーバーで SSH セッションを開きます。
gitlab.rb のバックアップ設定の場所を検索します。
```
sudo grep -n backup_path /etc/gitlab/gitlab.rb
```
gitlab_rails['backup_path'] 設定の行番号をメモします。
GitLab バックアップを保存する新しいディレクトリを作成します。
```
sudo mkdir /tmp/backups
```
gitlab.rb を編集してバックアップパスを変更します。まず、テキストエディターでファイルを開きます。例: sudo nano /etc/gitlab/gitlab.rb
# gitlab_rails['backup_path'] = "/var/opt/gitlab/backups" の行を検索します。nano を使用している場合は、control-w を押して検索できます。
gitlab_rails['backup_path'] 行の先頭にある # 文字を削除します。これにより、行がコメント解除され、有効になります。
パスを "/tmp/backups" に置き換えます。結果は次の設定行になります。
```
gitlab_rails['backup_path'] = "/tmp/backups"
```
結果のファイルを保存します。nano を使用している場合は、control-x を押すことで保存できます。
変更を適用するために再設定します。
```
sudo gitlab-ctl reconfigure
```

GitLab インスタンスのフルバックアップを取得します。
```
sudo gitlab-backup create
```
本番環境では、/etc/gitlab/gitlab.rb と /etc/gitlab/gitlab-secrets.json のコピーも取得する必要があります。
バックアップが完了したら、バックアップの場所に移動してバックアップファイルを確認します。
```
sudo ls /tmp/backups
sudo tar -tvf /tmp/backups/<backup_filename>
```

GitLab インスタンスサーバーの SSH セッションに戻ります。
バックアップファイルをリストアの実行に GitLab が必要とする場所に移動します。
```
sudo cp /tmp/backups/<backup_filename> /var/opt/gitlab/backups/
```
リストアを実行するためのバックアップファイルに正しいパーミッションがあることを確認します。
```
sudo chown git:git /var/opt/gitlab/backups/<backup_filename>
```

リストアの前に puma と sidekiq サービスを停止します。

sudo gitlab-ctl stop puma
sudo gitlab-ctl stop sidekiq
sudo gitlab-ctl status

バックアップからリストアします。<backup_timestamp> を -ee を含むバックアップファイル名の一部に置き換えます。例えば、バックアップファイル名が 1663207732_2022_09_15_15.3.3-ee で始まる場合、コマンドは sudo gitlab-backup restore BACKUP=1663207732_2022_09_15_15.3.3-ee になります。
```
sudo gitlab-backup restore BACKUP=<backup_timestamp>
```
リストア操作中にプロンプトが表示されたら、yes と入力します。エラーメッセージのように見える出力が表示される場合があります。これは正常です。
authorized_keys ファイルの再構築を求めるプロンプトが表示されたら、yes と入力します。

sidekiq と puma サービスを再起動します。

sudo gitlab-ctl start sidekiq
sudo gitlab-ctl start puma
sudo gitlab-ctl status

Web ブラウザーで GitLab を更新する前に最大 5 分待ちます。変更した最大添付ファイルサイズとデフォルトのプロジェクト制限が（バックアップ取得時の）デフォルト値に戻っていることを確認します。

このラボ演習を完了しました。このコースの他のラボガイドを参照できます。

ラボに変更を加えたい場合は、マージリクエストを通じて変更内容を送信してください。