Jak skonfigurować integrację usługi APM i certyfikaty urzędu certyfikacji

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 pokazano, jak skonfigurować certyfikaty integracji i urzędu certyfikacji (CA) monitora wydajności aplikacji (APM) w planie Azure Spring Apps Enterprise.

Usługę Tanzu Build Service można włączyć lub wyłączyć w wystąpieniu planu Enterprise usługi Azure Springs Apps. Aby uzyskać więcej informacji, zobacz sekcję Build service on demand (Tworzenie usługi na żądanie ) w temacie Use Tanzu Build Service (Korzystanie z usługi Tanzu Build Service).

Wymagania wstępne

• Już aprowizowane wystąpienie planu Usługi Azure Spring Apps Enterprise. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie i wdrażanie aplikacji w usłudze Azure Spring Apps przy użyciu planu Enterprise.
• Interfejs wiersza polecenia platformy Azure w wersji 2.49.0 lub nowszej. Użyj następującego polecenia, aby zainstalować rozszerzenie Azure Spring Apps: az extension add --name spring

Obsługiwane scenariusze — integracja certyfikatów APM i CA

Usługa Tanzu Build Service używa powiązania buildpack w celu zintegrowania z pakietami Buildpack partner Tanzu i innymi natywnymi pakietami kompilacji w chmurze, takimi jak pakiet buildpack certyfikatów ca w usłudze GitHub.

Obecnie usługa Azure Spring Apps obsługuje następujące typy APM:

• ApplicationInsights
• Dynatrace
• AppDynamics
• Nowy Relic
• ElasticAPM

Usługa Azure Spring Apps obsługuje certyfikaty urzędu certyfikacji dla wszystkich pakietów kompilacji rodziny języków, ale nie wszystkich obsługiwanych interfejsów APM. W poniższej tabeli przedstawiono typy powiązań obsługiwane przez pakiety kompilacji rodziny języków Tanzu.

Pakiet kompilacji	ApplicationInsights	Nowy Relic	AppDynamics	Dynatrace	ElasticAPM
Java	✔	✔	✔	✔	✔
.NET		✔		✔
Go				✔
Python
NodeJS		✔	✔	✔	✔
Serwery internetowe				✔
Obraz natywny języka Java
PHP		✔	✔	✔

Aby uzyskać informacje na temat korzystania z serwerów sieci Web, zobacz Wdrażanie internetowych plików statycznych.

Usługa Tanzu Build Service jest domyślnie włączona w usłudze Azure Spring Apps Enterprise. Jeśli zdecydujesz się wyłączyć usługę kompilacji, możesz wdrażać aplikacje, ale tylko przy użyciu niestandardowego obrazu kontenera. Ta sekcja zawiera wskazówki dotyczące scenariuszy z obsługą usługi kompilacji i wyłączonymi.

Obsługiwane typy APM

W tej sekcji wymieniono obsługiwane języki i wymagane zmienne środowiskowe dla aplikacji APM, których można używać na potrzeby integracji.

• Application Insights

  Obsługiwane języki:

  • Java

  Zmienne środowiskowe wymagane do powiązania pakietu buildpack:

  • connection-string

  Aby uzyskać informacje o innych obsługiwanych zmiennych środowiskowych, zobacz Omówienie usługi Application Insights.

• DynaTrace

  Obsługiwane języki:

  • Java
  • .NET
  • Przejdź
  • Node.js
  • Serwery internetowe
  • PHP

  Zmienne środowiskowe wymagane do powiązania pakietu buildpack:

  • api-url lub environment-id (używane w kroku kompilacji)
  • api-token (używane w kroku kompilacji)
  • TENANT
  • TENANTTOKEN
  • CONNECTION_POINT

  Aby uzyskać informacje o innych obsługiwanych zmiennych środowiskowych, zobacz Dynatrace

• New Relic

  Obsługiwane języki:

  • Java
  • .NET
  • Node.js
  • PHP

  Zmienne środowiskowe wymagane do powiązania pakietu buildpack:

  • license_key
  • app_name

  Aby uzyskać informacje o innych obsługiwanych zmiennych środowiskowych, zobacz New Relic

• Elastyczny

  Obsługiwane języki:

  • Java
  • Node.js
  • PHP

  Zmienne środowiskowe wymagane do powiązania pakietu buildpack:

  • service_name
  • application_packages
  • server_url

  Aby uzyskać informacje o innych obsługiwanych zmiennych środowiskowych, zobacz Elastic

