Verwenden von VMware Tanzu Application Accelerator mit dem Azure Spring Apps Enterprise-Plan

Dieser Artikel gilt für:❌ Basic/Standard ✔️ Enterprise

In diesem Artikel erfahren Sie, wie Sie Application Accelerator für VMware Tanzu (App Accelerator) mit dem Azure Spring Apps Enterprise-Plan verwenden, um die Entwicklung Ihrer Anwendungen auf eine auffindbare und wiederholbare Weise zu starten.

App Accelerator hilft Ihnen, die Entwicklung Ihrer Anwendungen zu starten und sie auf auffindbare und wiederholbare Weise bereitzustellen. Sie können App Accelerator verwenden, um neue Projekte basierend auf veröffentlichten Beschleunigerprojekten zu erstellen. Weitere Informationen finden Sie in der VMware-Dokumentation unter Application Accelerator für VMware Tanzu.

Voraussetzungen

• Ein Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

• Verstehen und Erfüllen der Anforderungen im Abschnitt Anforderungen von Enterprise-Plan in Azure Marketplace.

• Azure CLI mit der Azure Spring Apps-Erweiterung. Verwenden Sie den folgenden Befehl, um frühere Versionen zu entfernen und die neueste Erweiterung zu installieren. Wenn Sie zuvor die spring-cloud-Erweiterung installiert hatten, deinstallieren Sie diese Erweiterung, um Konfigurations- und Versionskonflikte zu vermeiden.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Um App Accelerator in VS Code zu verwenden, müssen Sie auch die folgenden Voraussetzungen erfüllen:

  • Visual Studio Code
  • Azure Spring Apps-Erweiterung für Visual Studio Code

App Accelerator aktivieren

Sie können App Accelerator aktivieren, wenn Sie eine Azure Spring Apps Enterprise-Planinstanz bereitstellen. Wenn Sie bereits über eine Azure Spring Apps Enterprise-Planressource verfügen, lesen Sie den Abschnitt App Accelerator verwalten in einem vorhandenen Abschnitt Enterprise-Planinstanz, um ihn zu aktivieren.

Sie können App Accelerator über das Azure-Portal oder Azure CLI aktivieren.

Überwachen von App Accelerator

Mit Application Accelerator können Sie neue Projekte aus Dateien in Git-Repositorys generieren. In der folgenden Tabelle werden die Komponenten von Application Accelerator beschrieben:

Sie können die ausgeführten Instanzen und die Ressourcennutzung aller Komponenten mithilfe des Azure-Portals und der Azure CLI anzeigen.

az spring application-accelerator show \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Konfigurieren von Dev Tools für den Zugriff auf Application Accelerator

Um auf Application Accelerator zuzugreifen, müssen Sie Tanzu Dev Tools konfigurieren. Weitere Informationen finden Sie unter Konfigurieren der Tanzu Dev Tools im Azure Spring Apps Enterprise Plan.

Verwenden von Application Accelerator zum Bootstrapieren ihrer neuen Projekte

Um Application Accelerator zum Bootstrapieren ihrer neuen Projekte zu verwenden, müssen Sie Berechtigungen zum Verwalten von Beschleuniger erhalten. Anschließend können Sie vordefinierte Beschleunige oder eigene Beschleuniger verwalten.

Abrufen von Berechtigungen zum Verwalten von Beschleunigern

Für die Verwaltung Ihrer Beschleuniger sind die folgenden Berechtigungen erforderlich:

• Lesen: Get Azure Spring Apps Predefined Accelerator
• Weitere: Deaktivieren der vordefinierten Beschleuniger für Azure Spring-Apps
• Andere: Aktivieren der vordefinierten Beschleuniger für Azure Spring-Apps
• Schreiben: Erstellen oder Aktualisieren von angepassten Beschleuniger für Microsoft Azure Spring Apps
• Lesen: Abrufen von angepassten Beschleunigern für Azure Spring-Apps

Weitere Informationen finden Sie unter Verwenden von Berechtigungen in Azure Spring Apps.

Verwalten vordefinierter Beschleuniger

Sie können mit mehreren vordefinierten Beschleunigern beginnen, um Ihre neuen Projekte zu bootstrapieren. Sie können die integrierten Beschleuniger entsprechend Ihrer eigenen Vorliebe deaktivieren oder aktivieren.

Sie können vordefinierte Beschleuniger mithilfe des Azure-Portals oder der Azure CLI verwalten.

az spring application-accelerator predefined-accelerator list \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator disable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator enable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Verwalten Ihrer eigenen Beschleuniger

Zusätzlich zur Verwendung der vordefinierten Beschleuniger können Sie eigene Beschleuniger erstellen. Sie können jedes Git-Repository in Azure DevOps, GitHub, GitLab oder BitBucket verwenden.

Führen Sie die folgenden Schritte aus, um eigene Beschleuniger zu erstellen und zu verwalten:

Erstellen Sie zunächst eine Datei namens accelerator.yaml im Stammverzeichnis Ihres Git-Repositorys.

