Uw eigen permanente opslag inschakelen in Azure Spring Apps

Notitie

De Basic, Standarden Enterprise--plannen zijn op 17 maart 2025 buiten gebruik gesteld. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Dit artikel is van toepassing op:✅ Java ✅ C#

Dit artikel is van toepassing op:✅ Basic/Standard ✅ Enterprise

In dit artikel leest u hoe u uw eigen permanente opslag inschakelt in Azure Spring Apps.

Wanneer u de ingebouwde permanente opslag in Azure Spring Apps gebruikt, worden artefacten die door uw toepassing worden gegenereerd, geüpload naar Azure Storage-accounts. Microsoft bepaalt het beleid voor versleuteling-at-rest- en levensduurbeheer voor deze artefacten.

Wanneer u uw eigen permanente opslag gebruikt, worden artefacten die door uw toepassing worden gegenereerd, geüpload naar een opslagaccount dat u beheert. U bepaalt het versleutelings-at-rest-beleid, het beleid voor levensduurbeheer en netwerktoegang. U bent verantwoordelijk voor de kosten die zijn gekoppeld aan dat opslagaccount.

Voorwaarden

Een bestaand Azure Storage-account en een bestaande Azure-bestandsshare. Als u een opslagaccount en bestandsshare in Azure wilt maken, raadpleegt u de pagina Een SMB Azure-bestandsshare maken.
Azure CLI, versie 2.45.0 of hoger.

Belangrijk

Als u uw Azure Spring Apps hebt geïmplementeerd in uw eigen virtuele netwerk en u wilt dat het opslagaccount alleen toegankelijk is vanuit het virtuele netwerk, raadpleegt u Privé-eindpunten gebruiken voor Azure Storage en de sectie Toegang verlenen vanuit een virtueel netwerk van Azure Storage-firewalls en virtuele netwerken configureren.

Uw eigen extra permanente opslag koppelen aan toepassingen

Notitie

Als u permanente opslag bijwerkt, worden uw toepassingen opnieuw opgestart.

Wanneer u integratie van virtuele netwerken gebruikt, moet u ervoor zorgen dat de poorten 80 en 445 geopend zijn.

Azure-portal
Azure-CLI

Gebruik de volgende stappen om een Azure Storage-account te binden als een opslagresource in uw Azure Spring Apps en een app te maken met uw eigen permanente opslag.

Ga naar de pagina Overzicht van de service en selecteer Vervolgens Opslag in het navigatiedeelvenster aan de linkerkant.
Selecteer Opslag toevoegen op de pagina Opslag.

Voer de volgende informatie in op de pagina Opslag toevoegen en selecteer Toepassen.

Instelling	Waarde
Opslagnaam	De naam van de opslagresource, een resource op serviceniveau in Azure Spring Apps.
Accountnaam	De naam van het opslagaccount.
Accountsleutel	De opslagaccountsleutel.

Ga naar de pagina Apps en selecteer vervolgens een toepassing om de permanente opslag te koppelen.
Selecteer Configuratie en selecteer vervolgens Permanente opslag.

Selecteer Permanente opslag toevoegen. Voeg de waarden toe in de volgende tabel en selecteer Toepassen.

Instelling	Waarde
Opslagnaam	De naam van de opslagresource die u eerder hebt ingevoerd.
Permanent opslagtype	AzureFileVolume
Naam delen	De naam van de Azure-bestandsshare in het Azure Storage-account.
Koppelingspad	Een uniek mountpad.
Koppelingsopties	Optioneel
Alleen lezen	Optioneel

Selecteer Opslaan om de configuratiewijzigingen toe te passen.

Gebruik de volgende stappen om uw eigen opslag in te schakelen met de Azure CLI.

Gebruik de volgende opdracht om uw Azure Storage-account te binden als een opslagresource in uw Azure Spring Apps-exemplaar.

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>

Gebruik de volgende opdracht om een app te maken met uw eigen permanente opslag.

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 het volgende voorbeeld ziet u een JSON-bestand dat wordt doorgegeven aan de --persistent-storage parameter.

