Aktivieren des eigenen persistenten Speichers in Azure Spring Apps

Hinweis

Azure Spring Apps ist der neue Name für den Azure Spring Cloud-Dienst. Obwohl der Dienst umbenannt wurde, wird der alte Name noch an einigen Stellen verwendet, solange wir Ressourcen wie Screenshots, Videos und Diagramme aktualisieren.

Dieser Artikel gilt für: ✔️ Java ✔️ C#

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

In diesem Artikel erfahren Sie, wie Sie Ihren eigenen persistenten Speicher in Azure Spring Apps aktivieren.

Wenn Sie den integrierten persistenten Speicher in Azure Spring Apps verwenden, werden von Ihrer Anwendung generierte Artefakte in Azure Storage Accounts hochgeladen. Microsoft bestimmt die Richtlinien zur Verschlüsselung ruhender Daten und zur Verwaltung der Lebensdauer für diese Artefakte.

Mit Bring Your Own Storage werden diese Artefakte in ein Speicherkonto hochgeladen, das Ihrer Kontrolle unterliegt. Das bedeutet, dass Sie die Richtlinie zur Verschlüsselung ruhender Daten, die Richtlinie zur Verwaltung der Lebensdauer und den Netzwerkzugriff festlegen. Sie sind jedoch auch für die mit diesem Speicherkonto verbundenen Kosten verantwortlich.

Voraussetzungen

• Ein vorhandenes Azure Storage-Konto und eine vorab erstellte Azure-Dateifreigabe. Wenn Sie ein Speicherkonto und eine Dateifreigabe in Azure erstellen müssen, finden Sie Informationen dazu unter Erstellen einer Azure-Dateifreigabe.
• Die Azure Spring Apps-Erweiterung für die Azure-Befehlszeilenschnittstelle

Wichtig

Wenn Sie Ihre Azure Spring Apps in Ihrem eigenen virtuellen Netzwerk bereitgestellt haben und festlegen möchten, dass nur über das virtuelle Netzwerk auf das Speicherkonto zugegriffen werden kann, lesen Sie die folgende Anleitung:

• Verwenden privater Endpunkte für Azure Storage
• Konfigurieren von Azure Storage-Firewalls und virtuellen Netzwerken, insbesondere der Abschnitt Gewähren des Zugriffs aus einem virtuellen Netzwerk mithilfe eines Dienstendpunkts

Einbinden eines eigenen zusätzlichen beständigen Speichers in Anwendungen

Hinweis

Die Aktualisierung des beständigen Speichers führt zum Neustart von Anwendungen.

Portal

Führen Sie die folgenden Schritte aus, um ein Azure Storage-Konto als Speicherressource in Azure Spring Apps einzubinden und eine App mit Ihrem eigenen beständigen Speicher zu erstellen.

1. Navigieren Sie zur Seite Übersicht des Diensts, und wählen Sie im linken Navigationsbereich Speicher aus.

2. Wählen Sie auf der Seite Speicher die Option Speicher hinzufügen aus, fügen Sie die Werte in der folgenden Tabelle hinzu, und wählen Sie dann Anwenden aus.

   Einstellung	Wert
   Speichername	Der Name der Speicherressource, bei der es sich um eine Ressource auf Dienstebene in Azure Spring Apps handelt.
   Kontoname	Der Name des Speicherkontos.
   Kontoschlüssel	Der Speicherkontoschlüssel.

   

3. Navigieren Sie zur Seite Apps, und wählen Sie dann eine Anwendung aus, um den beständigen Speicher einzubinden.

   

4. Wählen Sie Konfiguration und dann Beständiger Speicher aus.

5. Wählen Sie Add perstistent storage (Beständigen Speicher hinzufügen) aus, fügen Sie die Werte in der folgenden Tabelle hinzu, und wählen Sie dann Anwenden aus.

   Einstellung	Wert
   Speichername	Der Name der Speicherressource, die Sie zuvor eingegeben haben
   Persistent storage type (Typ des beständigen Speichers)	AzureFileVolume
   Freigabename	Der Name der Azure-Dateifreigabe im Azure Storage-Konto
   Einbindungspfad	Ein eindeutiger Einbindungspfad
   Einbindungsoptionen	Optional
   Nur Lesezugriff	Optional

   

6. Wählen Sie Speichern aus, um alle Konfigurationsänderungen zu übernehmen.

   

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Sie können Ihren eigenen Speicher mit der Azure CLI aktivieren, indem Sie die folgenden Schritte ausführen.

1. Verwenden Sie den folgenden Befehl, um Ihr Azure Storage-Konto als Speicherressource in Ihre Azure Spring Apps-Instanz einzubinden:

   az spring storage add \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <storage-resource-name> \
      --storage-type StorageAccount \
      --account-name <account-name> \
      --account-key <account-key>
   

