---
schema_version: "1"
id: df80de8321842c017d1bae6e613dd0997d9339290483e7ca1a79e073fd291cb4
title: ポリシーと API プロキシのための Java のアップグレード
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/general/upgrade-policies-proxies.md
canonical_url: https://docs.mulesoft.com/jp/general/upgrade-policies-proxies
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 10e1eb552cf97b56d6e96bb3829ceb2b123de832efe9f349a722d8a4de4365af
description: MuleSoft Documentation Site
latest: true
---
# ポリシーと API プロキシのための Java のアップグレード

Java 8 および 11 の標準サポートは Mule 4.8 Edge では 2025 年 3 月、4.6 LTS では 2026 年 2 月に終了します。Java 8 または 11 上で実行中のアプリケーションのアップグレードパスを計画します。

ポロシーと API プロキシをアップグレードして、Java 17 と互換性があるものにします。

## [](#upgrading-automated-policies)自動ポリシーのアップグレード

自動ポリシー (内部およびカスタム) を Java 17 にアップグレードします。

### [](#upgrading-included-automated-policies)内部自動ポリシーのアップグレード

自動化された ​[MuleSoft 内部ポリシー](https://docs.mulesoft.com/jp/mule-gateway/policies-included-directory)​を Java 17 にアップグレードする手順は、次のとおりです。

1. API Manager で、​**\[Automated Policies (自動ポリシー)\]**​ に移動します。
2. **\[Policy version (ポリシーバージョン)\]**​ で、内部ポリシーの最新バージョンを選択します。
3. **\[Rule of application (適用のルール)\]**​ で、次の手順を実行します。
    
    - ポリシーが最新バージョンに基づく場合:
        
        - 内部ポリシーをすべての Mule Runtime に適用するには、​**\[All runtimes (すべてのランタイム)\]**​ を選択して ​**\[Apply (適用)\]**​ をクリックします。
        - 内部ポリシーを Flex Gateway のみに適用するには、​**\[Flex gateways only (Flex Gateway のみ)\]**​ を選択して ​**\[Apply (適用)\]**​ をクリックします。
        - 内部ポリシーを Mule Gateway のみに適用する手順は、次のとおりです。
            
            1. **\[Mule gateways only (Mule ゲートウェイのみ)\]**​ を選択します。
            2. **\[From version (開始バージョン)\]**​ と ​**\[To (終了バージョン)\]**​ に Mule バージョンの範囲を入力します。
            3. **\[Java Versions (Java バージョン)\]**​ で、​**\[All Java versions (すべての Java バージョン)\]**​ または ​**\[Choose specific Java versions (特定の Java バージョンを選択)\]**​ を選択します。
            4. **\[Apply (適用)\]**​ をクリックします。
    - ポリシーが最新バージョンに基づいていない場合:
        
        - 内部ポリシーをすべての Mule Runtime に適用するには、​**\[All runtimes (すべてのランタイム)\]**​ を選択して ​**\[Apply (適用)\]**​ をクリックします。
        - 内部ポリシーを Flex Gateway のみに適用するには、​**\[Flex gateways only (Flex Gateway のみ)\]**​ を選択して ​**\[Apply (適用)\]**​ をクリックします。​**\[Rule of application (適用のルール)\]**​ セクションは最新バージョンの ​**\[Rule of application (適用のルール)\]**​ セクションと同じである必要があります。同じでない場合、API が保護されない可能性があります。
        - 内部ポリシーを Mule Gateway のみに適用する手順は、次のとおりです。
            
            1. **\[Mule gateways only (Mule ゲートウェイのみ)\]**​ を選択します。
            2. **\[From version (開始バージョン)\]**​ と ​**\[To (終了バージョン)\]**​ に Mule バージョンの範囲を入力します。
            3. **\[Java versions (Java バージョン)\]**​ で、​**\[Choose specific Java versions (特定の Java バージョンを選択)\]**​ を選択し、Java 8 と Java 11 を選択します。
            4. **\[Apply (適用)\]**​ をクリックします。
            5. **\[Add automated policy (自動ポリシーを追加)\]**​ をクリックし、同じ自動ポリシーを追加します。
            6. **\[Advanced options (詳細オプション)\]**​ をクリックします。
            7. **\[Mule gateways only (Mule ゲートウェイのみ)\]**​ を選択します。
            8. **\[From version (開始バージョン)\]**​ と ​**\[To (終了バージョン)\]**​ に Mule バージョンの範囲を入力します。
            9. **\[Java versions (Java バージョン)\]**​ で、​**\[Choose specific Java versions (特定の Java バージョンを選択)\]**​ を選択し、Java 17 を選択します。
            10. **\[Apply (適用)\]**​ をクリックします。

### [](#upgrading-custom-automated-policies)カスタム自動ポリシーのアップグレード

カスタム自動ポリシーを Java 17 にアップグレードする手順は、次のとおりです。

1. API Manager で、​**\[Automated Policies (自動ポリシー)\]**​ に移動します。
2. 必要な拡張機能とコネクタを Java 17 にアップグレードします。
    
    - カスタムポリシーに Anypoint Connector がある場合は、​[「Anypoint Connector およびモジュールのアップグレード」](https://docs.mulesoft.com/jp/general/java-support#anypoint-connectors-and-modules)​を参照してください。
    - カスタムポリシーにカスタムコネクタがある場合は、​[「カスタムコネクタのアップグレード」](https://docs.mulesoft.com/jp/general/java-support#custom-connectors)​を参照してください。
3. [カスタムポリシーをアップグレードします](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-java-version)​。
4. [カスタムポリシーをパッケージ化します](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-package)​。
    
    Java 17 をローカルで設定して、カスタムポリシーを Java 17 と互換性があるものにします。
5. [カスタムポリシーを Exchange に再パブリッシュします](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-upload-to-exchange)​。
6. Java 17 と互換性のあるカスタムポリシーの新しいバージョンを API インスタンスに適用します。
    
    1. **\[Policies (ポリシー)\]**​ に移動します。
    2. **\[Applied policy status (適用されたポリシーの状況)\]**​ で、最新の定義が適用されていることを確認します。
        
        - 最新の定義が適用されている場合、\[More (その他)\] (…​) メニューをクリックして ​**\[Check for implementation updates (実装の更新を確認)\]**​ を選択します。
        - 最新の定義が適用されていない場合、最新の定義に更新します。

## [](#upgrading-api-level-policies)API レベルのポリシーのアップグレード

API レベルのポリシー (内部およびカスタム) を Java 17 にアップグレードします。

### [](#upgrading-included-api-level-policies)API レベルの内部ポリシーのアップグレード

API レベルの ​[MuleSoft 内部ポリシー](https://docs.mulesoft.com/jp/mule-gateway/policies-included-directory)​を Java 17 にアップグレードする手順は、次のとおりです。

1. API Manager で、​**\[API Administration (API 管理)\]**​ > ​**{API 参照名}**​ > ​**\[Policies (ポリシー)\]**​ > ​**\[Add a policy (ポリシーを追加)\]**​ に移動して、個々の API レベルで​[ポリシーを適用](https://docs.mulesoft.com/jp/mule-gateway/policies-included-apply)​します。
2. API レベルの各ポリシーをアップグレードする手順は、次のとおりです。
    
    1. **\[Policy version (ポリシーバージョン)\]**​ で、内部ポリシーの最新バージョンを選択します。
    2. **\[Method & resource conditions (メソッドとリソースの条件)\]**​ で、​**\[Apply configuration to all API method & resources (設定をすべての API メソッドおよびリソースに適用)\]**​ または ​**\[Apply configuration to specific API method & resources (設定を特定の API メソッドおよびリソースに適用)\]**​ を選択します。
    3. **\[Apply (適用)\]**​ をクリックします。

### [](#upgrading-custom-api-level-policies)API レベルのカスタムポリシーのアップグレード

API レベルのカスタムポリシーを Java 17 にアップグレードする手順は、次のとおりです。

1. API Manager で、​**\[API Administration (API 管理)\]**​ > ​**{API 参照名}**​ > ​**\[Policies (ポリシー)\]**​ > ​**\[Add a policy (ポリシーを追加)\]**​ に移動して、個々の API レベルで​[ポリシーを適用](https://docs.mulesoft.com/jp/mule-gateway/policies-included-apply)​します。
2. 必要な拡張機能とコネクタを Java 17 にアップグレードします。
    
    - カスタムポリシーに Anypoint Connector がある場合は、​[「Anypoint Connector およびモジュールのアップグレード」](https://docs.mulesoft.com/jp/general/java-support#anypoint-connectors-and-modules)​を参照してください。
    - カスタムポリシーにカスタムコネクタがある場合は、​[「カスタムコネクタのアップグレード」](https://docs.mulesoft.com/jp/general/java-support#custom-connectors)​を参照してください。
3. [カスタムポリシーをアップグレードします](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-java-version)​。
4. [カスタムポリシーをパッケージ化します](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-package)​。
    
    Java 17 をローカルで設定して、カスタムポリシーを Java 17 と互換性があるものにします。
5. [カスタムポリシーを Exchange に再パブリッシュします](https://docs.mulesoft.com/jp/mule-gateway/policies-custom-upload-to-exchange)​。
6. Java 17 と互換性のあるカスタムポリシーの新しいバージョンを API インスタンスに適用します。
    
    1. **\[Policies (ポリシー)\]**​ に移動します。
    2. **\[Applied policy status (適用されたポリシーの状況)\]**​ で、最新の定義が適用されていることを確認します。
        
        - 最新の定義が適用されている場合、\[More (その他)\] (…​) メニューをクリックして ​**\[Check for implementation updates (実装の更新を確認)\]**​ を選択します。
        - 最新の定義が適用されていない場合、最新の定義に更新します。

## [](#upgrading-api-proxies)API プロキシのアップグレード

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">アップグレード時に API プロキシまたは Mule アプリケーションを確実に保護するには、API プロキシまたは Mule アプリケーションをアップグレードする​<strong>前</strong>​に API ポリシーをアップグレードしてください。</td></tr></tbody></table>

アップグレードの手順は、​**\[Proxy type (プロキシ種別)\]**​ によって若干異なります。

- 基本エンドポイント:
    
    - 基本エンドポイントを使用する場合は、適合したアプリケーションを Mule Runtime からサーバーにデプロイし、自動検出を使用して API Manager に接続します。詳細は、​[「Mule 4 アプリケーションでの Mule ゲートウェイの API 自動検出の設定」](https://docs.mulesoft.com/jp/mule-gateway/mule-gateway-config-autodiscovery-mule4)​を参照してください。
    - 基本エンドポイント API インスタンスを使用してインスタンスを更新する場合は、API インスタンスに接続している Mule アプリケーションを更新します。
- プロキシアプリケーションを使用する場合、デプロイメント種別に応じて次のセクションを参照してください。
    
    - [CloudHub および CloudHub 2.0 デプロイメント](#cloudhub-and-cloudhub2-deployments)
    - [ハイブリッドデプロイメント](#hybrid-deployments)
    - [Runtime Fabric デプロイメント](#runtime-fabric-deployments)

### [](#cloudhub-and-cloudhub2-deployments)CloudHub および CloudHub 2.0 デプロイメント

この手順を実行する前に、ポリシーが更新されていることを確認してください。詳細は、​[自動ポリシーのアップグレード](#upgrading-automated-policies)​および​[API レベルのポリシーのアップグレード](#upgrading-api-level-policies)​を参照してください。

1. API Manager で、​**\[API Administration (API 管理)\] > \[Settings (設定)\]**​ に移動します。
2. [API インスタンスの設定を編集します](https://docs.mulesoft.com/jp/api-manager/latest/edit-api-endpoint-task)​。
    
    1. **\[Runtime Channel (ランタイムチャネル)\]**​ で、使用するランタイムチャネルを選択します。
    2. **\[Version (バージョン)\]**​ で、​**\[4.6.0\]**​ またはそれ以上を選択します。
    3. **\[Java version (Java バージョン)\]**​ で、​**\[Java 17\]**​ を選択します。
3. **\[Save & Apply (保存して適用)\]**​ をクリックします。

### [](#hybrid-deployments)ハイブリッドデプロイメント

この手順を実行する前に、ポリシーが更新されていることを確認してください。詳細は、​[自動ポリシーのアップグレード](#upgrading-automated-policies)​および​[API レベルのポリシーのアップグレード](#upgrading-api-level-policies)​を参照してください。

1. Mule Runtime Rngine 4.6.x を、Java 17 で実行される新しいサーバーにデプロイし、サーバーを開始します。詳細は、[Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)を参照してください。
2. Java 17 で実行される、作成した新しい対象を選択し、API Manager で ​**\[API Administration (API 管理)\] > \[Settings (設定)\]**​ に移動します。
3. [API インスタンスの設定を編集します](https://docs.mulesoft.com/jp/api-manager/latest/edit-api-endpoint-task)​。
    
    1. **\[Select target (対象を選択)\]**​ で、Java 17 で実行されているサーバーを対象として選択します。
4. **\[Save & Apply (保存して適用)\]**​ をクリックします。
5. サーバーが Java 17 で正常に実行されたら、ロードバランサーを使用してトラフィックを新しいサーバーに段階的に移行し、すべてのアプリケーションが移行されたら古いサーバーをオフにします。

### [](#runtime-fabric-deployments)Runtime Fabric デプロイメント

この手順を実行する前に、ポリシーが更新されていることを確認してください。詳細は、​[自動ポリシーのアップグレード](#upgrading-automated-policies)​および​[API レベルのポリシーのアップグレード](#upgrading-api-level-policies)​を参照してください。

1. Mule Runtime Rngine 4.6.x を、Java 17 で実行される新しいサーバーにデプロイし、サーバーを開始します。詳細は、[Deploying API Proxies to Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/proxy-deploy-runtime-fabric)を参照してください。
2. Java 17 で実行される、作成した新しい対象を選択し、API Manager で ​**\[API Administration (API 管理)\] > \[Settings (設定)\]**​ に移動します。
3. [API インスタンスの設定を編集します](https://docs.mulesoft.com/jp/api-manager/latest/edit-api-endpoint-task)​。
    
    1. **\[Runtime Channel (ランタイムチャネル)\]**​ で、使用するランタイムチャネルを選択します。
    2. **\[Version (バージョン)\]**​ で、​**\[4.6.0\]**​ またはそれ以上を選択します。
    3. **\[Java version (Java バージョン)\]**​ で、​**\[Java 17\]**​ を選択します。
4. **\[Save & Apply (保存して適用)\]**​ をクリックします。
5. サーバーが Java 17 で正常に実行されたら、ロードバランサーを使用してトラフィックを新しいサーバーに段階的に移行し、すべてのアプリケーションが移行されたら古いサーバーをオフにします。

## [](#関連情報)関連情報

- [Java サポート](https://docs.mulesoft.com/jp/general/java-support)