Serverless App Engine:Spring Cloud アプリケーションを SAE にスムーズに移行する

1. アプリケーションの選定

上流の依存関係を持たない基盤となるプロバイダーサービスから開始します。呼び出しトレースが複雑でマッピングが困難な場合は、任意のアプリケーションから開始してもかまいません。

2. 依存関係の追加と構成の更新

a. Nacos 検出依存関係の追加

pom.xml に spring-cloud-starter-alibaba-nacos-discovery を追加します。

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>{Version}</version>
</dependency>

b. Nacos サーバーアドレスの構成

application.properties に以下の内容を追加します。

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

c. マルチレジストリ移行依存関係の追加

デフォルトでは、Spring Cloud は 1 つのレジストリしか許可しません。2 番目のレジストリを追加するとエラーが発生します。edas-sc-migration-starter 依存関係を追加することで、この制限が解除され、複数のレジストリへの同時登録が可能になります。

pom.xml に以下を追加します。

<dependency>
    <groupId>com.alibaba.edas</groupId>
    <artifactId>edas-sc-migration-starter</artifactId>
    <version>1.0.2</version>
</dependency>

3. RibbonClients 構成の更新

複数のレジストリからサービスをサブスクライブするには、メインクラスで @RibbonClients を設定し、MigrationRibbonConfiguration を使用するようにします。

変更前：

@SpringBootApplication
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
}

変更後：

@SpringBootApplication
@RibbonClients(defaultConfiguration = MigrationRibbonConfiguration.class)
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
}

これらの変更をデプロイした後（オンプレミスまたは SAE 上）は、アプリケーションの再起動を行わずに、Spring Cloud Config または Nacos Config を使用して、アプリケーションが登録またはサブスクライブするレジストリを制御できます。詳細については、「サービス登録およびサブスクリプションポリシーの動的調整」および「アプリケーション構成の管理」をご参照ください。

4. SAE 上へのアプリケーションデプロイ

要件に応じてアプリケーションをデプロイします。詳細については、「アプリケーションのデプロイ」をご参照ください。

5. 移行の検証

以下のいずれかの方法を使用します。

オプション 1：ビジネス動作の確認

デプロイ後にビジネスが期待通りに動作することを確認します。

オプション 2：サービスサブスクリプションモニタリングの確認

Spring Boot Actuator が有効になっている場合、以下のエンドポイントにアクセスして、各サブスクライブされたサービスの RibbonServerList を確認できます。metaInfo 内の serverGroup フィールドに、ノードが属するレジストリが表示されます。

移行用依存関係の削除

すべてのアプリケーションが SAE 上に移行されたら、元のレジストリ構成および edas-sc-migration-starter 依存関係を削除します。

SLB の移行または DNS 設定の更新

アプリケーションの移行後、SLB インスタンスおよびドメイン名の構成を処理します。

SLB インスタンス

ドメイン名

ストレージおよびメッセージキューの移行

アプリケーションが ApsaraDB RDS やメッセージキューなどの Alibaba Cloud サービスを使用している場合、ストレージおよびメッセージキューの移行は不要です。アプリケーションが Alibaba Cloud 上にデプロイされていない場合は、テクニカルサポートのために DingTalk グループ 32874633 にご参加ください。

サブスクリプションポリシーの調整

デフォルトでは、SAE は関連するすべてのレジストリからサービスデータをサブスクライブおよび集約します。

特定のレジストリからのみサブスクライブするには、spring.cloud.edas.migration.subscribes プロパティを設定します。

# Eureka および Nacos の両方からサービスをサブスクライブ
spring.cloud.edas.migration.subscribes=nacos,eureka

# Nacos のみからサービスをサブスクライブ
spring.cloud.edas.migration.subscribes=nacos

登録ポリシーの調整

デフォルトでは、SAE は関連するすべてのレジストリに登録します。

特定のレジストリへの登録を除外するには、spring.cloud.edas.migration.registry.excludes プロパティを設定します。

# すべてのレジストリに登録（デフォルト — 空欄のまま）
spring.cloud.edas.migration.registry.excludes=

# Eureka への登録のみ無効化
spring.cloud.edas.migration.registry.excludes=eureka

# Nacos および Eureka への登録を無効化
spring.cloud.edas.migration.registry.excludes=nacos,eureka

SAE の構成管理機能を使用して、アプリケーションを再起動せずにランタイムでこのプロパティを更新できます。