Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第1章 3scale API Management Operator ベースのアップグレードガイド: 2.15 から 2.16

Operator ベースのインストールで Red Hat 3scale API Management をバージョン 2.15 から 2.16 にアップグレードして、OpenShift 4.x で 3scale を管理できるようにします。

3scale のマイクロリリースを自動的に取得するには、自動更新が有効であることを確認してください。Oracle 外部データベースを使用している場合は、自動更新を設定しないでください。これを確認するには、マイクロリリースの自動アプリケーションの設定 を参照してください。

重要

必要な条件および手順を理解するために、記載の手順を適用する前に、アップグレードガイド全体を読んでください。アップグレードプロセスの手順が完了するまで、サービスの提供が中断されます。このサービス中断が生じるため、メンテナンス期間を設けるようにしてください。

1.1. アップグレードを行うための前提条件
リンクのコピー

重要

3scale Operator で証明書の検証の失敗を解決するには、影響を受けるカスタムリソース (CR) に 証明書の検証をスキップ するアノテーションを追加します。このアノテーションは、作成時に CR に適用するか、または既存の CR に追加できます。適用すると、エラーが調整されます。

このセクションでは、Operator ベースのインストール環境で 3scale を 2.15 から 2.16 にアップグレードするのに必要な設定を説明します。

  • OpenShift Container Platform (OCP) 4.12、4.14、4.16、4.17、4.18、4.19 または 4.20 クラスターおよびその管理者アクセスOCP 環境がバージョン 4.12 以上にアップグレードされていることを確認します。これは、3scale の更新を続行するための最小要件です。
  • 3scale Operator によりデプロイされている 3scale 2.15

  • threescale-2.15 チャネルの最新 CSV が使用されていることを確認します。この点を確認するには、以下を行います。

    • サブスクリプションの承認設定が automatic の場合は、すでにチャネルの最新 CSV バージョンになっているはずです。
    • サブスクリプションの承認設定が manual の場合、保留中のすべての InstallPlans を承認し、最新の CSV バージョンになっていることを確認してください。
    • 保留中のインストールプランがある場合、さらに保留中のインストールプランがある可能性があり、既存の保留中のプランがインストールされた後にのみ表示されることに注意してください。

1.1.1. 外部データベースの要件
リンクのコピー

3scale 2.16 では内部データベースはサポートされておらず、Operator によって管理されません。唯一の例外は、引き続き内部コンポーネントとして使用できる Zync データベース (zync-database デプロイメント) です。

2.16 にアップグレードする前に、3scale インストールで使用されるすべてのデータベースが Operator によって 管理されていない ことを確認してください。- システムデータベース - MySQL、PostgreSQL、または Oracle (system-database シークレットで設定) - Backend Redis (backend-redis シークレットで設定) - System Redis (system-redis シークレットで設定)

重要

アップグレードを続行する前に、データベースのバージョンが 3scale 2.16 でサポートされていることを確認してください。詳細は、コンポーネントと最小バージョン要件 を参照してください。

内部データベースを使用している場合は、最初に 2.16 のデータベースの外部化 の手順に従って、それらを外部データベースに移行します。

1.1.2. 3scale API Management 2.16 事前チェック
リンクのコピー

Operator を使用して 3scale 2.16 をインストールする前に、データベースコンポーネントが最小バージョン要件を満たしていることを確認してください。この事前チェックは、アップグレード中に 3scale インスタンスが破損することを防ぐために重要です。

重要
  • データベースがアップグレードされていない場合、3scale インスタンスは 2.16 にアップグレードされません。
  • 3scale 2.16 Operator が実行されているかどうかにかかわらず、データベースをアップグレードできます。Operator が実行されている場合は、10 分ごとにデータベースのバージョンがチェックされ、アップグレードプロセスが自動的にトリガーされます。アップグレード時に Operator が実行されていない場合、スケールバックされます。要件を確認してインストールを続行するには、これを実行する必要があります。

1.1.2.1. コンポーネントと最小バージョン要件
リンクのコピー

注記
  • Oracle Database はチェックされません。
  • 外部データベースを使用する Zync はチェックされません。

次のコンポーネントが指定されたバージョン以上であることを確認します。

システムアプリケーションコンポーネント:

  • MySQL: 8.0.0
  • PostgreSQL: 15.0

バックエンドコンポーネント:

  • Redis: 7.2 (インスタンスが 2 つ必要)

バージョン検証

  • MySQL のバージョンを確認します。 

    $ mysql --version

  • PostgreSQL のバージョンを確認します。 

    $ psql --version

  • Redis のバージョンを確認します。 

    $ redis-server --version

1.1.2.2. 要件を満たしていないデータベースのアップグレード
リンクのコピー

データベースのバージョンが最小要件を満たしていない場合は、次の手順を実行してください。

  1. 3scale 2.16 Operator をインストール します。

    • 2.16 Operator は、データベースのバージョンに関係なくインストールされています。

  2. データベースをアップグレードします。

    • 最小バージョン要件を満たすように、MySQL、PostgreSQL、または Redis をアップグレードします。
    • 注記: 各データベースのアップグレード手順は、公式ドキュメントを確認してください。

  3. 2.16 のアップグレードを再開します。

    • データベースがアップグレードされると、3scale 2.16 Operator が新しいバージョンを検出します。
    • その後、3scale 2.16 へのアップグレードプロセスが自動的に進行します。

これらの事前チェックを実行し、データベースコンポーネントが最新であることを確認することで、3scale 2.16 に移行できます。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る