• AppDynamics

  Obsługiwane języki:

  • Java
  • Node.js

  Zmienne środowiskowe wymagane do powiązania pakietu buildpack:

  • agent_application_name
  • agent_tier_name
  • agent_node_name
  • agent_account_name
  • agent_account_access_key
  • controller_host_name
  • controller_ssl_enabled
  • controller_port

  Aby uzyskać informacje o innych obsługiwanych zmiennych środowiskowych, zobacz AppDynamics

Powiązania w konstruktorze są przestarzałe

Uwaga

Wcześniej można zarządzać certyfikatami integracji i urzędu certyfikacji APM za pośrednictwem powiązań w konstruktorze. Powiązania w funkcji konstruktora są przestarzałe i są usuwane w przyszłości. Zalecamy przeprowadzenie migracji programu APM skonfigurowanego w powiązaniach. Aby uzyskać więcej informacji, zobacz sekcję Migrate the APM configured in bindings (Migrowanie programu APM skonfigurowanego w powiązaniach ).

Jeśli używasz własnego rejestru kontenerów dla usługi kompilacji lub wyłączasz usługę kompilacji, funkcja powiązań w konstruktorze jest niedostępna.

W przypadku korzystania z zarządzanej usługi Azure Container Registry dla usługi kompilacji rejestr jest nadal dostępny na potrzeby zgodności z poprzednimi wersjami, ale jest usuwany w przyszłości.

Jeśli używasz interfejsu wiersza polecenia platformy Azure do utworzenia wystąpienia usługi, może zostać wyświetlony komunikat Buildpack bindings feature is deprecated, it's not available when your own container registry is used for build service or build service is disabledo błędzie . Ten komunikat wskazuje, że używasz starej wersji interfejsu wiersza polecenia platformy Azure. Aby rozwiązać ten problem, uaktualnij interfejs wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz Jak zaktualizować interfejs wiersza polecenia platformy Azure.

Konfigurowanie integracji APM dla kompilacji i wdrożeń aplikacji

Program APM można skonfigurować w usłudze Azure Spring Apps na następujące dwa sposoby:

• Zarządzaj konfiguracjami programu APM na poziomie wystąpienia usługi i powiąż je z kompilacjami i wdrożeniami aplikacji, odwołując się do nich. To podejście jest zalecanym sposobem konfigurowania APM.

• Zarządzanie konfiguracjami programu APM za pomocą powiązań w konstruktorze i wiązanie z kompilacjami i wdrożeniami aplikacji, odwołując się do konstruktora.

Uwaga

To podejście jest starym sposobem konfigurowania APM i jest teraz przestarzałe. Zalecamy przeprowadzenie migracji programu APM skonfigurowanego w powiązaniach. Aby uzyskać więcej informacji, zobacz sekcję Migrate the APM configured in bindings (Migrowanie programu APM skonfigurowanego w powiązaniach ).

Teraz możesz skonfigurować aplikację APM w usłudze Azure Spring Apps, zarządzając konfiguracjami APM na poziomie wystąpienia usługi i powiązać je z kompilacjami i wdrożeniami aplikacji, odwołując się do nich. To podejście jest zalecanym sposobem konfigurowania APM.

Poniższe sekcje zawierają wskazówki dotyczące obu tych podejść.

Zarządzanie usługami APM na poziomie wystąpienia usługi (zalecane)

Konfigurację APM i powiązać z kompilacjami i wdrożeniami aplikacji, jak wyjaśniono w poniższych sekcjach.

Zarządzanie konfiguracją APM w usłudze Azure Spring Apps

Integrację aplikacji APM można zarządzać, konfigurując właściwości lub wpisy tajne w konfiguracji APM przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Uwaga

Podczas konfigurowania właściwości lub wpisów tajnych za pośrednictwem konfiguracji APM użyj nazw kluczy bez nazwy APM jako prefiksu. Na przykład nie używaj prefiksu DT_ dynatrace ani APPLICATIONINSIGHTS_ usługi Application Insights. Pakiety kompilacji Tanzu APM przekształcają nazwę klucza na oryginalną nazwę zmiennej środowiskowej z prefiksem.

