Uw eigen permanente opslag inschakelen in Azure Spring Apps

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

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.

Vereisten

• Een bestaand Azure Storage-account en een bestaande Azure-bestandsshare. Als u een opslagaccount en bestandsshare in Azure wilt maken, raadpleegt u 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

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.

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

2. Selecteer Opslag toevoegen op de pagina Opslag.

   

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

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

   

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

   

5. Selecteer Configuratie en selecteer vervolgens Permanente opslag.

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

   Instelling	Weergegeven als
   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 koppelpad.
   Koppelingsopties	Optioneel
   Alleen-lezen	Optioneel

   

7. Selecteer Opslaan om de configuratiewijzigingen toe te passen.

   

Azure-CLI

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

1. 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>
   

2. 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
             }
         }
      ]
   }
   

3. 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>
   

4. 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>
   

Aanbevolen procedures

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 hebt gebruikt om een opslagaccount te binden aan Azure Spring Apps.

  1. Genereer sleutel2 opnieuw.
  2. Werk de accountsleutel van de opslagresource bij om de opnieuw gegenereerde sleutel2 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. Genereer sleutel1 opnieuw.

• 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 optie SubPath gebruiken. Houd er rekening mee dat de optie SubPath niet compatibel is met alleen-lezen omdat SubPath wordt gebruikt voor het schrijven van nieuwe bestanden en alleen-lezen 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 een document opgeven om u snel te helpen bij het uitvoeren van de migratie.

• Wat zijn de gereserveerde koppelpaden?

  Azure Spring Apps reserveert de volgende koppelpaden:

  • /Tmp
  • /Persistent
  • /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

• Logback gebruiken om logboeken naar aangepaste permanente opslag te schrijven.
• Een toepassing schalen in Azure Spring Apps.