Sie können die Datei accelerator.yaml verwenden, um Eingabeoptionen zu deklarieren, die Benutzer mithilfe eines Formulars in der Benutzeroberfläche ausfüllen. Diese Optionswerte steuern die Verarbeitung durch das Vorlagenmodul, bevor sie die zippten Ausgabedateien zurückgibt. Wenn Sie keine accelerator.yaml-Datei einschließen, funktioniert das Repository weiterhin als Beschleuniger, die Dateien werden jedoch für Benutzer unverändert übergeben. Weitere Informationen finden Sie unter Erstellen einer accelerator.yaml-Datei.

Veröffentlichen Sie als Nächstes den neuen Beschleuniger.

Nachdem Sie die Datei accelerator.yaml erstellt haben, können Sie ihren Beschleuniger erstellen. Sie können sie dann im Azure-Portal oder auf der Seite "Application Accelerator" im Dev Tools-Portal anzeigen. Sie können den neuen Beschleuniger über das Azure-Portal oder die Azure CLI veröffentlichen.

az spring application-accelerator customized-accelerator create \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

In der folgenden Tabelle werden die anpassbaren Beschleunigerfelder beschrieben.

Informationen zum Anzeigen aller veröffentlichten Beschleuniger finden Sie im Abschnitt "App Accelerators" auf der Seite Entwicklertools. Wählen Sie die App Accelerator-URL aus, um die veröffentlichten Beschleuniger im Dev Tools-Portal anzuzeigen:

Aktualisieren Sie das Dev Tools-Portal, um die neu veröffentlichte Beschleuniger anzuzeigen.

Verweisen auf ein Fragment in Ihren eigenen Beschleunigern

Das Schreiben und Verwalten von Beschleunigern kann sich wiederholend und ausführlich werden, wenn neue Beschleuniger hinzugefügt werden. Einige Personen erstellen neue Projekte, indem sie vorhandene kopieren und Änderungen vornehmen, aber dieser Vorgang kann mühsam und fehleranfällig sein. Um die Erstellung und Wartung von Beschleunigern zu vereinfachen, unterstützt Application Accelerator ein Feature namens Composition, das die Wiederverwendung von Teilen eines Beschleunigers ermöglicht, die als Fragmente bezeichnet werden.

Führen Sie die folgenden Schritte aus, um auf ein Fragment in Ihrem Beschleuniger zu verweisen:

1. Veröffentlichen Sie den neuen Beschleunigertyp Fragment mithilfe des Azure-Portals oder der Azure CLI.

   • Azure portal
   • Azure-Befehlszeilenschnittstelle

   Um eine Fragmentbeschleuniger zu erstellen, öffnen Sie den Abschnitt Beschleuniger, wählen Sie Beschleuniger hinzufügen unter dem Abschnitt Benutzerdefinierte Beschleuniger und dann Fragment aus.

   

2. Ändern Sie die Datei accelerator.yaml in Ihrem Accelerator-Projekt. Verwenden Sie die imports Anweisung im accelerator Abschnitt und die InvokeFragment Anweisung im engine Abschnitt, um auf das Fragment in dem Beschleuniger zu verweisen, wie im folgenden Beispiel gezeigt:

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. Synchronisieren Sie die Änderung mit dem Dev Tools-Portal.

   Um die Änderungen im Dev Tools-Portal schneller widerzuspiegeln, können Sie einen Wert für das Feld Git-Intervall Ihres angepassten Beschleunigers angeben. Der Git-Intervallwert gibt an, wie häufig das System nach Updates im Git-Repository sucht.

4. Synchronisieren Sie die Änderung mit Ihrem benutzerdefinierten Beschleuniger im Azure-Portal mithilfe des Azure-Portals oder der Azure CLI.

   • Azure portal
   • Azure-Befehlszeilenschnittstelle

   In der folgenden Liste sind die beiden Möglichkeiten zum Synchronisieren von Änderungen aufgeführt:

   • Erstellen oder aktualisieren Sie Ihren benutzerdefinierten Beschleuniger.
   • Öffnen Sie den Abschnitt Beschleuniger", und wählen Sie dann Zertifikat synchronisieren aus.

Weitere Informationen finden Sie unter Verwenden von Fragmenten in Application Accelerator in der VMware-Dokumentation.

Verwenden von Beschleunigern zum Bootstrapieren eines neuen Projekts

Führen Sie die folgenden Schritte aus, um ein neues Projekt mithilfe von Beschleunigern zu bootstrapieren:

1. Wählen Sie auf der Seite Entwicklertools" die App Accelerator-URL aus, um das Dev Tools-Portal zu öffnen.

   

2. Wählen Sie im Dev Tools-Portal einen Beschleuniger aus.

3. Geben Sie Eingabeoptionen im Abschnitt Beschleuniger konfigurieren der Seite Beschleuniger generieren an.

   

4. Wählen Sie DATEI DURCHSUCHEN aus, um die Projektstruktur und den Quellcode anzuzeigen.

5. Wählen Sie Überprüfen und Generieren aus, um die angegebenen Parameter zu überprüfen, und wählen Sie dann Beschleuniger generieren aus.

   