Jeśli zamierzasz zastąpić lub skonfigurować niektóre właściwości lub wpisy tajne, takie jak nazwa aplikacji lub poziom aplikacji, należy ustawić zmienne środowiskowe podczas wdrażania aplikacji z oryginalnymi zmiennymi środowiskowymi z nazwą APM jako prefiksem.

Witryna Azure Portal

Wykonaj następujące kroki, aby wyświetlić, dodać, edytować lub usunąć konfigurację APM:

1. Otwórz portal Azure Portal.

2. W okienku nawigacji wybierz pozycję APM.

3. Aby utworzyć konfigurację APM, wybierz pozycję Dodaj. Jeśli chcesz włączyć konfigurację APM globalnie, wybierz pozycję Włącz globalnie. Wszystkie kolejne kompilacje i wdrożenia automatycznie używają konfiguracji APM.

   

4. Aby wyświetlić lub edytować konfigurację APM, wybierz przycisk wielokropka (...) dla konfiguracji, a następnie wybierz pozycję Edytuj APM.

   

5. Aby usunąć konfigurację APM, wybierz przycisk wielokropka (...) dla konfiguracji, a następnie wybierz pozycję Usuń. Jeśli konfiguracja APM jest używana przez dowolną kompilację lub wdrożenie, nie możesz go usunąć.

   

Wykonaj następujące kroki, aby wyświetlić konfiguracje APM powiązane z kompilacją:

1. Przejdź do strony Build Service (Usługa kompilacji) dla wystąpienia usługi Azure Spring Apps.

   

2. W okienku nawigacji w sekcji Ustawienia wybierz pozycję Powiązania APM.

3. Na stronie Powiązania APM wyświetl konfiguracje APM powiązane z kompilacją.

   

Wykonaj następujące kroki, aby wyświetlić konfiguracje APM powiązane z wdrożeniem:

1. Przejdź do strony aplikacji.

2. W okienku nawigacji w sekcji Ustawienia wybierz pozycję Powiązania APM.

3. Na stronie Powiązania APM wyświetl konfiguracje APM powiązane z wdrożeniem.

   

Interfejs wiersza polecenia platformy Azure

Na poniższej liście przedstawiono polecenia interfejsu wiersza polecenia platformy Azure, których można użyć do zarządzania konfiguracją programu APM:

• Użyj następującego polecenia, aby wyświetlić listę wszystkich konfiguracji APM:

  az spring apm list \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name>
  

• Użyj następującego polecenia, aby wyświetlić listę wszystkich obsługiwanych typów APM:

  az spring apm list-support-types \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name>
  

• Użyj następującego polecenia, aby utworzyć konfigurację APM:

  az spring apm create \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name> \
      --type <your-APM-type> \
      --properties a=b c=d \
      --secrets e=f g=h
  

• Użyj następującego polecenia, aby wyświetlić szczegóły konfiguracji APM:

  az spring apm show \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name>
  

• Użyj następującego polecenia, aby zmienić właściwości APM:

  az spring apm update \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name> \
      --type <your-APM-type> \
      --properties a=b c=d \
      --secrets e=f2 g=h
  

• Użyj następującego polecenia, aby włączyć konfigurację APM globalnie. Po włączeniu konfiguracji APM globalnie wszystkie kolejne kompilacje i wdrożenia będą używane automatycznie.

  az spring apm enable-globally \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name> \
  

• Użyj następującego polecenia, aby globalnie wyłączyć konfigurację APM. Po wyłączeniu konfiguracji APM globalnie wszystkie kolejne kompilacje i wdrożenia nie korzystają z niej.

  az spring apm disable-globally \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name> \
  

• Użyj następującego polecenia, aby wyświetlić listę wszystkich konfiguracji APM włączonych globalnie:

  az spring apm list-enabled-globally \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name>
  

• Użyj następującego polecenia, aby usunąć konfigurację APM.

  az spring apm delete \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <your-APM-name> \
  

Aby uzyskać więcej informacji na properties temat parametrów i secrets dla pakietu buildpack, zobacz sekcję Obsługiwane scenariusze — integracja certyfikatów APM i CA.

Wiązanie z kompilacjami i wdrożeniami aplikacji

W przypadku usługi kompilacji korzystającej z zarządzanej usługi Azure Container Registry użyj następującego polecenia, aby zintegrować aplikację APM z wdrożeniami:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

Po włączeniu konfiguracji APM globalnie wszystkie kolejne kompilacje i wdrożenia używają jej automatycznie i nie trzeba określać parametru --apms . Jeśli chcesz zastąpić konfigurację APM włączoną globalnie dla wdrożenia, określ konfiguracje APM za pomocą --apms parametru .

