Verwalten und Verwenden von Aufträgen im Azure Spring Apps Enterprise-Plan

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für: ❎ Basic/Standard ✅ Enterprise

In diesem Artikel erfahren Sie, wie Sie den Lebenszyklus eines Auftrags verwalten und im Azure Spring Apps Enterprise-Plan ausführen.

Voraussetzungen

• Eine bereits bereitgestellte Azure Spring Apps Enterprise-Planinstanz. Weitere Informationen finden Sie unter Schnellstart: Erstellen und Bereitstellen von Anwendungen in Azure Spring Apps mit dem Enterprise Plan.

Erstellen und Bereitstellen eines Auftrags

Azure-Befehlszeilenschnittstelle

Verwenden Sie die folgenden Befehle zum Erstellen und Bereitstellen eines Auftrags:

az spring job create --name <job-name>
az spring job deploy \
    --name <job-name> \
    --artifact-path <artifact-path>

Azure portal

Führen Sie die folgenden Schritte aus, um einen Auftrag zu erstellen und bereitzustellen:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wählen Sie im Navigationsbereich Einstellungen und dann Aufträge aus.

3. Wählen Sie auf der Seite Aufträge die Option Auftrag erstellen aus.

4. Fügen Sie einen Namen für den Auftrag hinzu, und wählen Sie andere Konfigurationen aus. Wählen Sie Erstellen aus, und warten Sie, bis der Auftrag erfolgreich erstellt wurde.

5. Wählen Sie Bereitstellen aus. Ein Bereich wird geöffnet.

6. Um den Auftrag bereitzustellen, kopieren Sie die Azure CLI-Befehle im Panel, und führen Sie dann die Befehle in der Befehlszeile aus.

Für die öffentliche Vorschau können Sie maximal 10 Aufträge pro Dienstinstanz erstellen.

Starten und Abbrechen einer Auftragsausführung

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um eine Auftragsausführung zu starten:

az spring job start --name <job-name>

Wenn der Befehl erfolgreich ausgeführt wird, wird der Name der Auftragsausführung zurückgegeben. Mit dem --wait-until-finished true Parameter wird der Befehl erst zurückgegeben, wenn die Auftragsausführung abgeschlossen ist.

Verwenden Sie den folgenden Befehl, um den Status der Auftragsausführung abzufragen. Ersetzen Sie <execution-name> mit dem Namen, der vom Startbefehl zurückgegeben wird.

az spring job execution show \
    --job <job-name> \
    --name <execution-name>

Um die ausgeführten Auftragsausführungen abzubrechen, verwenden Sie den folgenden Befehl:

az spring job execution cancel \
    --job <job-name> \
    --name <execution-name>

Azure portal

Führen Sie die folgenden Schritte aus, um eine Auftragsausführung zu starten oder abzubrechen:

1. Wählen Sie auf der Seite Aufträge den Auftragsnamen aus, um die Übersichtsseite des Auftrags zu öffnen.

2. Wählen Sie Ausführen aus, um den Einstellungsbereich der Auftragsausführung zu öffnen.

3. Fügen Sie bestimmte Argumente und Umgebungsvariablen nach Bedarf für diese Ausführung hinzu. Wählen Sie Ausführen aus, um die Ausführung auszuführen.

4. Um die Auftragsausführung erneut auszuführen, wählen Sie Auftrag erneut ausführen aus, um eine neue Auftragsausführung mit derselben Konfiguration auszulösen.

5. Um die Ausführung des ausgeführten Auftrags abzubrechen, wählen Sie Auftrag abbrechen aus.

Auftragsausführungsverlauf abfragen

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um den Ausführungsverlauf anzuzeigen:

az spring job execution list --job <job-name>

Azure portal

1. Wechseln Sie zum Abschnitt Ausführungen der Übersichtsseite Aufträge.

2. Suchen Sie die neueste Auftragsausführung, und wählen Sie Ausführungsdetail anzeigen aus, um die Konfiguration sowohl auf Auftragsebene als auch auf Ausführungsebene anzuzeigen.

