オペレーションのアップグレード

以下は、GitLab Operatorをアップグレードする手順です。

アップグレードする前に、バックアップを実行することを強くお勧めします。

ステップ1: 最新のChartバージョンへのアップグレード

オペレーションをアップグレードする前に、GitLabアップグレードガイドに従って、現在のGitLabインスタンスが利用可能な最新のChartバージョンにアップグレードされていることを確認してください。これらのバージョンは、Version mapping の見出しの下にあるリリースページに概説されています。

例えば、現在のOperatorのバージョンがリリース0.4.0の場合、利用可能なChartのアップグレードを_順番に_実行してください： 5.5.3 ->5.6.3 ->5.7.0.

ステップ 2: 必要なオペレータ バージョンの特定

GitLab Operatorの利用可能なバージョンの完全なリストについては、リリースページを参照してください。

例えば、現在のOperatorのバージョンがリリース0.4.0の場合、リリース0.4.1にアップグレードすることができます。

ステップ 3: 目的のバージョンのインストール

次のステップでは、kubectl を使用して Operator の希望するバージョンのマニフェストを適用します。

VERSION=X.Y.Z
kubectl apply -f \
  https://gitlab.com/api/v4/projects/18899486/packages/generic/gitlab-operator/${VERSION}/gitlab-operator-kubernetes-${VERSION}.yaml

このコマンドは、使用する新しいデプロイメント イメージを含む、関連するマニフェストへの変更を適用します。

ステップ 4: オペレータの新しいバージョンがリーダーになることを確認します。

Operatorデプロイは、この変更で新しいReplicaSetを作成し、新しいOperatorポッドを生成します。一方、以前のOperatorポッドはシャットダウンし、リーダーの地位を放棄します。そうなると、新しいOperatorポッドがリーダーになります。

ステップ5: GitLabカスタムリソースのChartバージョンを更新します。(CR)

ほとんどの場合、利用可能なチャートのバージョンは、Operatorのバージョン間で同一ではありません。新しいバージョンのOperatorが起動すると、既存のGitLab Custom Resource(CR)を照合しようとします。次のようなエラーが表示される可能性があります：

Configuration error detected: chart version 5.7.0 not supported; please use one of the following: 5.7.1, 5.6.4, 5.5.4

このアドレスに対処するには、そのリリースの利用可能なChartバージョンから有効なバージョンを特定してください。

5.7.1例: オペレーター0.4.0 から0.4.1にアップグレードする場合、GitLab CR を5.7.0 に最も近い利用可能なチャートバージョンに更新してください。

ステップ 6: Operator が期待通りに GitLab を照合することを確認します。

新しい Operator ポッドのログを見てください。定義したChartバージョンへのアップグレードが実行されていることが確認できるはずです。

アップグレードが成功したことを確認するには、GitLab CR のステータスを取得します：

$ kubectl get gitlabs -n gitlab-system
NAME     STATUS    VERSION
gitlab   Running   5.7.1

ステータスRunning は、Operator がインスタンスへの変更を照合できたことを意味します。バージョンは、Operator のアップグレード後に指定された Chart バージョンと一致する必要があります。

エラーに気づいた場合は、まず当社のトラブルシューティング・ドキュメントを参照してください。そこに答えが記載されていない場合は、既存のイシューを確認するか、当社のイシュー・トラッカーで新しいイシューを開いてください。

以下はGitLabのアップグレードに関連するリソースです。