W przypadku usługi kompilacji korzystającej z własnego rejestru kontenerów możesz skompilować aplikację w obrazie kontenera i wdrożyć obraz w bieżących lub innych wystąpieniach usługi Azure Spring Apps Enterprise.

Udostępnianie własnego rejestru kontenerów oddziela kompilowanie od wdrożenia. Możesz użyć polecenia kompilacji, aby utworzyć lub zaktualizować kompilację za pomocą konstruktora, a następnie użyć polecenia deploy, aby wdrożyć obraz kontenera w usłudze.

Użyj następującego polecenia, aby skompilować obraz i skonfigurować aplikację APM:

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

Po włączeniu konfiguracji APM globalnie wszystkie kolejne kompilacje i wdrożenia używają jej automatycznie i nie trzeba określać parametru --apms . Jeśli chcesz zastąpić konfigurację APM włączoną globalnie dla kompilacji, określ konfiguracje APM za pomocą parametru --apms .

Użyj następującego polecenia, aby wdrożyć aplikację przy użyciu obrazu kontenera utworzonego wcześniej i skonfigurować aplikację APM. Możesz użyć konfiguracji APM włączonej globalnie lub użyć parametru , aby określić konfigurację --apms APM.

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

Po wyłączeniu usługi kompilacji można wdrożyć aplikację tylko przy użyciu obrazu kontenera. Aby uzyskać więcej informacji, zobacz Wdrażanie aplikacji przy użyciu niestandardowego obrazu kontenera.

Możesz użyć wielu wystąpień usługi Azure Spring Apps Enterprise, w których niektóre wystąpienia kompilują i wdrażają obrazy, a inne wdrażają tylko obrazy. Rozważmy następujący scenariusz:

Na jednym przykładzie włączysz usługę kompilacji z rejestrem kontenerów użytkownika. Następnie utworzysz plik artefaktu lub kod źródłowy przy użyciu certyfikatu APM lub urzędu certyfikacji do obrazu kontenera. Następnie można wdrożyć je w bieżącym wystąpieniu usługi Azure Spring Apps lub w innych wystąpieniach usługi. Aby uzyskać więcej informacji, zobacz sekcję Tworzenie i wdrażanie aplikacji wielolotowych w temacie Jak wdrażać aplikacje wielolotowe w usłudze Azure Spring Apps Enterprise.

W innym wystąpieniu z wyłączoną usługą kompilacji wdrażasz aplikację z obrazem kontenera w rejestrze, a także korzystasz z usługi APM.

W tym scenariuszu można użyć konfiguracji APM włączonej globalnie lub użyć parametru --apms w celu określenia konfiguracji APM, jak pokazano w poniższym przykładzie:

az spring app deploy \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-instance-name> \
   --name <app-name> \
   --container-image <your-container-image> \
   --container-registry <your-container-registry> \
   --registry-password <your-password> \
   --registry-username <your-username> \
   --apms <your-APM>

Zarządzanie usługami APM za pośrednictwem powiązań w konstruktorze (przestarzałe)

Gdy usługa kompilacji korzysta z zarządzanego rejestru kontenerów usługi Azure Spring Apps, możesz utworzyć aplikację na obrazie, a następnie wdrożyć ją, ale tylko w bieżącym wystąpieniu usługi Azure Spring Apps.

Zarządzanie konfiguracjami programu APM za pomocą powiązań w narzędziu builder

Konfiguracje APM można zarządzać za pomocą powiązań w narzędziu builder. Aby uzyskać więcej informacji, zobacz sekcję Zarządzanie powiązaniami w narzędziu Builder w usłudze Azure Spring Apps (przestarzałe).

Wiązanie z kompilacjami i wdrożeniami aplikacji

Użyj następującego polecenia, aby zintegrować aplikację APM z wdrożeniami. APM jest konfigurowany za pośrednictwem powiązań w konstruktorze:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --artifact-path <path-to-your-JAR-file>

Włączanie usługi Application Insights podczas tworzenia wystąpienia usługi

Jeśli włączysz usługę Application Insights podczas tworzenia wystąpienia usługi, obowiązują następujące warunki:

