Freigeben über

Tutorial: Bereitstellen einer Anwendung in Azure Spring Apps und Herstellen einer Verbindung mit Azure Database for MySQL Flexible Server mithilfe eines Dienstconnectors

  • Artikel

In diesem Tutorial führen Sie die folgenden Aufgaben im Azure-Portal oder mit der Azure CLI aus. Beide Methoden werden in den folgenden Verfahren näher beschrieben.

  • Bereitstellen einer Instanz von Azure Spring Apps
  • Erstellen und Bereitstellen von Apps in Azure Spring Apps
  • Integrieren von Azure Spring Apps in Azure Database for MySQL mit dem Dienstconnector

Voraussetzungen

Bereitstellen einer Instanz von Azure Spring Apps

Im folgenden Verfahren verwenden Sie die Azure CLI-Erweiterung zum Bereitstellen einer Azure Spring Apps-Instanz.

  1. Aktualisieren der Azure CLI mit der Azure Spring Apps-Erweiterung.

    az extension update --name spring

  2. Melden Sie sich bei der Azure CLI an, und wählen Sie Ihr aktives Abonnement aus.

    az login
az account list -o table
az account set --subscription <Name or ID of subscription, skip if you only have 1 subscription>

  3. Erstellen einer Ressourcengruppe zur Aufnahme Ihrer App und einer Instanz des Azure Spring Apps-Diensts.

    az group create --name ServiceConnector-tutorial-mysqlf --location eastus

  4. Erstellen Sie eine Instanz von Azure Spring Apps. Deren Name muss zwischen 4 und 32 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen des Namens der Azure Spring Apps-Instanz muss ein Buchstabe und das letzte Zeichen entweder ein Buchstabe oder eine Ziffer sein.

    az spring create -n my-azure-spring -g ServiceConnector-tutorial-mysqlf

Erstellen einer Instanz von Azure Database for MySQL Flexible Server

Erstellen einer MySQL Flexible Server-Instanz. Ersetzen Sie im folgenden Befehl <admin-username> und <admin-password> durch Anmeldeinformationen Ihrer Wahl, um einen Administratorbenutzer für den flexiblen MySQL-Server zu erstellen. Der Administratorbenutzername darf nicht azure_superuser, azure_pg_admin, admin, administrator, root, guest oder public lauten. Er kann nicht mit pg_ beginnen. Das Kennwort muss zwischen 8 und 128 Zeichen aus drei der folgenden Kategorien enthalten: englische Großbuchstaben, englische Kleinbuchstaben, Zahlen und nicht alphanumerische Zeichen (z. B. !, #, %). Das Kennwort darf keinen username enthalten.

az mysql flexible-server create \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --name mysqlf-server \
    --database-name mysqlf-db \
    --admin-user <admin-username> \
    --admin-password <admin-password>

Der Server wird mit den folgenden Standardwerten erstellt, sofern Sie diese nicht manuell überschreiben:

Einstellung Standardwert Beschreibung
Servername Systemgeneriert Ein eindeutiger Name, der Ihren Server für Azure-Datenbank für MySQL identifiziert.
sku-name GP_Gen5_2 Der Name der SKU. Folgt der Konvention „{Tarif}_{Computegeneration}_{virtuelle Kerne}“ in Kurzform. Der Standardwert ist ein Gen5-Server vom Typ „Universell“ mit zwei virtuellen Kernen. Weitere Informationen zu Preisen finden Sie auf unserer Seite mit den Preisen.
backup-retention 7 Gibt die Aufbewahrungsdauer für eine Sicherung an. Die Einheit ist Tage.
geo-redundant-backup Disabled Gibt an, ob georedundante Sicherungen für diesen Server aktiviert werden sollen.
location westus2 Der Azure-Standort für den Server.
ssl-enforcement Aktiviert Gibt an, ob SSL für diesen Server aktiviert werden soll.
storage-size 5120 Die Speicherkapazität des Servers (Einheit: MB).
version 5.7 Die MySQL-Hauptversion.

Hinweis

Standardmäßig wird die SKU „Standard_B1ms“ verwendet. Informationen zu Preisen finden Sie unter Azure Database for MySQL – Preise.

Hinweis

Weitere Informationen zum Befehl az mysql flexible-server create und den zugehörigen zusätzlichen Parametern finden Sie in der Dokumentation der Azure-Befehlszeilenschnittstelle.

Erstellen und Bereitstellen der App

  1. Erstellen Sie die App mit einem zugewiesenen öffentlichen Endpunkt. Wenn Sie beim Generieren des Azure Spring Apps-Projekts Java Version 11 ausgewählt haben, schließen Sie den Schalter --runtime-version=Java_11 ein.

    az spring app create -n hellospring -s my-azure-spring -g ServiceConnector-tutorial-mysqlf --assign-endpoint true

  2. Führen Sie den Befehl az spring connection create aus, um die in Azure Spring Apps bereitgestellte Anwendung mit der MySQL Flexible Server-Datenbank zu verbinden. Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Informationen:

    az spring connection create mysql-flexible \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --service my-azure-spring \
    --app hellospring \
    --target-resource-group ServiceConnector-tutorial-mysqlf \
    --server mysqlf-server \
    --database mysqlf-db \
    --secret name=<admin-username> secret=<admin-secret>
    Einstellung Beschreibung
    --resource-group Der Name der Ressourcengruppe, die die von Azure Spring Apps gehostete App enthält
    --service Der Name der Azure Spring Apps-Ressource
    --app Der Name der von Azure Spring Apps gehosteten Anwendung, die eine Verbindung mit dem Zieldienst herstellt
    --target-resource-group Der Name der Ressourcengruppe mit dem Speicherkonto.
    --server Der flexible MySQL-Server, mit dem Sie eine Verbindung herstellen möchten.
    --database Der Name der Datenbank, die Sie zuvor erstellt haben
    --secret name Der Benutzername des flexiblen MySQL-Servers.
    --secret Das Kennwort des flexiblen MySQL-Servers.

    Hinweis

    Wird die Fehlermeldung „Das Abonnement ist nicht für die Verwendung des Ressourcenanbieters "{0}" registriert.“ angezeigt, führen Sie az provider register -n Microsoft.ServiceLinker aus, um den Dienstconnector-Ressourcenanbieter zu registrieren. Führen Sie anschließend erneut den Verbindungsbefehl aus.

  3. Klonen des Beispielcodes

    git clone https://github.com/Azure-Samples/serviceconnector-springcloud-mysql-springboot.git

  4. Erstellen Sie das Projekt mithilfe von Maven:

    cd serviceconnector-springcloud-mysql-springboot
mvn clean package -DskipTests

  5. Stellen Sie die JAR-Datei target/demo-0.0.1-SNAPSHOT.jar für die App bereit.

    az spring app deploy \
    --name hellospring \
    --service my-azure-spring \
    --resource-group ServiceConnector-tutorial-mysqlf \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

  6. Fragen Sie den App-Status nach der Bereitstellung mit dem folgenden Befehl ab:

    az spring app list  --resource-group ServiceConnector-tutorial-mysqlf --service my-azure-spring --output table

    Die folgende Ausgabe sollte angezeigt werden:

    Name         Location    ResourceGroup                     Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
-----------  ----------  --------------------------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
hellospring  eastus      ServiceConnector-tutorial-mysqlf  https://my-azure-spring-hellospring.azuremicroservices.io  default                  Succeeded             1      1Gi       1/1                 0/1                    -                     -

Nächste Schritte

Befolgen Sie die unten aufgeführten Tutorials, um mehr über Service Connector zu erfahren.

Informationen zu Service Connector-Konzepten