Så här aktiverar du din egen beständiga lagring i Azure Spring Apps

Kommentar

Azure Spring Apps är det nya namnet på Azure Spring Cloud-tjänsten. Även om tjänsten har ett nytt namn ser du det gamla namnet på vissa platser ett tag medan vi arbetar med att uppdatera tillgångar som skärmbilder, videor och diagram.

Den här artikeln gäller för: ✔️ Java ✔️ C#

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Den här artikeln visar hur du aktiverar din egen beständiga lagring i Azure Spring Apps.

När du använder den inbyggda beständiga lagringen i Azure Spring Apps laddas artefakter som genereras av ditt program upp till Azure Storage-konton. Microsoft styr principerna för kryptering i vila och livslängdshantering för dessa artefakter.

När du använder din egen beständiga lagring laddas artefakter som genereras av ditt program upp till ett lagringskonto som du styr. Du styr krypterings-i-vila-principen, policyn för livslängdshantering och nätverksåtkomst. Du ansvarar för de kostnader som är kopplade till lagringskontot.

Förutsättningar

• Ett befintligt Azure Storage-konto och en befintlig Azure-filresurs. Om du behöver skapa ett lagringskonto och en filresurs i Azure kan du läsa Skapa en SMB Azure-filresurs.
• Azure CLI, version 2.45.0 eller senare.

Viktigt!

Om du har distribuerat dina Azure Spring Apps i ditt eget virtuella nätverk och vill att lagringskontot endast ska nås från det virtuella nätverket läser du Använda privata slutpunkter för Azure Storage och avsnittet Bevilja åtkomst från ett virtuellt nätverk i Konfigurera Azure Storage-brandväggar och virtuella nätverk.

Montera din egen extra beständiga lagring till program

Kommentar

Om du uppdaterar beständig lagring startas dina program om.

När du använder integrering av virtuella nätverk kontrollerar du att portarna 80 och 445 är öppna.

Azure-portalen

Använd följande steg för att binda ett Azure Storage-konto som en lagringsresurs i dina Azure Spring Apps och skapa en app med din egen beständiga lagring.

1. Gå till sidan Tjänstöversikt och välj sedan Lagring i det vänstra navigeringsfönstret.

2. På sidan Lagring väljer du Lägg till lagring.

   

3. Ange följande information på sidan Lägg till lagring och välj sedan Använd.

   Inställning	Värde
   Lagringsnamn	Namnet på lagringsresursen, som är en resurs på tjänstnivå i Azure Spring Apps.
   Kontonamn	Namnet på lagringskontot.
   Kontonyckel	Nyckeln till lagringskontot.

   

4. Gå till sidan Appar och välj sedan ett program för att montera den beständiga lagringen.

   

5. Välj Konfiguration och sedan Beständig lagring.

6. Välj Lägg till beständig lagring. Lägg till värdena i följande tabell och välj sedan Använd.

   Inställning	Värde
   Lagringsnamn	Namnet på den lagringsresurs som du angav tidigare.
   Beständiga lagringstyper	AzureFileVolume
   Resursnamn	Namnet på Azure-filresursen i Azure Storage-kontot.
   Monteringssökväg	En unik monteringssökväg.
   Monteringsalternativ	Valfritt
   Skrivskyddad	Valfritt

   

7. Välj Spara för att tillämpa konfigurationsändringarna.

   

Azure CLI

Använd följande steg för att aktivera din egen lagring med Azure CLI.

1. Använd följande kommando för att binda ditt Azure Storage-konto som en lagringsresurs i din Azure Spring Apps-instans.

   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. Använd följande kommando för att skapa en app med din egen beständiga lagring.

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

   I följande exempel visas en JSON-fil som skickas till parametern --persistent-storage .

   {
      "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. Du kan också använda följande kommando för att lägga till extra beständig lagring i en befintlig 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. Du kan också använda följande kommando för att visa den befintliga beständiga lagringen för en specifik lagringsresurs.

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

Bästa praxis

Använd följande metodtips när du lägger till din egen beständiga lagring i Azure Spring Apps.

• För att undvika problem med potentiella svarstider placerar du Azure Spring Apps-instansen och Azure Storage-kontot i samma Azure-region.

• Undvik att återskapa den kontonyckel som du använder i Azure Storage-kontot. Lagringskontot innehåller två olika nycklar. Använd en stegvis metod för att säkerställa att den beständiga lagringen förblir tillgänglig för program under nyckelförnyelse.

  Använd till exempel följande steg för att säkerställa att den beständiga lagringen förblir tillgänglig om du använde key1 för att binda ett lagringskonto till Azure Spring Apps.

  1. Återskapa key2.
  2. Uppdatera kontonyckeln för lagringsresursen för att använda den återskapade nyckeln2.
  3. Starta om de program som monterar den beständiga lagringen från den här lagringsresursen. az spring storage list-persistent-storage Använd kommandot för att visa en lista över alla relaterade program.
  4. Återskapa key1.

• Om du tar bort ett Azure Storage-konto eller En Azure-filresurs kan du undvika eventuella fel genom att ta bort motsvarande lagringsresurs eller beständiga lagring i programmen.

• Om du vill skriva filer till samma sökväg för varje enskild programinstans, men behålla dem i separata underkataloger från filresursens perspektiv, kan du använda alternativet SubPath . Observera att alternativet SubPath inte är skrivskyddat eftersom SubPath används för att skriva nya filer och Skrivskydd används för att läsa befintliga filer.

Vanliga frågor

Det här avsnittet tar upp vanliga frågor om hur du använder din egen beständiga lagring med Azure Spring Apps.

• Om jag har aktiverat inbyggd beständig lagring och sedan aktiverat min egen lagring som extra beständig lagring, migreras mina data till mitt Azure Storage-konto?

  Nej. Men vi kommer att tillhandahålla ett dokument som hjälper dig att utföra migreringen själv snart.

• Vilka är de reserverade monteringssökvägarna?

  Azure Spring Apps reserverar följande monteringsvägar:

  • /Tmp
  • /Beständiga
  • /Hemligheter
  • /app-insights/agents
  • /etc/azure-spring-cloud/certs
  • /app-insights/agents/settings
  • /app-lifecycle/settings

• Vilka är de tillgängliga monteringsalternativen?

  Vi stöder för närvarande följande monteringsalternativ:

  • uid
  • gid
  • file_mode
  • dir_mode

  Egenskapen mountOptions är valfri. Standardvärdena för dessa monteringsalternativ är: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]

• Jag använder tjänstslutpunkten för att konfigurera lagringskontot så att endast åtkomst tillåts från mitt eget virtuella nätverk. Varför fick jag ett felmeddelande om nekad behörighet när jag försökte montera anpassad beständig lagring i mina program?

  En tjänstslutpunkt ger endast nätverksåtkomst på undernätsnivå. Kontrollera att du har lagt till båda undernäten som används av Azure Spring Apps-instansen i tjänstslutpunktens omfattning.

Nästa steg

• Så här använder du Logback för att skriva loggar till anpassad beständig lagring.
• Skala ett program i Azure Spring Apps.