すべてのプロダクト
Search

このプロダクト

    Microservices Engine:MSE Nacos 設定センターの統合

    ドキュメントセンター

    Microservices Engine:MSE Nacos 設定センターの統合

    最終更新日:Jun 22, 2026

    このトピックでは、MSE Nacos 設定センターを Spring Cloud アプリケーションに統合し、設定の一元管理と動的リフレッシュを実現する方法について説明します。

    背景情報

    マイクロサービスアーキテクチャにおいて、ハードコーディングされた値や静的ファイルによる設定管理は、マイクロサービスや環境の数が増えるにつれて困難になります。この方法では、設定の不一致や更新の遅延が発生しがちです。設定センターは、設定データを保存、管理、動的に更新するための一元的な場所を提供することで、これらの問題を解決します。これにより、異なる環境やインスタンス間での設定の分離と同期が保証され、設定更新の柔軟性とセキュリティが向上します。

    前提条件

    • Maven をダウンロードし、必要な環境変数を設定していること。

    • 既存の Spring Cloud アプリケーションがあること。アプリケーションがない場合は、このトピックで提供されているデモアプリケーション (nacos-service-config.zip) を使用できます。

    • Nacos エンジンを作成していること。

      重要

      アプリケーションが MSE Nacos と同じリージョンにない場合、または Alibaba Cloud サーバー上にない場合は、Nacos エンジンの作成時にパブリックネットワークを選択する必要があります。

      アプリケーションからパブリックネットワーク経由で MSE にアクセスするには、ホワイトリストを設定する必要があります。詳細については、「ホワイトリストの設定」をご参照ください。

    • 名前空間を作成していること。

    概要

    image

    MSE Nacos 設定センターを Spring Cloud アプリケーションに統合することで、動的リフレッシュ機能を体験できます。設定パラメータ useLocalCache=true を公開し、MSE Nacos コンソールで useLocalCache=false に更新した後、コマンドラインからアプリケーションの設定 API にリクエストして useLocalCache の値を取得し、変更を確認します。

    1. 設定の作成と公開： MSE コンソールで初期設定を定義し、公開します。

    2. MSE Nacos の統合： Spring Cloud アプリケーションを MSE Nacos 設定センターに接続に必要な依存関係とプロパティを追加します。

    3. 動的リフレッシュの検証： コンソールで設定を変更し、アプリケーションを再起動せずに変更が適用されることを確認します。

    ステップ 1: 設定の作成と公開

    1. MSE コンソールにログインし、上部メニューでリージョンを選択します。

    2. ターゲットインスタンスの名前をクリックします。

    3. 左側メニューで、Configuration Management > Configurations を選択します。

    4. 設定リストの上部で、作成した名前空間を選択します。

    5. Add Configuration をクリックします。Add Configuration パネルで、以下の情報を入力します。

      説明

      このトピックでは、参考用のサンプル設定のみを提供しています。ビジネス要件に基づいて設定を作成できます。パラメータの詳細については、「設定の作成」をご参照ください。

      [Data ID] を mse-nacos-config-client.properties に、 [Group] を DEFAULT_GROUP に設定します。 [Configuration Format] では [Properties] を選択します。 [Configuration Content] フィールドに useLocalCache=true と入力し、 [Publish] をクリックします。

    1. 設定情報を入力したら、Publish をクリックします。新しい設定が Configurations に表示されます。

    ステップ 2: MSE Nacos の統合

    1. (オプション) Spring Cloud アプリケーションを構築していない場合は、この例を使用してシンプルなアプリケーションを迅速にセットアップできます。

      アプリケーション例

      nacos-service-config-1.0-SNAPSHOT.jar

    2. Spring Cloud アプリケーションの pom.xml ファイルに、Nacos 設定センターの依存関係を追加します。

      説明

      Spring Cloud Alibaba、 Spring Cloud、 SpringBoot のバージョンは互換性がある必要があります。Spring Cloud Alibaba 公式サイトのバージョンリリースノートを確認し、アプリケーションに適合するバージョンを選択してください。最新の 2023.x バージョンへのアップグレードを推奨します。

              <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            <version>2021.0.4.0</version>
        </dependency>

    3. Spring Cloud アプリケーションの設定ファイルに、Nacos 関連の設定を追加します。

      重要

      アプリケーションで特定の名前空間を使用する場合は、その ID を指定してください。

      # Nacos サーバーのパブリックエンドポイント
spring.cloud.nacos.config.server-addr=mse-XXX.nacos-ans.mse.aliyuncs.com:8848
# MSE Nacos の名前空間を指定します。デフォルトのパブリック名前空間にアクセスする場合は、この項目を空白のままにするか、設定しないでください。
spring.cloud.nacos.config.namespace=24075300-XXXX-XXXX-XXXX-0c17aa9f744b
# 特定の設定ファイルをインポートします。
spring.config.import=nacos:mse-nacos-config-client.properties?group=DEFAULT_GROUP&refreshEnabled=true

      インスタンス ページで、MSE Nacos のパブリックエンドポイントを確認できます。形式は mse.XX.nacos.mse.aliyuncs.com です。

    4. 変更後、mvn clean package コマンドを実行して、アプリケーションを再コンパイルおよびパッケージ化します。

    ステップ 3: 動的リフレッシュの検証

    説明

    以下の検証手順は、このトピックで提供されているサンプル Spring Cloud アプリケーションと設定に基づいています。独自のアプリケーションやカスタム設定を使用している場合は、手順の調整が必要になる場合があります。

    1. 起動クラスの main 関数を実行して、Spring Cloud アプリケーションを起動します。

    2. ターミナルで次のコマンドを実行し、MSE Nacos 設定センターから useLocalCache 設定を取得します。レスポンスは true です。

      # サービスの IP アドレスとポートに置き換えてください。
curl http://<your-service-ip>:18083/getConfig

    3. コンソールで設定を編集し、内容を useLocalCache=false に変更して、再度公開します。

    4. 再度コマンドを実行します。レスポンスは false になります。これにより、アプリケーションが再起動せずに MSE Nacos から最新の useLocalCache データを取得したことを確認できます。

    関連ドキュメント