2. Verwenden Sie den folgenden Befehl, um eine App mit Ihrem eigenen persistenten Speicher zu erstellen.

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --persistent-storage <path-to-JSON-file>
   

   In diesem Beispiel sehen sie die JSON-Datei, die im Create-Befehl an den Parameter --persistent-storage übergeben wird:

   {
      "customPersistentDisks": [
         {
             "storageName": "<storage-resource-name>",
             "customPersistentDiskProperties": {
                 "type": "AzureFileVolume",
                 "shareName": "<Azure-file-share-name>",
                 "mountPath": "<unique-mount-path>",
                 "mountOptions": [
                     "uid=0",
                     "gid=0"
                  ],
                  "readOnly": false 
               }
         },
         {
             "storageName": "<storage-resource-name>",
             "customPersistentDiskProperties": {
                 "type": "AzureFileVolume",
                 "shareName": "<Azure-file-share-name>",
                 "mountPath": "<unique-mount-path>",
                 "readOnly": true
             }
         }
      ]
   }
   

3. Fügen Sie optional einer vorhandenen App mithilfe des folgenden Befehls zusätzlichen persistenten Speicher hinzu:

   az spring app append-persistent-storage \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --persistent-storage-type AzureFileVolume \
       --share-name <Azure-file-share-name> \
       --mount-path <unique-mount-path> \
       --storage-name <storage-resource-name>
   

4. Listen Sie optional den gesamten vorhandenen persistenten Speicher einer bestimmten Speicherressource mit dem folgenden Befehl auf:

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

Verwenden von Best Practices

Verwenden Sie die folgenden bewährten Methoden beim Hinzufügen Ihres eigenen beständigen Speichers zu Azure Spring Apps.

• Um potenzielle Latenzprobleme zu vermeiden, platzieren Sie die Azure Spring Apps-Instanz und das Azure Storage-Konto in derselben Azure-Region.

• Vermeiden Sie es im Azure Storage-Konto, den verwendeten Kontoschlüssel neu zu generieren. Das Speicherkonto enthält zwei verschiedene Schlüssel. Verwenden Sie einen Schritt-für-Schritt-Ansatz, um sicherzustellen, dass der beständige Speicher während der Schlüsselneugenerierung für die Anwendungen verfügbar bleibt.

  Angenommen, Sie haben „key1“ verwendet, um ein Speicherkonto an Azure Spring Apps zu binden, und führen dann die folgenden Schritte aus:

  1. Generieren Sie key2 neu.
  2. Aktualisieren Sie den Kontoschlüssel der Speicherressource, um den neu generierten „key2“ zu verwenden.
  3. Starten Sie die Anwendungen neu, die den persistenten Speicher aus dieser Speicherressource einbinden. (Sie können az spring storage list-persistent-storage verwenden, um alle zugehörigen Anwendungen aufzulisten.)
  4. Generieren Sie key1 neu.

• Wenn Sie ein Azure Storage-Konto oder eine Azure-Dateifreigabe löschen, entfernen Sie die entsprechende Speicherressource oder den persistenten Speicher in den Anwendungen, um mögliche Fehler zu vermeiden.

Häufig gestellte Fragen

Im Folgenden finden Sie häufig gestellte Fragen (FAQ) zur Verwendung Ihres eigenen persistenten Speichers mit Azure Spring Apps.

• Werden meine Daten in mein Storage-Konto migriert, wenn ich den integrierten persistenten Speicher aktiviert habe und dann zusätzlich meinen eigenen Speicher als zusätzlichen persistenten Speicher aktiviert habe?

  Nein. In Kürze wird jedoch ein Dokument bereitgestellt, das Sie dabei unterstützt, die Migration selbst durchzuführen.

• Was sind die reservierten Bereitstellungspfade?

  Diese Bereitstellungspfade werden vom Azure Spring Apps-Dienst reserviert:

  • /tmp
  • /persistent
  • /secrets
  • /app-insights/agents
  • /etc/azure-spring-cloud/certs
  • /app-insights/agents/settings
  • /app-lifecycle/settings

• Welche Bereitstellungsoptionen sind verfügbar?

  Derzeit werden die folgenden Bereitstellungsoptionen unterstützt:

  • uid
  • gid
  • file_mode
  • dir_mode

  Die mountOptions-Eigenschaft ist optional. Die Standardwerte für die oben genannten Einbindungsoptionen sind: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"].

• Ich verwendet den Dienstendpunkt, um das Speicherkonto so zu konfigurieren, dass der Zugriff nur über mein eigenes virtuelles Netzwerk zulässig ist. Warum habe ich beim Versuch, benutzerdefinierten persistenten Speicher in meinen Anwendungen bereitzustellen, den Fehler Berechtigung verweigert erhalten?

  Ein Dienstendpunkt bietet nur Netzwerkzugriff auf Subnetzebene. Stellen Sie sicher, dass Sie beide Subnetze, die von der Azure Spring Apps-Instanz verwendet werden, dem Bereich des Dienstendpunkts hinzugefügt haben.

Nächste Schritte

• Verwenden von Logback zum Schreiben von Protokollen in benutzerdefinierten persistenten Speicher
• Skalieren einer Anwendung in Azure Spring Apps