Für die öffentliche Vorschau werden die letzten 10 abgeschlossenen oder fehlgeschlagenen Auftragsausführungsdatensätze pro Auftrag im Verlauf aufbewahrt.

Abfragen von Auftragsausführungsprotokollen

Verwenden Sie die folgende Log Analytics-Abfrage, um den Verlauf der Auftragsausführungen im Azure-Portal abzurufen:

AppPlatformLogsforSpring
| where AppName == '<job-name>' and InstanceName startswith '<execution-name>'
| order by TimeGenerated asc

Weitere Informationen finden Sie in der Schnellstartanleitung: Einrichten eines Log Analytics-Arbeitsbereichs.

Verwenden Sie für Echtzeitprotokolle den folgenden Befehl in der Befehlszeile:

az spring job logs \
    --name <job-name> \
    --execution <execution-name>

Wenn mehrere Instanzen für die Auftragsausführung vorhanden sind, geben Sie --instance <instance-name> an, damit die Protokolle nur für eine Instanz angezeigt werden sollen.

Ausführung des Auftrags erneut ausführen

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um eine neue Auftragsausführung auszulösen:

az spring job start \
    --name <job-name> \
    --args <argument-value> \
    --envs <key=value>

Azure portal

Führen Sie die folgenden Schritte aus, um eine Auftragsausführung erneut auszuführen:

1. Öffnen Sie den Abschnitt Ausführungen der Übersichtsseite Aufträge.

2. Wählen Sie Erneut ausführen aus, um eine neue Auftragsausführung mit derselben Konfiguration wie die vorherige auszuführen.

Eine neue Auftragsausführung wird im Abschnitt Executions angezeigt.

Integration in verwaltete Komponenten

Für die öffentliche Vorschau können Aufträge nahtlos in Spring Cloud Config Server integriert werden, um eine effiziente Konfigurationsverwaltung und Tanzu Service Registry für die Dienstermittlung zu ermöglichen.

Integration mit Spring Cloud Config Server

Mit Spring Cloud Config Server können Sie die Konfigurationen oder Eigenschaften verwalten, die von einem Auftrag in Git-Repositorys benötigt werden, und sie dann in den Auftrag laden. Nachdem Sie Git-Repositorykonfigurationen für Spring Cloud Config Server eingerichtet haben, müssen Sie die Aufträge an den Server binden.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um den Auftrag während der Auftragserstellung an Spring Cloud Config Server zu binden:

az spring job create \
    --name <job-name> \
    --bind-config-server true

Verwenden Sie für vorhandene Aufträge den folgenden Befehl, um sie an Spring Cloud Config Server zu binden:

az spring config-server bind --job <job-name>

Azure portal

Führen Sie die folgenden Schritte aus, um den Auftrag während der Auftragserstellung an Spring Cloud Config Server zu binden:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wählen Sie im Navigationsbereich Auftrag aus.

3. Wählen Sie Auftrag erstellen aus, und wählen Sie dann im Abschnitt Binden Spring Cloud Config Server aus.

4. Wählen Sie Erstellen aus, um den Erstellungsprozess zu starten.

Führen Sie für vorhandene Aufträge die folgenden Schritte aus, um sie an Spring Cloud Config Server zu binden:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wechseln Sie im Navigationsbereich zum Abschnitt Verwaltete Komponenten, und wählen Sie dann Spring Cloud Config Server aus.

3. Wenn die Komponente deaktiviert ist, wählen Sie Verwalten aus, um sie zu aktivieren.

4. Konfigurieren Sie auf der Registerkarte Einstellungen Spring Cloud Config Server mit dem richtigen Git-Repository. Wählen Sie Überprüfen und dann Übernehmen aus.

5. Wählen Sie auf der Registerkarte Auftragsbindung die Option Auftrag binden und dann den Auftrag aus, der angewendet werden soll.

   Nachdem der Auftrag erfolgreich gebunden wurde, wird der Auftragsname in der Liste angezeigt.

6. Führen Sie den Auftrag aus.