• Jeśli używasz zarządzanej usługi Azure Container Registry dla usługi kompilacji, usługa Application Insights jest powiązana z powiązaniami w konstruktorze domyślnym.
• Jeśli używasz własnego rejestru kontenerów dla usługi kompilacji lub wyłączysz usługę kompilacji, zostanie utworzona domyślna konfiguracja APM dla usługi Application Insights. Domyślny APM jest włączony globalnie, a wszystkie kolejne kompilacje i wdrożenia używają ich automatycznie.

Konfigurowanie certyfikatów urzędu certyfikacji dla kompilacji i wdrożeń aplikacji

Certyfikaty urzędu certyfikacji można skonfigurować w usłudze Azure Spring Apps na następujące dwa sposoby:

• Certyfikaty publiczne można zarządzać w ustawieniach protokołu TLS/SSL i powiązać je z kompilacjami i wdrożeniami aplikacji, odwołując się do nich. To podejście jest zalecanym sposobem konfigurowania certyfikatów urzędu certyfikacji.
• Certyfikaty publiczne można zarządzać w ustawieniach protokołu TLS/SSL i powiązać certyfikaty urzędu certyfikacji za pośrednictwem powiązań w konstruktorze. Aby uzyskać więcej informacji, zobacz sekcję Zarządzanie powiązaniami w narzędziu Builder w usłudze Azure Spring Apps (przestarzałe).

Uwaga

Takie podejście to stary sposób konfigurowania certyfikatów urzędu certyfikacji i jego przestarzałe. Zalecamy przeprowadzenie migracji certyfikatu urzędu certyfikacji skonfigurowanego w powiązaniach. Aby uzyskać więcej informacji, zobacz sekcję Migrowanie certyfikatu urzędu certyfikacji skonfigurowanego w powiązaniach .

Teraz można zarządzać certyfikatami publicznymi w ustawieniach protokołu TLS/SSL i powiązać je z kompilacjami i wdrożeniami aplikacji, odwołując się do nich. To podejście jest zalecanym sposobem konfigurowania certyfikatów urzędu certyfikacji.

Aby zarządzać certyfikatami publicznymi na poziomie wystąpienia usługi, zobacz sekcję Importowanie certyfikatu w sekcji Używanie certyfikatów TLS/SSL w aplikacji w usłudze Azure Spring Apps. następnie wykonaj jedną z metod opisanych w poniższych sekcjach, aby powiązać certyfikaty urzędu certyfikacji z kompilacjami i wdrożeniami aplikacji.

Wiązanie certyfikatów urzędu certyfikacji z kompilacjami i wdrożeniami aplikacji

Aby uzyskać informacje na temat sposobu powiązania certyfikatów urzędu certyfikacji z wdrożeniami, zobacz sekcję Load a certificate (Ładowanie certyfikatów TLS/SSL) w aplikacji w usłudze Azure Spring Apps. Następnie użyj poniższych instrukcji, aby powiązać kompilacje aplikacji.

Po włączeniu usługi kompilacji i użyciu zarządzanej usługi Azure Container Registry użyj następującego polecenia, aby zintegrować certyfikaty urzędu certyfikacji z wdrożeniem:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --build-certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

Jeśli używasz własnego rejestru kontenerów dla usługi kompilacji lub wyłączasz usługę kompilacji, użyj następującego polecenia, aby zintegrować certyfikaty urzędu certyfikacji z kompilacją:

az spring build-service build <create|update> \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --certificates <CA certificate-name> \
    --artifact-path <path-to-your-JAR-file>

Wyświetlanie certyfikatów urzędu certyfikacji powiązanych z kompilacjami aplikacji

Aby wyświetlić certyfikaty urzędu certyfikacji powiązane z kompilacją, wykonaj następujące czynności:

1. Przejdź do strony kompilacji.

   

2. W okienku nawigacji w sekcji Ustawienia wybierz pozycję Powiązania certyfikatów.

3. Na stronie Powiązania certyfikatów wyświetl certyfikaty urzędu certyfikacji powiązane z kompilacją.

   

Wiązanie certyfikatów urzędu certyfikacji za pośrednictwem powiązań w konstruktorze (przestarzałe)

Certyfikaty urzędu certyfikacji używają pakietu buildpack ca-certificates do obsługi udostępniania certyfikatów urzędu certyfikacji do magazynu zaufania systemu w kompilacji i czasie wykonywania.

