Migrowanie widoku na żywo aplikacji do zarządzanego administratora aplikacji Spring w usłudze Azure Container Apps

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy: ❎ Podstawowa/Standardowa ✅ Enterprise

W tym artykule opisano sposób migrowania portalu interfejsu API do aplikacji Managed Admin for Spring w usłudze Azure Container Apps.

Składnik zarządzany przez administratora platformy Spring udostępnia interfejs administracyjny dla aplikacji internetowych Spring Boot, które uwidaczniają punkty końcowe siłownika. Jest on podobny do widoku na żywo aplikacji, działającego jako lekkie narzędzie do analizy i rozwiązywania problemów, które pomaga deweloperom i operatorom monitorować uruchomione aplikacje.

Wymagania wstępne

• Skonfigurowane wystąpienie planu usługi Azure Spring Apps Enterprise z włączoną usługą Application Configuration Service.
• Istniejąca aplikacja kontenera platformy Azure. Aby uzyskać więcej informacji, zobacz temat Szybki start: Wdrażanie pierwszej aplikacji kontenera przy użyciu witryny Azure Portal.
• Interfejs wiersza polecenia platformy Azure.

Aprowizuj administratora zarządzanego dla platformy Spring w usłudze Azure Container Apps

Aby aprowizować składnik, wykonaj następujące czynności:

Witryna Azure Portal

1. Przejdź do środowiska aplikacji kontenera w witrynie Azure Portal.

2. W obszarze Usługi w menu usługi wybierz pozycję Usługi.

3. Wybierz pozycję Konfiguruj, a następnie wybierz pozycję Składnik Java.

4. Wypełnij okienko Konfigurowanie składnika Języka Java następującymi wartościami:

   Właściwości	Wartość
   Typ składnika Java	Administrator platformy Spring
   Nazwa składnika Java	Admin

5. Wybierz Dalej.

6. Na karcie Przegląd wybierz pozycję Konfiguruj.

Interfejs wiersza polecenia platformy Azure

1. Użyj następującego polecenia, aby utworzyć składnik Admin for Spring Java:

   az containerapp env java-component admin-for-spring create \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --environment $ENVIRONMENT \
       --min-replicas 1 \
       --max-replicas 1
   

2. Użyj następującego polecenia, aby zaktualizować składnik Admin for Spring Java:

   az containerapp env java-component admin-for-spring update \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
       --environment $ENVIRONMENT \
       --min-replicas 2 \
       --max-replicas 2
   

Aktualizowanie zależności aplikacji kontenera

Aby zintegrować składnik Admin z aplikacją kontenera, dodaj następującą zależność do pliku pom.xml . Zastąp numer wersji najnowszą wersją z repozytorium Maven.

<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>
    <version>3.3.2</version>
</dependency>

Wiązanie aplikacji kontenera ze składnikiem Admin for Spring Java

Witryna Azure Portal

Wykonaj następujące kroki, aby powiązać aplikację kontenera ze składnikiem:

1. Przejdź do środowiska aplikacji kontenera w witrynie Azure Portal.
2. W obszarze Usługi wybierz pozycję Usługi.
3. Z listy wybierz pozycję administrator.
4. W obszarze Powiązania wybierz nazwę aplikacji kontenera z listy rozwijanej Nazwa aplikacji.
5. Wybierz kartę Przegląd , a następnie wybierz pozycję Konfiguruj.
6. Przejdź do aplikacji kontenera w witrynie Azure Portal i skopiuj jej adres URL do późniejszego użycia.

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby utworzyć aplikację kontenera i powiązać ją ze składnikiem Admin for Spring:

az containerapp create \
    --resource-group $RESOURCE_GROUP \
    --name $APP_NAME \
    --environment $ENVIRONMENT \
    --image $IMAGE \
    --min-replicas 1 \
    --max-replicas 1 \
    --ingress external \
    --target-port 8080 \
    --bind $JAVA_COMPONENT_NAME

Uzyskiwanie dostępu do pulpitu nawigacyjnego administratora

Uwaga

Administrator zarządzany aplikacji Spring w usłudze Azure Container Apps nie obsługuje konfiguracji logowania jednokrotnego. Opiera się ona na przypisaniach ról platformy Azure.

Aby uzyskać dostęp do pulpitu nawigacyjnego, musisz mieć przypisaną Microsoft.App/managedEnvironments/write rolę do konta dla zasobu środowiska zarządzanego.

Tworzenie i przypisywanie roli niestandardowej

Aby utworzyć i przypisać rolę niestandardową, wykonaj następujące kroki:

1. Użyj następującego polecenia, aby utworzyć niestandardową definicję roli:

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

2. Użyj następującego polecenia, aby przypisać rolę niestandardową do konta:

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