App und Bereitstellung in Azure Spring Apps

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:✅️ Java ✅ C#

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

App und Bereitstellung sind die beiden wichtigsten Konzepte im Ressourcenmodell von Azure Spring Apps. In Azure Spring Apps ist eine App eine Abstraktion einer Geschäftsanwendung. Eine Version des Codes oder der Binärdatei, die als die App bereitgestellt wird, wird in einer Bereitstellung ausgeführt. Apps werden in einer Azure Spring Apps-Dienstinstanz (kurz Dienstinstanz) ausgeführt, wie im Folgenden beschrieben.

Sie können über mehrere Dienstinstanzen innerhalb eines einzelnen Azure-Abonnements verfügen, es ist jedoch am einfachsten, wenn sich alle Apps, aus denen eine Geschäftsanwendung besteht, innerhalb einer einzelnen Azure Spring Apps-Dienstinstanz befinden. Ein Grund dafür ist, dass die Apps wahrscheinlich miteinander kommunizieren. Dazu können sie ganz einfach die Eureka-Dienstregistrierung in der Dienstinstanz verwenden.

Der Standard-Plan von Azure Spring Apps lässt zu, dass eine App über eine Produktionsbereitstellung und eine Stagingbereitstellung verfügt, und ermöglicht Ihnen dadurch eine einfache Blau-Grün-Bereitstellung.

App

Die folgenden Features/Eigenschaften werden auf App-Ebene definiert.

Features	Beschreibung
Öffentlicher Endpunkt	Die URL für den Zugriff auf die App
Benutzerdefinierte Domäne	Der CNAME-Eintrag, der die benutzerdefinierte Domäne absichert
Dienst bindung	Die standardmäßige Verbindung mit anderen Azure-Diensten
Verwaltete Identität	Die verwaltete Identität von Microsoft Entra ID ermöglicht es Ihrer App, einfach auf andere durch Microsoft Entra geschützte Ressourcen wie Azure Key Vault zuzugreifen.
Dauerhafte Speicherung	Die Einstellung, die es ermöglicht, dass Daten nach dem Neustart der App beibehalten werden können.

Bereitstellung

Die folgenden Features/Eigenschaften werden auf der Bereitstellungsebene definiert und beim Wechsel der Produktions- und Stagingbereitstellung ausgetauscht.

Features	Beschreibung
CPU	Die Anzahl der virtuellen Kerne pro App-Instanz
Arbeitsspeicher	GB an Arbeitsspeicher pro App-Instanz
Instanzen anzahl	Die Anzahl der App-Instanzen, manuell oder automatisch festgelegt
Automatische Skalierung	Die Anzahl der Skalierungsinstanzen, automatisch auf vordefinierten Regeln und Zeitplänen basierend
JVM -Optionen	Die festzulegenden JVM-Optionen
Umgebungs variablen	Die festzulegenden Umgebungsvariablen
Runtime -Version	Entweder Java 8 oder Java 11

Environment

Azure Spring Apps bindet einige schreibgeschützte YAML-Dateien in Ihre bereitgestellten Apps ein. Diese Dateien enthalten den Azure-Kontext einer Bereitstellung. In der folgenden Liste sind die Pfade und Inhalte dieser YAML-Dateien aufgeführt:

• /etc/azure-spring-cloud/context/azure-spring-apps.yml

  YAML

  AZURE_SPRING_APPS:
      SUBSCRIPTION_ID:  <your-azure-subscription-id>
      RESOURCE_GROUP: <your-resource-group-name>
      NAME: <your-azure-spring-apps-name>
  

• /etc/azure-spring-cloud/context/azure-spring-apps-deployment.yml

  YAML

  AZURE_SPRING_APPS:
       APP:
          NAME: <your-app-name>
       DEPLOYMENT:
          NAME: <your-deployment-name>
          ACTIVE: true # true if the deployment is in production, false if in staging
  

Wenn es sich bei Ihrer App um eine Spring Boot-App handelt, werden diese beiden Dateipfade der Umgebungsvariablen SPRING_CONFIG_ADDITIONAL_LOCATION hinzugefügt. Auf diese Weise kann Ihre App diese Eigenschaften als Konfigurationen laden und in Ihrem Code verwenden. Sie können beispielsweise die Anmerkung @ConfigurationProperties verwenden, um die YAML-Eigenschaften an eine Java-Klasse zu binden. Der folgende Codeschnipsel zeigt, wie Sie eine @Configuration-Klasse erstellen, die den Azure-Kontext darstellt:

Java

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConfigurationProperties(prefix = "azure-spring-apps")
@Data
public class AzureSpringAppsContext {

    private String subscriptionId;
    private String resourceGroup;
    private String name;

    private AppContext app;
    private DeploymentContext deployment;

    @Data
    public static class AppContext {
        private String name;
    }

    @Data
    public static class DeploymentContext {
        private String name;
        private boolean active;
    }
}

Bei anderen mehrsprachigen Apps müssen Sie möglicherweise entsprechende Eigenschaften lesen und darauf zugreifen, indem Sie die entsprechenden Bibliotheken zum Lesen/Schreiben von Dateien in Ihren Apps verwenden.

Beschränkungen

• Eine App muss eine Produktionsbereitstellung besitzen. Die API blockiert das Löschen einer Produktionsbereitstellung. Sie sollten eine Bereitstellung mit Staging austauschen, bevor Sie sie löschen.
• Eine App kann höchstens zwei Bereitstellungen besitzen. Die API blockiert die Erstellung von mehr als zwei Bereitstellungen. Stellen Sie Ihre neue Binärdatei entweder in der vorhandenen Produktions- oder der Stagingbereitstellung bereit.
• Die Bereitstellungsverwaltung ist im Plan „Basic“ nicht verfügbar. Verwenden Sie den Standard- oder Enterprise-Plan, um die Funktion für die Blau-Grün-Bereitstellung nutzen zu können.

Nächste Schritte

• Einrichten einer Stagingumgebung in Azure Spring Apps