W planie Usługi Azure Spring Apps Enterprise certyfikaty urzędu certyfikacji używają karty Certyfikaty kluczy publicznych na stronie ustawień protokołu TLS/SSL w witrynie Azure Portal, jak pokazano na poniższym zrzucie ekranu:

Certyfikaty urzędu certyfikacji można skonfigurować na stronie Edytowanie powiązania . Certyfikaty succeeded są wyświetlane na liście Certyfikaty urzędu certyfikacji.

Zarządzanie powiązaniami w narzędziu Builder w usłudze Azure Spring Apps (przestarzałe)

Ta sekcja dotyczy tylko wystąpienia usługi Azure Spring Apps Enterprise z włączoną usługą kompilacji. Po włączeniu usługi kompilacji jedno powiązanie pakietu kompilacji oznacza konfigurację poświadczeń względem jednego typu APM lub konfigurację certyfikatów urzędu certyfikacji względem typu certyfikatów urzędu certyfikacji. W przypadku integracji APM postępuj zgodnie z wcześniejszymi instrukcjami, aby skonfigurować niezbędne zmienne środowiskowe lub wpisy tajne dla APM.

Uwaga

Podczas konfigurowania zmiennych środowiskowych dla powiązań APM użyj nazw kluczy bez prefiksu. Na przykład nie używaj prefiksu DT_ dla powiązania Dynatrace ani APPLICATIONINSIGHTS_ usługi Application Insights. Pakiety kompilacji Tanzu APM przekształcają nazwę klucza na oryginalną nazwę zmiennej środowiskowej z prefiksem.

Powiązania pakietu buildpack można zarządzać za pomocą witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Witryna Azure Portal

Aby wyświetlić powiązania pakietu buildpack, wykonaj następujące czynności:

1. W witrynie Azure Portal przejdź do wystąpienia usługi Azure Spring Apps Enterprise.

2. W okienku nawigacji wybierz pozycję Usługa kompilacji.

3. Wybierz pozycję Edytuj w kolumnie Powiązania , aby wyświetlić powiązania skonfigurowane dla konstruktora.

   

4. Przejrzyj powiązania na stronie Edytowanie powiązania dla domyślnego konstruktora .

   

Tworzenie powiązania pakietu buildpack

Aby utworzyć powiązanie pakietu buildpack, wybierz pozycję Unbound na stronie Edytowanie powiązań, określ właściwości powiązania, a następnie wybierz pozycję Zapisz.

Usuwanie powiązania powiązania pakietu kompilacji

Powiązanie pakietu buildpack można usunąć za pomocą polecenia Unbind binding lub edytując właściwości powiązania.

Aby użyć polecenia Unbind binding , wybierz hiperłącze Powiązane , a następnie wybierz pozycję Usuń powiązanie.

Aby usunąć powiązanie pakietu buildpack, edytując właściwości powiązania, wybierz pozycję Edytuj powiązanie, a następnie wybierz pozycję Usuń powiązanie.

Po usunięciu powiązania stan powiązania zmieni się z Powiązana na Unbound.

Interfejs wiersza polecenia platformy Azure

Wyświetlanie powiązań pakietu buildpack przy użyciu interfejsu wiersza polecenia platformy Azure

Wyświetl bieżące powiązania pakietu buildpack przy użyciu następującego polecenia:

az spring build-service builder buildpack-binding list \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --builder-name <your-builder-name>

Tworzenie powiązania

Użyj tego polecenia, aby zmienić powiązanie z Unbound na Stan ograniczenia :

az spring build-service builder buildpack-binding create \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name> \
    --type <your-binding-type> \
    --properties a=b c=d \
    --secrets e=f g=h

Aby uzyskać informacje na properties temat parametrów i secrets dla pakietu buildpack, zobacz sekcję Obsługiwane scenariusze — integracja certyfikatów APM i CA.

Pokaż szczegóły określonego powiązania

Szczegóły określonego powiązania można wyświetlić przy użyciu następującego polecenia:

az spring build-service builder buildpack-binding show \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name>

Edytowanie właściwości powiązania

Właściwości powiązania można zmienić za pomocą następującego polecenia:

az spring build-service builder buildpack-binding set \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name> \
    --type <your-binding-type> \
    --properties a=b c=d \
    --secrets e=f2 g=h

Aby uzyskać więcej informacji na properties temat parametrów i secrets dla pakietu buildpack, zobacz sekcję Obsługiwane scenariusze — integracja certyfikatów APM i CA.

