Serverless App Engine:アプリケーション構成の管理

Nacos Server の起動

1. Nacos Server パッケージをダウンロードして展開します。

2. nacos/bin ディレクトリに移動し、OS に応じた起動コマンドを実行します。

   • Linux、UNIX、macOS の場合： sudo sh startup.sh -m standalone

   • Windows の場合： startup.cmd -m standalone

   -m standalone フラグは、Nacos をクラスターモード（デフォルト）ではなくスタンドアロンモードで起動します。Windows では、startup.cmd をダブルクリックするとクラスターモードで起動され、失敗します。これを修正するには、ファイルを開いて MODE="standalone" を設定します。Nacos クイックスタートを参照してください。

ローカル Nacos Server での構成作成

1. Nacos Server コンソール にログインします。デフォルトのユーザー名およびパスワードはいずれも nacos です。

2. 左側ナビゲーションウィンドウで、構成 をクリックします。構成 ページの右上隅にある アイコンをクリックします。

3. 構成の作成 ページで、以下のパラメーターを設定し、公開 をクリックします。

   • Data ID： nacos-config-example.properties

   • グループ： DEFAULT_GROUP

   • 構成内容： test.name=nacos-config-test

バージョン互換性

この例では、Spring Boot 2.1.4.RELEASE および Spring Cloud Greenwich.SR1 を使用します。ご使用の Spring Cloud リリースに対応する Spring Cloud Alibaba のバージョンを選択してください。

アプリケーションのビルド

1. nacos-config-example という名前の Maven プロジェクトを作成します。

2. pom.xml に以下の依存関係を追加します。この例では Spring Cloud Greenwich を使用するため、spring-cloud-starter-alibaba-nacos-config のバージョンは 2.1.1.RELEASE となります。

   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>2.1.4.RELEASE</version>
       <relativePath/>
   </parent>
   
   <dependencies>
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
       </dependency>
       <dependency>
           <groupId>com.alibaba.cloud</groupId>
           <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
           <version>2.1.1.RELEASE</version>
       </dependency>
   </dependencies>
   
   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>Greenwich.SR1</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   
   <build>
       <plugins>
           <plugin>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>

3. src/main/java 内に、com.aliware.edas パッケージを作成します。

4. com.aliware.edas パッケージ内に、NacosConfigExampleApplication の起動クラスを作成します。

   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   
   @SpringBootApplication
   public class NacosConfigExampleApplication {
       public static void main(String[] args) {
           SpringApplication.run(NacosConfigExampleApplication.class, args);
       }
   }

5. com.aliware.edas パッケージ内に、EchoController コントローラーを作成します。

   • @Value("${test.name}") は、Nacos Config から test.name キーの値を注入します。

   • @RefreshScope を付与すると、Nacos から構成変更がプッシュされた際に Bean が再作成され、注入された値が自動的に更新されます（再起動不要）。このアノテーションがない場合、アプリケーションは起動時のみ構成を読み取り、その後の変更は無視されます。

   import org.springframework.beans.factory.annotation.Value;
   import org.springframework.cloud.context.config.annotation.RefreshScope;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   @RefreshScope
   public class EchoController {
   
       @Value("${test.name}")
       private String userName;
   
       @RequestMapping(value = "/")
       public String echo() {
           return userName;
       }
   }

6. src/main/resources 内に、bootstrap.properties を作成し、ローカル Nacos Server への接続設定を追加します。127.0.0.1:8848 は Nacos Server のデフォルトアドレス、18081 はアプリケーションのサービスポートです。Nacos Server の実行場所が異なる場合は、アドレスおよびポートを適宜変更してください。

   spring.application.name=nacos-config-example
   server.port=18081
   spring.cloud.nacos.config.server-addr=127.0.0.1:8848

   利用可能な構成オプションの全一覧については、「構成リファレンス」をご参照ください。

7. main メソッドを NacosConfigExampleApplication から実行し、アプリケーションをローカルで起動します。