6. Sie können das Projekt dann als ZIP-Datei anzeigen oder herunterladen.

   

Konfigurieren von Beschleunigern mit einem selbstsignierten Zertifikat

Wenn Sie ein privates Git-Repository einrichten und HTTPS mit einem selbstsignierten Zertifikat aktivieren, sollten Sie den Zertifikatnamen der Zertifizierungsstelle für die Clientzertifikatüberprüfung von dem Beschleuniger zum Git-Repository konfigurieren.

Führen Sie die folgenden Schritte aus, um Beschleuniger mit einem selbstsignierten Zertifikat zu konfigurieren:

1. Importieren Sie die Zertifikate in Azure Spring Apps. Weitere Informationen finden Sie im Abschnitt Importieren eines Zertifikats von Verwendung von TLS/SSL-Zertifikaten in Ihrer Anwendung in Azure Spring Apps.
2. Konfigurieren Sie das Zertifikat für den Beschleuniger mithilfe des Azure-Portals oder der Azure CLI.

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

Rotieren von Zertifikaten

Da Zertifikate ablaufen, müssen Sie Zertifikate in Spring Cloud Apps mithilfe der folgenden Schritte rotieren:

1. Generieren Sie neue Zertifikate von einer vertrauenswürdigen Zertifizierungsstelle.
2. Importieren Sie die Zertifikate in Azure Spring Apps. Weitere Informationen finden Sie im Abschnitt Importieren eines Zertifikats von Verwendung von TLS/SSL-Zertifikaten in Ihrer Anwendung in Azure Spring Apps.
3. Synchronisieren Sie die Zertifikate mithilfe des Azure-Portals oder der Azure CLI.

Die Beschleuniger verwenden nicht automatisch das neueste Zertifikat. Sie sollten ein oder alle Zertifikate über das Azure-Portal oder die Azure CLI synchronisieren.

az spring application-accelerator customized-accelerator sync-cert \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Verwalten von App Accelerator in einer vorhandenen Enterprise-Planinstanz

Sie können App Accelerator unter einer vorhandenen Azure Spring Apps Enterprise-Planinstanz mithilfe des Azure-Portals oder der Azure CLI aktivieren.

az spring application-accelerator create \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator delete \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

Verwenden von App Accelerator in VS Code

Sie können Ihr Projekt über einen beliebigen App Accelerator in einer Azure Spring Apps Enterprise-Plandienstinstanz in VS Code direkt bootstrapieren.

Anzeigen der Liste von App-Beschleunigern

Führen Sie die folgenden Schritte aus, um die Liste der App-Beschleuniger in einer Azure Spring Apps Enterprise-Plan-Dienstinstanz anzuzeigen:

1. Öffnen Sie in Visual Studio Code die Azure Spring Apps-Erweiterung, und melden Sie sich dann bei Ihrem Azure-Konto an.

2. Erweitern Sie die gewünschte Dienstinstanz, und klicken Sie mit der rechten Maustaste, um die Dienstinstanz auszuwählen.

3. Wählen Sie im Menü die Option Anwendungsbeschleuniger öffnen aus, um die Liste der App-Beschleuniger zu öffnen. Das System fordert Sie ggfs. auf, die Visual Studio Code-Erweiterung Tanzu Application Accelerator zu installieren.

   

4. Wählen Sie einen beliebigen Beschleuniger aus, um Ihr Projekt zu bootstrapieren.

   

Behandeln von App Accelerator-Problemen

Wenn Sie versuchen, App Accelerator für eine Dienstinstanz zu öffnen, die App Accelerator nicht aktiviert oder einen öffentlichen Endpunkt verfügbar gemacht hat, wird die folgende Fehlermeldung angezeigt: Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible.

Führen Sie die folgenden Schritte aus, um App Accelerator zu aktivieren und öffentliche Endpunkte verfügbar zu machen. Weitere Informationen finden Sie im Abschnitt App Accelerator in einer vorhandenen Enterprise-Planinstanz verwalten.

1. Wenn Sie einmaliges Anmelden im Dev Tools-Portal aktiviert haben, wird beim Zugriff auf die Erweiterung die folgende Meldung angezeigt: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Weitere Informationen finden Sie im Abschnitt Dev Tools-Portal konfigurierenvon Tanzu Dev Tools im Azure Spring Apps Enterprise Plan konfigurieren.

2. Wählen Sie Zulassen, dann Öffnenund dann erneut Öffnen aus, um die Liste der VS-Codeerweiterungen zu öffnen.

   

Manchmal wird möglicherweise eine Fehlermeldung wie im folgenden Beispiel angezeigt: AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

Um dieses Problem zu beheben, fügen Sie den Umleitungs-URI vscode://VMware.tanzu-app-accelerator zum relevanten Identitätsanbieter (IdP) hinzu. Wechseln Sie in der Microsoft Entra-ID zum Menü Authentifizierung, und fügen Sie Umleitungs-URIs zu mobilen und Desktopanwendungen in den Plattformkonfigurationen hinzu.

Nächste Schritte

• Azure Spring Apps