教學課程：在 Azure 容器應用程式中連線到適用於 Spring 的受控 Eureka 伺服器

適用於 Spring 的 Eureka 伺服器是可讓微服務自我註冊並探索其他服務的服務註冊。 適用於 Spring 的 Eureka Server 可作為 Azure Container Apps 元件。 您可以將容器應用程式系結至 Spring 的 Eureka Server，以便向 Eureka 伺服器自動註冊。

在本教學課程中，您會了解如何：

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 如果您還沒有帳戶，您可以 免費建立一個。
• Azure CLI。

考量

當您在 Container Apps 中執行適用於 Spring 的 Eureka 伺服器時，請注意下列詳細數據：

設定

開始使用適用於 Spring 的 Eureka 伺服器元件之前，您必須先建立必要的資源。

建立適用於 Spring 的 Eureka 伺服器 Java 元件

將容器應用程式繫結至適用於 Spring 的 Eureka 伺服器 Java 元件

返回入口網站中的容器應用程式。 將應用程式的 URL 複製到文字編輯器，讓您可以在後續步驟中使用它。

移至 /allRegistrationStatus 路由，以檢視已向 Eureka Server for Spring 元件註冊的所有應用程式。

繫結會將數個設定插入到應用程式中作為環境變數，主要是 eureka.client.service-url.defaultZone 屬性。 此屬性會指出 Eureka 伺服器 Java 元件的內部端點。

繫結也會插入下列屬性：

"eureka.client.register-with-eureka":    "true"
"eureka.client.fetch-registry":          "true"
"eureka.instance.prefer-ip-address":     "true"

eureka.client.register-with-eureka 屬性會設定為 true，以強制向 Eureka 伺服器註冊。 此註冊會從組態伺服器等覆寫 中的 application.properties本機設定。 如果您想要將其設定為 false，則可以在容器應用程式中設定環境變數來加以覆寫。

屬性 eureka.instance.prefer-ip-address 會設定為 true ，因為容器應用程式環境中的特定域名系統解析規則。 請勿修改此值，以免中斷系結。

選擇性：從適用於 Spring Java 的 Eureka Server 元件解除系結您的容器應用程式

az containerapp update \
    --name $APP_NAME \
    --unbind $JAVA_COMPONENT_NAME \
    --resource-group $RESOURCE_GROUP

透過儀表板檢視應用程式

1. 建立自定義角色定義。

   az role definition create --role-definition '{
       "Name": "<YOUR_ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   請務必將 <SUBSCRIPTION_ID> 值中的 AssignableScopes 佔位元取代為您的訂用帳戶標識碼。

2. 將自定義角色指派給受控環境資源的帳戶。

   取得受控環境的資源識別碼：

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. 將角色指派給您的帳戶。

   執行此命令之前，請以您的使用者或服務主體識別碼和角色名稱取代以括號表示 <> 的佔位元元。

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   注意

   值<USER_OR_SERVICE_PRINCIPAL_ID>通常應該是您用來存取 Azure 入口網站 的身分識別。 值 <ROLE_NAME> 是您在步驟 1 中指派的名稱。

4. 取得適用於 Spring 的 Eureka 伺服器儀表板 URL。

   az containerapp env java-component eureka-server-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   此命令會傳回可用來存取 Spring 儀錶板的 Eureka 伺服器 URL。 透過儀錶板，您也可以看到容器應用程式，如下列螢幕快照所示。

   

選用：整合適用於 Spring 的 Eureka 伺服器與適用於 Spring 的管理員 Java 元件

如果您想要整合適用於 Spring 的 Eureka 伺服器與適用於 Spring 的管理員 Java 元件，請參閱整合適用於 Spring 的受控管理員與適用於 Spring 的 Eureka 伺服器。

清除資源

本教學課程中建立的資源會影響您的 Azure 帳單。 如果您不打算長期使用這些服務，請執行下列命令來移除您在本教學課程中建立的所有專案。

az group delete --resource-group $RESOURCE_GROUP

適用於 Spring 的 Eureka 伺服器允許的組態清單

下列各節說明支援的組態。 如需詳細資訊，請參閱 Spring Cloud Eureka Server。

設定選項

az containerapp update此命令會--configuration使用 參數來控制 Spring 的 Eureka 伺服器設定方式。 只要多個參數是以空格分隔，就可以一次使用多個參數。 如需詳細資訊，請參閱 Spring Cloud Eureka Server。

組態屬性提供 eureka.server 下列組態設定：

一般設定

• 記錄相關設定：
  • logging.level.*
  • logging.group.*
  • 命名空間下 logging.* 的任何其他設定都應該禁止 ，例如，應該禁止使用 logging.file 寫入記錄檔。

在應用程式之間呼叫

此範例示範如何撰寫 Java 程式代碼，以在已向 Spring 元件的 Eureka Server 註冊的應用程式之間進行呼叫。 當容器應用程式與 Eureka 系結時，它們會透過 Eureka 伺服器彼此通訊。

此範例會建立兩個應用程式、呼叫端和被呼叫者。 這兩個應用程式會使用適用於 Spring 的 Eureka 伺服器元件彼此通訊。 被呼叫端應用程式會公開呼叫端應用程式所呼叫的端點。

1. 建立被呼叫端應用程式。 在 Spring Boot 應用程式中啟用 Eureka 用戶端，方法是將 @EnableDiscoveryClient 批註新增至您的主要類別。

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

2. 在被呼叫端應用程式呼叫的被呼叫端應用程式中建立端點。

   @RestController
   public class CalleeController {
   
       @GetMapping("/call")
       public String calledByCaller() {
           return "Hello from Application callee!";
       }
   }
   

3. 在應用程式組態檔中設定被呼叫者應用程式的名稱，例如，在 application.yml。

   spring.application.name=callee
   

4. 建立呼叫端應用程式。

   @EnableDiscoveryClient新增註釋以啟用 Eureka 用戶端功能。 此外，使用@LoadBalanced註釋建立 WebClient.Builder Bean，以執行對其他服務的負載平衡呼叫。

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CallerApplication {
     public static void main(String[] args) {
       SpringApplication.run(CallerApplication.class, args);
     }
   
     @Bean
     @LoadBalanced
     public WebClient.Builder loadBalancedWebClientBuilder() {
       return WebClient.builder();
     }
   }
   

5. 在呼叫端應用程式中建立控制器，以使用 WebClient.Builder 其應用程式名稱呼叫被呼叫端應用程式， 被呼叫者。

   @RestController
   public class CallerController {
       @Autowired
       private WebClient.Builder webClientBuilder;
   
       @GetMapping("/call-callee")
       public Mono<String> callCallee() {
           return webClientBuilder.build()
               .get()
               .uri("http://callee/call")
               .retrieve()
               .bodyToMono(String.class);
       }
   }
   

現在您有呼叫端和被呼叫端應用程式，可使用適用於 Spring Java 元件的 Eureka Server 彼此通訊。 在呼叫端應用程式中測試 /call-callee 端點之前，請確定這兩個應用程式都正在執行並系結到 Eureka 伺服器。

限制

Eureka Server Java 元件隨附預設組態 eureka.server.enable-self-preservation，設定為 false。 此預設組態有助於避免在啟用自我保留后未刪除實例的時間。 如果實例太早刪除，某些要求可能會導向至不存在的實例。 如果您想要將此設定變更為 true，您可以在 Java 元件中設定自己的組態來覆寫它。

下一步

相關內容

整合適用於 Spring 的受控管理員與適用於 Spring 的 Eureka 伺服器