{
   "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
          }
      }
   ]
}

Gebruik desgewenst de volgende opdracht om extra permanente opslag toe te voegen aan een bestaande app.

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>

Gebruik eventueel de volgende opdracht om de bestaande permanente opslag van een specifieke opslagresource weer te geven.

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

Beste praktijken

Gebruik de volgende aanbevolen procedures wanneer u uw eigen permanente opslag toevoegt aan Azure Spring Apps.

Als u potentiële latentieproblemen wilt voorkomen, plaatst u het Azure Spring Apps-exemplaar en het Azure Storage-account in dezelfde Azure-regio.
Vermijd het opnieuw genereren van de accountsleutel die u gebruikt in het Azure Storage-account. Het opslagaccount bevat twee verschillende sleutels. Gebruik een stapsgewijze benadering om ervoor te zorgen dat de permanente opslag beschikbaar blijft voor toepassingen tijdens het genereren van de sleutel.

Gebruik bijvoorbeeld de volgende stappen om ervoor te zorgen dat de permanente opslag beschikbaar blijft als u key1 een opslagaccount hebt gekoppeld aan Azure Spring Apps.
1. Opnieuw genereren key2.
2. Werk de accountsleutel van de opslagresource bij om de opnieuw gegenereerde key2resource te gebruiken.
3. Start de toepassingen die de permanente opslag koppelen vanuit deze opslagresource opnieuw. Gebruik de az spring storage list-persistent-storage opdracht om alle gerelateerde toepassingen weer te geven.
4. Opnieuw genereren key1.
Als u een Azure Storage-account of Azure-bestandsshare verwijdert, voorkomt u mogelijke fouten door de bijbehorende opslagresource of permanente opslag in de toepassingen te verwijderen.
Als u bestanden naar hetzelfde pad wilt schrijven voor elk afzonderlijk toepassingsexemplaren, maar deze in afzonderlijke submappen wilt bewaren vanuit het perspectief van de bestandsshare, kunt u de SubPath optie gebruiken. Houd er rekening mee dat de SubPath optie niet compatibel is met Read only omdat SubPath deze wordt gebruikt voor het schrijven van nieuwe bestanden en Read only wordt gebruikt voor het lezen van bestaande bestanden.

Veelgestelde vragen

In deze sectie vindt u veelgestelde vragen over het gebruik van uw eigen permanente opslag met Azure Spring Apps.

Als ik ingebouwde permanente opslag heb ingeschakeld en ik mijn eigen opslag heb ingeschakeld als extra permanente opslag, worden mijn gegevens gemigreerd naar mijn Azure Storage-account?

Nee Maar we gaan binnenkort een document leveren om u te helpen bij het uitvoeren van de migratie.
Wat zijn de gereserveerde koppelpaden?

Azure Spring Apps reserveert de volgende mount paths:
- /Tmp
- /hardnekkig
- /Geheimen
- /app-insights/agents
- /etc/azure-spring-cloud/certs
- /app-insights/agents/instellingen
- /app-lifecycle/settings
Wat zijn de beschikbare koppelingsopties?

Momenteel worden de volgende koppelingsopties ondersteund:
- uid
- gid
- file_mode
- dir_mode
De mountOptions eigenschap is optioneel. De standaardwaarden voor deze koppelopties zijn: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]
Ik gebruik het service-eindpunt om het opslagaccount zo te configureren dat alleen toegang vanuit mijn eigen virtuele netwerk is toegestaan. Waarom heb ik een fout 'Machtiging geweigerd ' ontvangen toen ik probeerde aangepaste permanente opslag aan mijn toepassingen te koppelen?

Een service-eindpunt biedt alleen netwerktoegang op subnetniveau. Zorg ervoor dat u beide subnetten die door het Azure Spring Apps-exemplaar worden gebruikt, hebt toegevoegd aan het bereik van het service-eindpunt.

Volgende stappen

Feedback

Is deze pagina nuttig?

Last updated on 2025-08-19