カスタムエディションのオンラインアップグレード

オンラインで編集

カスタムエディションは、 kubectl プラグインを使用してオンラインでアップグレードできます。

Instana の kubectl プラグインと Instana のEnterpriseオペレーターは常に同時にリリースされます。 Instana バックエンドの更新は、 Instana Enterpriseオペレーターのリリースとは独立しています。

Instana kubectl プラグインを使用して、サポートされている Instana バックエンドのバージョンを確認し、必要に応じてバックエンドを更新できます。

アップグレードに関するリリース固有の要件については、 アップグレードに関する注意事項を参照してください。

前提条件

オンラインで編集

Instana をアップグレードする前に、以下の前提条件が満たされていることを確認してください：

  • クラスターには十分な容量があります。 クラスターのリクエスト容量が限界に近づいている場合、ポッドが待機状態に留まるのを防ぐため、追加のノードを追加してください。
  • Elasticsearch ノードには十分なディスク容量があります。 ディスク使用率が80%を超えると、 Elasticsearch ノードは自動的に読み取り専用モードに切り替わり、アップグレードが停止したり、黙って失敗したりする可能性があります。

手順

オンラインで編集

カスタムエディションをオンラインでアップグレードするには、次の手順を完了してください：

  1. データストアのバージョンが、アップグレード先の Instana バージョンと互換性があるかどうかを確認してください。 データストアのバージョンについては、 「サードパーティ製データストアオペレーターのアップグレード」 を参照してください。

  2. データストアのバージョンが互換性がない場合は、データストアをアップグレードしてください。 データストアのアップグレードについては、 「サードパーティ製データストアオペレーターのアップグレード」 を参照してください。

  3. Instana エンタープライズオペレーターのアップグレード

    1. 対象バージョンの Instana プラグイン（ kubectl ）をインストールしてください。 Instana の kubectl プラグインと Instana のEnterprise Operatorはバージョン管理が連動しています。そのため、インストールするOperatorのバージョンに一致するプラグインバージョンをインストールしてください。 詳細については、 「 Instanakubectl プラグインのインストール」 を参照してください。

    2. 新しい演算子が適用されるオペレータを、デフォルトの Instana バックエンドバージョンでアップグレードします。 マニフェストの直接適用を参照してください。

      • 新しい YAML マニフェストを適用または生成することを確認してください。 既存の YAML マニフェスト内のイメージバージョンを直接更新しないでください。 既存の YAML マニフェストでイメージバージョンを更新すると、 CustomResourceDefinition （CRD）の更新やその他の変更を見逃す可能性があり、予期せぬエラーが発生する恐れがあります。

      • 特定のバージョンにアップグレードするには、追加の操作が必要になる場合があります。 アップグレードに関する注意事項を参照してください。 リリースをスキップする場合は、必ずアップグレードノート（スキップしたバージョンと対象バージョンのアップグレードノートを含む）を確認してください。

  4. Instana のバックエンドをアップグレードする:

    注記: ビルド 1.0.0 以降では、新バージョンがリリースされた際に Instana バックエンドをアップグレードできます。 すべてのコマンドにはオプションの --download-key フラグがあります。 フラグを指定しない場合、既存のインストールのダウンロードキーが使用されます。

    1. インストール済みのカスタムエディションと互換性のある、利用可能な Instana バックエンドのバージョンを確認してください。

      kubectl-instana versions identify

    2. バックエンドのバージョンを更新する。 次のステップのいずれかを実行します。

      • アップグレードするバージョンを選択してください：

        kubectl-instana versions update

        サポートされているすべてのアップグレードバージョンが表示されます。 バージョンを選択できます。

      • アップグレードするバージョンを指定してください：

        kubectl-instana versions update --instana-version 3.xxx.xxx-0

        あるいは、コア仕様でアップグレード先のバックエンドバージョンを設定し、以下の例のように仕様を適用することもできます。

        ...
spec:
  imageConfig:
    tag: 3.xxx.xxx-0
...

    3. Instana バックエンドのアップグレードを確認する:

      kubectl get core -n instana-core
 
      kubectl get units -n instana-units