Dockerインスタンスをアップグレードする

Dockerベースのインスタンスを、GitLabの以降のバージョンにアップグレードします。

前提条件

Dockerインスタンスをアップグレードする前に、まず必要な情報と手順を確認してください。

Dockerベースのインスタンスをアップグレードする

Dockerベースのインスタンスをアップグレードするには:

1. アップグレード中は、メンテナンスモードを有効にすることを検討してください。
2. 実行中のCI/CDパイプラインとジョブを一時停止します。
3. ターゲットのGitLabバージョンと同じバージョンにGitLab Runnerをアップグレードします。
4. GitLab自体を以下のいずれかの方法でアップグレードします:
   • Docker Engineを使用する。
   • Docker Composeを使用する。

アップグレード後:

1. 実行中のCI/CDパイプラインとジョブの一時停止を解除します。
2. 有効になっている場合は、メンテナンスモードをオフにします。
3. アップグレードヘルスチェックを実行します。

Docker Engineでアップグレードする

Docker Engineを使用してインストールされた GitLabインスタンスをアップグレードするには:

1. バックアップを作成します。最低限、データベースとGitLabシークレットファイルをバックアップしてください。

2. 実行中のコンテナを停止します。

   sudo docker stop gitlab

3. 既存のコンテナを削除します。

   sudo docker rm gitlab

4. 新しいイメージをプルします。

   GitLab Enterprise Edition

   sudo docker pull gitlab/gitlab-ee:<version>-ee.0

   GitLab Community Edition

   sudo docker pull gitlab/gitlab-ce:<version>-ce.0

5. GITLAB_HOME環境変数が定義されていることを確認してください。

   echo $GITLAB_HOME

6. 以前に指定したオプションを使用して、コンテナを再度作成します。

   sudo docker run --detach \
   --hostname gitlab.example.com \
   --publish 443:443 --publish 80:80 --publish 22:22 \
   --name gitlab \
   --restart always \
   --volume $GITLAB_HOME/config:/etc/gitlab \
   --volume $GITLAB_HOME/logs:/var/log/gitlab \
   --volume $GITLAB_HOME/data:/var/opt/gitlab \
   --shm-size 256m \
   gitlab/gitlab-ee:<version>-ee.0

初回実行時に、GitLabは自身を再構成し、アップグレードします。

Docker Composeでアップグレードする

Docker Composeを使用してインストールされた GitLabインスタンスをアップグレードするには:

1. バックアップを作成します。最低限、データベースとGitLabシークレットファイルをバックアップしてください。

2. docker-compose.ymlを編集して、プルするバージョンを変更します。

3. 最新リリースをダウンロードして、GitLabインスタンスをアップグレードします。

   docker compose pull
   docker compose up -d