現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動 情報
2023 年 10 月 25 日に、Apigee Edge for Private Cloud の新しいバージョンをリリースしました。
注: このバージョンは 2024 年 10 月 25 日までサポートされます。
更新手順
このセクションでは、Edge for Private Cloud の以前のリリースから更新する場合に、このリリースをインストールする方法について説明します。以前のリリースから更新する必要がある場合は、複数のパッチ バージョンを適用するをご覧ください。
このリリースを更新すると、以下の RPM リストのコンポーネントが更新されます。
- edge-gateway-4.52.00-0.0.60200.noarch.rpm
- edge-management-server-4.52.00-0.0.60200.noarch.rpm
- edge-message-processor-4.52.00-0.0.60200.noarch.rpm
- edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
- edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
- edge-router-4.52.00-0.0.60200.noarch.rpm
- apigee-sso-4.52.00-0.0.21316.noarch.rpm
- edge-analytics-4.52.00-0.0.40100.noarch.rpm
- edge-management-ui-4.52.00-0.0.20029.noarch.rpm
- edge-ui-4.52.00-0.0.20233.noarch.rpm
- apigee-service-4.52.00-0.0.1500.noarch.rpm
- apigee-mirror-4.52.00-0.0.1032.noarch.rpm
- apigee-tomcat-9.0.82-0.0.939.noarch.rpm
- apigee-configutil-4.52.00-0.0.624.noarch.rpm
インストールされている RPM のバージョンを確認して、更新が必要かどうかを確認するには、次のコマンドを入力します。
apigee-all version
インストールを更新するには、Edge ノードで次の手順を実施します。
-
すべての Edge ノードの場合:
- Yum リポジトリをクリーンアップします。
sudo yum clean all
- 最新の Edge 4.52.00
bootstrap_4.52.00.shファイルを/tmp/bootstrap_4.52.00.shにダウンロードします。curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Edge 4.52.00
apigee-serviceユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
ここで、uName と pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、パスワードの入力を求められます。
sourceコマンドを使用して、apigee-service.sh スクリプトを実行します。source /etc/profile.d/apigee-service.sh
- Yum リポジトリをクリーンアップします。
- すべての Edge ノードで、エッジプロセスの
update.shスクリプトを実行します。/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- すべてのノードで SSO の
update.shスクリプトを実行します。 - すべての UI ノードで、UI の
update.shスクリプトを実行します。/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- New Edge エクスペリエンスを使用している場合は、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
セキュリティの問題を修正しました
このリリースで修正された既知のセキュリティ問題の一覧を次に示します。これらの問題を回避するには、Edge for Private Cloud の最新バージョンをインストールしてください。| 問題 ID | 説明 |
|---|---|
| 279065506 | OAuth2 のリダイレクト URL では、クロスサイト リクエスト フォージェリ（CSRF）の脆弱性を回避するため、状態パラメータのエントロピーが予測不能に改善されています。", |
| 279065586 | ヘッダーにコンテンツ セキュリティ ポリシーを追加し、クライアント側の攻撃からサイトのセキュリティを強化しました。 |
サポートされているソフトウェアの変更
次のソフトウェア バージョンのサポートが追加されました。
- Red Hat Enterprise Linux（Intel 64 ビット）: バージョン 8.8
- Oracle Linux（Intel 64 ビット）: バージョン 7.9、8.7、8.8
- Rocky Linux 8
- Tomcat 9.0.82
サポートされているソフトウェアの一覧については、 Edge for Private Cloud でサポートされているソフトウェアをご覧ください。
非推奨と廃止
このリリースでは、新しい非推奨化や廃止はありません。
新機能
このリリースでは、次の新機能が導入されています。
組織名と環境名の最大文字数を設定する
このリリースでは、新しい組織または環境を作成するときに、組織名と環境名の最大文字数を制限できます。最大文字数のデフォルト値は 255 です。最大値を小さくするには、それぞれのプロパティ ファイルで次のプロパティを設定します。
- 組織のプロパティ ファイルで
org.name.max.lengthを設定します。 - 組織のプロパティ ファイルで、
env.name.max.lengthを設定します。
これらのプロパティのいずれかが 0 より小さい値または 255 より大きい値に設定されている場合、システムはそれぞれ 1 または 255 の最大値を使用します。
アクセス トークンの有効期限を設定する
このリリースでは、プロパティ conf_keymanagement_oauth_access_token_expiry_time_in_millis を目的の有効期限（ミリ秒単位）に設定することで、アクセス トークンの有効期限を設定できます。この機能はデフォルトでは無効になっています。有効にするには、Message Processor で conf_keymanagement_oauth_access_token_is_apply_limit を true に設定します。
この機能により、Apigee 管理者は Apigee で作成されたアクセス トークンの有効期限をより細かく制御できます。
バグの修正
このセクションでは、このリリースで修正された Private Cloud のバグについて説明します。
| 問題 ID | 説明 |
|---|---|
| 290242749 |
DataMasking で |
| 260397807 |
メール テンプレートでの問題により、メールでマルチバイト文字を送信できない。 この問題は修正済みです。 |
| 234544436 |
新しい Edge UI で組織を変更すると左側のメニューが消える問題を修正しました。 この問題は修正済みです。 |
| 293268203 |
管理サーバー ノードでアナリティクスの依存関係が自動的にアップグレードされませんでした。 この問題は解決しました。 |
| 261616264 |
アップグレード プロセス中に postgresql が削除されないように、ブートストラップ チェックを追加。 |
| 279065586 |
OAuth2 のリダイレクト URL で、クロスサイト リクエスト フォージェリ（CSRF）の脆弱性を回避するため、状態パラメータのエントロピーが改善され、予測不能になりました。 |
| 283310836 |
大規模な XML の解析時のエラー メッセージを改善しました。 |
| 245936798 |
組織名と環境名に関する問題により、Postgresql <code<create< code="" dir="ltr" translate="no"> query が失敗していました。</code<create<> この問題は、長い組織名と環境名の PostgreSQL インデックス名の競合の処理を改善することで修正されました。 |
| 293733533 |
Edge Gateway コンポーネントの Spring サードパーティ ライブラリがバージョン 5.3.20 からバージョン 5.3.27 に更新されました。 |
| 294363158 |
リグレッションにより、Edge UI の分析ページとモニタリング ページのプルダウン メニューに余分なディメンションが表示されていました。 この問題は修正済みです。 |
| 297889765 |
apigee-mirror によって生成されたアーティファクトに正しい所有権が付与されるようになりました。 |
| 294989027 |
特定の Stats API のパフォーマンスを改善。 |
既知の問題
既知の問題の一覧については、Edge for Private Cloud の既知の問題をご覧ください。
複数のパッチ バージョンの適用
このセクションでは、以前のパッチ リリース バージョンより前の Edge for Private Cloud のバージョンから更新する場合に、複数のパッチ バージョンを適用する方法について説明します。
各パッチ リリースには、edge-management-server などの Edge for Private Cloud の特定のコンポーネントの更新が含まれています。複数のパッチ バージョンを適用するには、パッチリリースに含まれる各 Edge コンポーネントを、現在インストールされているバージョンより後に更新する必要があります。これらのコンポーネントは、現在のバージョンより後のすべてのバージョンの Edge for Private Cloud リリースノートを確認し、それらのリリースの RPM リストを確認することで確認できます。すべての Edge for Private Cloud リリースノートへのリンクについては、Apigee リリースノートをご覧ください。
注: パッチ リリースに含まれているコンポーネントの最新バージョンの RPM をインストールすることで、各コンポーネントを更新する必要があるのは 1 回だけです。そのバージョンのリリースノートの手順に沿ってコンポーネントを更新します。
注: コンポーネントをアップグレードすると、コンポーネントの最新のパッチ バージョンが自動的にインストールされます。最新ではないパッチ バージョンにアップグレードする場合は、Apigee ミラーを使用して Apigee リポジトリの独自の tarball コピーを維持し、このミラーを Apigee のインストールに使用する必要があります。詳細については、 ローカル Edge リポジトリを使用した Edge バージョンの管理をご覧ください。