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. NacosConfigExampleApplication の main メソッドを実行して、アプリケーションをローカルで起動します。