Usuwanie powiązania

Użyj następującego polecenia, aby zmienić stan powiązania z Powiązana na Unbound.

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-buildpack-binding-name> \
    --builder-name <your-builder-name>

Migrowanie certyfikatów APM i CA z powiązań w konstruktorze

Funkcja powiązań w konstruktorze jest przestarzała i jest usuwana w przyszłości. Zalecamy migrowanie powiązań w narzędziu builder.

Certyfikaty APM i CA można skonfigurować w powiązaniach i można je migrować, korzystając z poniższych sekcji.

Migrowanie programu APM skonfigurowanego w powiązaniach

W większości przypadków użycia istnieje tylko jeden APM skonfigurowany w powiązaniach w konstruktorze domyślnym. Możesz utworzyć nową konfigurację APM z tą samą konfiguracją w powiązaniach i włączyć tę konfigurację APM globalnie. Wszystkie kolejne kompilacje i wdrożenia używają tej konfiguracji automatycznie. Wykonaj następujące kroki, aby przeprowadzić migrację:

1. Użyj następującego polecenia, aby utworzyć konfigurację APM:

   az spring apm create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-name> \
       --type <your-APM-type> \
       --properties a=b c=d \
       --secrets e=f g=h
   

2. Użyj następującego polecenia, aby włączyć konfigurację APM globalnie:

   az spring apm enable-globally \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-name> \
   

3. Użyj następującego polecenia, aby ponownie wdrożyć wszystkie aplikacje, aby używać nowej konfiguracji APM włączonej globalnie:

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --builder <builder-name> \
       --artifact-path <path-to-your-JAR-file>
   

4. Sprawdź, czy nowa konfiguracja APM działa dla wszystkich aplikacji. Jeśli wszystko działa prawidłowo, użyj następującego polecenia, aby usunąć powiązania APM w konstruktorze:

   az spring build-service builder buildpack-binding delete \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-APM-buildpack-binding-name> \
       --builder-name <your-builder-name>
   

Jeśli istnieje kilka interfejsów APM skonfigurowanych w powiązaniach, możesz utworzyć kilka konfiguracji APM z tą samą konfiguracją w powiązaniach i włączyć konfigurację APM globalnie, jeśli ma to zastosowanie. Użyj parametru --apms , aby określić konfigurację APM dla wdrożenia, jeśli chcesz zastąpić APM włączone globalnie, jak pokazano w poniższym poleceniu:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <app-name> \
    --builder <builder-name> \
    --apms <APM-name> \
    --artifact-path <path-to-your-JAR-file>

Podczas procesu migracji program APM jest skonfigurowany zarówno w konfiguracjach powiązań, jak i APM. W takim przypadku konfiguracja APM jest obowiązuje, a powiązanie jest ignorowane.

Migrowanie certyfikatu urzędu certyfikacji skonfigurowanego w powiązaniach

Wykonaj następujące kroki, aby przeprowadzić migrację certyfikatu urzędu certyfikacji:

1. W przypadku certyfikatu urzędu certyfikacji skonfigurowanego w powiązaniu, jeśli jest on używany w środowisku uruchomieniowym, możesz załadować certyfikat do aplikacji. Aby uzyskać więcej informacji, zobacz sekcję Load a certificate (Ładowanie certyfikatów TLS/SSL) w aplikacji w usłudze Azure Spring Apps.

2. Użyj następującego polecenia, aby ponownie wdrożyć wszystkie aplikacje przy użyciu certyfikatu urzędu certyfikacji. Jeśli używasz certyfikatu w czasie kompilacji, użyj parametru --build-certificates , aby określić certyfikat urzędu certyfikacji do użycia w czasie kompilacji dla wdrożenia:

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --builder <builder-name> \
       --build-certificates <CA certificate-name> \
       --artifact-path <path-to-your-JAR-file>
   

3. Sprawdź, czy certyfikat urzędu certyfikacji działa dla wszystkich aplikacji korzystających z niego. Jeśli wszystko działa prawidłowo, użyj następującego polecenia, aby usunąć powiązania certyfikatów urzędu certyfikacji w konstruktorze:

   az spring build-service builder buildpack-binding delete \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <your-CA-certificate-buildpack-binding-name> \
       --builder-name <your-builder-name>
   

Następne kroki

• Jak wdrażać aplikacje wielolotowe w usłudze Azure Spring Apps Enterprise