Wenn Sie Spring Cloud Config Server nicht mehr für Ihre Aufträge benötigen, können Sie die Bindung aufheben. Diese Änderung wirkt sich auf neue Auftragsausführungen aus.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um die Bindung eines Auftrags aufzuheben:

az spring config-server unbind --job <job-name>

Azure portal

Führen Sie die folgenden Schritte aus, um die Bindung eines Auftrags aufzuheben:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wechseln Sie im Navigationsbereich zum Abschnitt Verwaltete Komponenten, und wählen Sie dann Spring Cloud Config Server aus.

3. Wählen Sie auf der Registerkarte Auftragsbindung den Auftrag aus, für den Sie die Bindung aufheben müssen.

4. Wählen Sie Nicht gebundener Auftrag aus.

Integration in Tanzu Service-Registrierung

Es ist üblich, dass ein Auftrag eine API aus einer lang ausgeführten App in Zusammenarbeit aufruft, um Informationen, Benachrichtigungen usw. abzufragen. Damit der Auftrag Apps ermitteln kann, die im selben Azure Spring Apps-Dienst ausgeführt werden, können Sie sowohl Ihre Apps als auch Aufträge an eine Registrierung für verwaltete Dienste binden. Im folgenden Abschnitt wird beschrieben, wie Sie einen Auftrag an Tanzu Service Registry binden.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um einen Auftrag während der Auftragserstellung an Tanzu Service Registry zu binden:

az spring job create --bind-service-registry true

Verwenden Sie für vorhandene Aufträge den folgenden Befehl, um sie an die Tanzu Service Registry zu binden:

az spring service-registry bind --job <job-name>

Azure portal

Führen Sie die folgenden Schritte aus, um einen Auftrag während der Auftragserstellung an Tanzu Service Registry zu binden:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wechseln Sie im Navigationsbereich zum Abschnitt Verwaltete Komponenten, und wählen Sie dann Dienstregistrierung aus.

3. Wenn die Komponente deaktiviert ist, wählen Sie Verwalten aus, um sie zu aktivieren.

4. Wählen Sie auf der Registerkarte Auftragsbindung die Option Auftrag binden und dann den Auftrag aus, der angewendet werden soll.

   Nachdem der Auftrag erfolgreich gebunden wurde, wird der Auftragsname in der Liste angezeigt.

5. Führen Sie den Auftrag aus.

Führen Sie für vorhandene Aufträge die folgenden Schritte aus, um sie an die Tanzu Service Registry zu binden:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wechseln Sie im Navigationsbereich zum Abschnitt Verwaltete Komponenten, und wählen Sie dann Dienstregistrierung aus.

3. Wenn die Komponente deaktiviert ist, wählen Sie Verwalten aus, um sie zu aktivieren.

4. Wählen Sie auf der Registerkarte Auftragsbindung die Option Auftrag binden und dann den Auftrag aus, der angewendet werden soll.

   Nachdem der Auftrag erfolgreich gebunden wurde, wird der Auftragsname in der Liste angezeigt.

5. Führen Sie den Auftrag aus.

Wenn Sie die Auftragsausführung ausführen, kann sie über die Dienstregistrierung auf Endpunkte registrierter Apps zugreifen.

Wenn Sie die Dienstregistrierung für Ihre Aufträge nicht mehr benötigen, können Sie sie daraus aufheben. Diese Änderung wirkt sich auf neue Auftragsausführungen aus.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um die Bindung des Auftrags aufzuheben:

az spring service-registry unbind --job <job-name>

Azure portal

Führen Sie die folgenden Schritte aus, um die Bindung des Auftrags aufzuheben:

1. Öffnen Sie Ihre Azure Spring Apps-Dienstinstanz.

2. Wechseln Sie im Navigationsbereich zum Abschnitt Verwaltete Komponenten, und wählen Sie dann Dienstregistrierung aus.

3. Wählen Sie auf der Registerkarte Auftragsbindung den Auftrag aus, für den Sie die Bindung aufheben müssen.

4. Wählen Sie Nicht gebundener Auftrag aus.

Weitere Informationen

Auftrag in Azure Spring Apps