SaltStack Config のアップグレード方法

SaltStack Config を以前のバージョンから最新の安定したバージョンにアップグレードします。

注：

問題のある用語を取り除くという VMware の取り組みの一環として、SaltStack Config とその関連製品およびドキュメントで使用されている Salt マスターという用語は、より適切な用語に置き換えられます。この用語の更新が完全に完了するのは、いくつかのリリースサイクル後になる可能性があります。

SaltStack Config をアップグレードするには、次の手順を実行する必要があります。

SaltStack Config の特定のインストールに不可欠な特定のファイルやディレクトリなどのデータをバックアップする
PostgreSQL をアップグレードする（オプション、推奨）
Salt インフラストラクチャをアップグレードする（オプション、推奨）
アップグレードファイルをダウンロードする
RaaS ノードのアップグレード
マスタープラグインを使用してすべての Salt マスターをアップグレードする

アップグレードするときのベストプラクティス

アップグレードの計画時には、以下のガイドラインに従ってください。

[インストーラまたは手動のインストール手順を使用してアップグレードしない。]SaltStack Config インストールをアップグレードする場合は、次のアップグレード手順を参照してください。
[最適な結果を得るために、1 つのメジャーリリースから次のメジャーリリースに順番にアップグレードする。]ベストプラクティスとして、必ず SaltStack Config の最新のメジャーバージョンから新しいリリースにアップグレードしてください。古いリリースを使用している場合は、1 つのリリースから次のリリースに順番にアップグレードします。
[データをバックアップする。]データの損失を防ぐために、データをバックアップします。アップグレード前にバックアップする必要があるファイルとディレクトリの説明については、データのバックアップを参照してください。
[ネットワークアクティビティが低い時間帯にアップグレードを実行する。]データベースのアップグレードには、データの再インデックス化が必要です。データの複雑さによっては、データベースのアップグレードに数時間かかる場合があります。サービスの中断を防ぐには、ビジネス活動が低下する時間帯にデータベースをアップグレードするか、アップグレードの前にデータベースをトリミングしてください。
[データベースに古いコマンドが保存されているかどうかを確認する。]PostgreSQL データベースには、実行されていない古いコマンドが保存されている場合があります。これらのコマンドは、アップグレード中に、マスタープラグインを再起動するときに実行される場合があります。この問題を回避するには、データベースに古いコマンドが保存されているかどうかを確認し、定義された時間より古いジョブのスキップを有効にします。
[展開前にアップグレードをテストする。]可能であれば、テスト環境でリハーサルを実行してみることで、アップグレードにかかる時間を把握できます。
[まず、ガイドを通読する。]アップグレードの実装前に、このガイドを 1 度通読することも検討してください。必要なタスクの理解、チームでの計画の必要性、関係者への保留中の変更についての通知の必要性などを判断できます。

古いバージョンからのアップグレード

ベストプラクティスとして、必ず SaltStack Config の最新のメジャーバージョンから新しいリリースにアップグレードしてください。最新リリースよりも前のバージョンからアップグレードする場合は、1 つのメジャーリリースから次のメジャーリリースに順番にアップグレードすることで最適な結果が得られる場合があります。

以前のバージョンの SaltStack Config にアップグレードする手順については、アップグレード元のリリースに固有のアップグレード手順を参照してください。以前のリリースのアップグレード手順は、以降のリリースのインストールガイド PDF に記載されています。たとえば、5.5 から 6.0 にアップグレードする必要がある場合は、6.0 のインストール PDF に記載されているアップグレード手順を参照してください。

SaltStack Config バージョン 8.4 以降の場合は、このページの上部にあるバージョンセレクタを使用して、お使いの製品バージョンに適したアップグレードガイドを選択します。バージョン 8.3 以前の場合は、次の表の PDF ガイドを使用します。


バージョン	インストールおよびアップグレードガイド (PDF)
8.3	8.3 インストールおよびアップグレードガイド
6.4	6.4 インストールおよびアップグレードガイド
6.3	6.3 インストールおよびアップグレードガイド
6.2	6.2 インストールおよびアップグレードガイド
6.1	6.1 インストールおよびアップグレードガイド
6.0.1	6.0.1 インストールおよびアップグレードガイド
6.0	6.0 インストールおよびアップグレードガイド