Povolení vlastního trvalého úložiště v Azure Spring Apps

Note

Plány Basic, Standarda Enterprise vstoupily do důchodového období 17. března 2025. Pro více informací si přečtěte oznámení o ukončení Azure Spring Apps.

Tento článek se vztahuje na:✅ Java ✅ C#

Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise

V tomto článku se dozvíte, jak povolit vlastní trvalé úložiště v Azure Spring Apps.

Při použití integrovaného trvalého úložiště v Azure Spring Apps se artefakty vygenerované vaší aplikací nahrají do účtů služby Azure Storage. Microsoft řídí zásady správy neaktivních uložených dat a životnosti šifrování těchto artefaktů.

Když používáte vlastní trvalé úložiště, artefakty vygenerované vaší aplikací se nahrají do účtu úložiště, který řídíte. Řídíte zásady šifrování neaktivních uložených dat, zásady správy životnosti a síťový přístup. Zodpovídáte za náklady spojené s tímto účtem úložiště.

Prerequisites

• Existující účet služby Azure Storage a existující sdílená složka Azure. Pokud potřebujete vytvořit účet úložiště a sdílenou složku v Azure, přečtěte si téma Vytvoření sdílené složky Azure SMB.
• Azure CLI verze 2.45.0 nebo vyšší

Important

Pokud jste nasadili službu Azure Spring Apps ve vlastní virtuální síti a chcete, aby byl účet úložiště přístupný jenom z virtuální sítě, přečtěte si téma Použití privátních koncových bodů pro Azure Storage a udělení přístupu z části Konfigurace bran firewall a virtuálních sítí služby Azure Storage.

Připojení vlastního dalšího trvalého úložiště k aplikacím

Note

Aktualizace trvalého úložiště restartuje vaše aplikace.

Pokud používáte integraci virtuální sítě, ujistěte se, že jsou otevřené porty 80 a 445.

Azure Portal

Následující postup použijte k vytvoření vazby účtu Azure Storage jako prostředku úložiště ve službě Azure Spring Apps a vytvoření aplikace s vlastním trvalým úložištěm.

1. Přejděte na stránku Přehled služby a v levém navigačním podokně vyberte Úložiště .

2. Na stránce Úložiště vyberte Přidat úložiště.

   

3. Na stránce Přidat úložiště zadejte následující informace a pak vyberte Použít.

   Setting	Value
   Název úložiště	Název prostředku úložiště, což je prostředek na úrovni služby v Azure Spring Apps.
   Název účtu	Název úložištního účtu.
   Klíč účtu	Klíč účtu úložiště.

   

4. Přejděte na stránku Aplikace a vyberte aplikaci pro připojení trvalého úložiště.

   

5. Vyberte Možnost Konfigurace a pak vyberte Trvalé úložiště.

6. Vyberte Přidat trvalé úložiště. Přidejte hodnoty v následující tabulce a pak vyberte Použít.

   Setting	Value
   Název úložiště	Název úložného prostředku, který jste zadali dříve.
   Trvalý typ úložiště	AzureFileVolume
   Název sdílené složky	Název sdílené složky Azure v účtu Azure Storage.
   Cesta připojení	Jedinečná připojovací cesta.
   Možnosti připojení	Optional
   Jen pro čtení	Optional

   

7. Chcete-li použít změny konfigurace, vyberte Uložit .

   

Azure CLI

Pomocí následujících kroků povolte vlastní úložiště pomocí Azure CLI.

1. Pomocí následujícího příkazu připojte váš účet Azure Storage jako úložný prostředek v instanci Azure Spring Apps.

   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. Pomocí následujícího příkazu vytvořte aplikaci s vlastním trvalým úložištěm.

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

   Následující příklad ukazuje soubor JSON předaný parametru --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. Volitelně můžete pomocí následujícího příkazu přidat do existující aplikace další trvalé úložiště.

   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. Volitelně můžete pomocí následujícího příkazu vypsat existující trvalé úložiště konkrétního prostředku úložiště.

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

Osvědčené postupy

Při přidávání vlastního trvalého úložiště do Azure Spring Apps použijte následující osvědčené postupy.

• Pokud se chcete vyhnout potenciálním problémům s latencí, umístěte instanci Azure Spring Apps a účet služby Azure Storage do stejné oblasti Azure.

• V účtu úložiště Azure se vyhněte opětovnému vygenerování klíče účtu, který používáte. Účet úložiště obsahuje dva různé klíče. Pomocí podrobného přístupu se ujistěte, že trvalé úložiště zůstává dostupné pro aplikace během regenerace klíčů.

  Pomocí následujícího postupu se například ujistěte, že trvalé úložiště zůstane dostupné, pokud jste použili key1 vazbu účtu úložiště k Azure Spring Apps.

  1. Znovu vygenerujte key2.
  2. Aktualizujte klíč účtu prostředku úložiště tak, aby používal znovu vygenerovaný key2klíč .
  3. Restartujte aplikace, které připojují persistentní úložiště z tohoto zdroje úložiště. az spring storage list-persistent-storage Pomocí příkazu zobrazíte seznam všech souvisejících aplikací.
  4. Znovu vygenerujte key1.

• Pokud odstraníte účet služby Azure Storage nebo sdílenou složku Azure, vyhněte se možným chybám odebráním odpovídajícího prostředku úložiště nebo trvalého úložiště v aplikacích.

• Pokud chcete zapisovat soubory do stejné cesty pro každou instanci aplikace, ale ponechat je v samostatných podadresářích z pohledu sdílené složky, můžete použít tuto SubPath možnost. Všimněte si, že tato možnost SubPath není kompatibilní s Read only, protože SubPath se používá k zápisu nových souborů a Read only slouží ke čtení existujících souborů.

časté otázky

Tato část se zabývá nejčastějšími dotazy týkajícími se používání vlastního trvalého úložiště se službou Azure Spring Apps.

• Pokud mám předdefinované trvalé úložiště povolené a pak jsem povolil(a) vlastní úložiště jako dodatečné trvalé úložiště, migrují se moje data do svého účtu Azure Storage?

  No. Brzy vám poskytneme dokument, který vám pomůže provést migraci sami.

• Jaké jsou rezervované připojovací cesty?

  Azure Spring Apps si vyhrazuje následující cesty připojení:

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

• Jaké jsou dostupné možnosti připojení?

  V současné době podporujeme následující možnosti připojení:

  • uid
  • gid
  • file_mode
  • dir_mode

  Vlastnost mountOptions je nepovinná. Výchozí hodnoty těchto možností připojení jsou: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]

• Používám koncový bod služby ke konfiguraci účtu úložiště tak, aby umožňoval přístup pouze z vlastní virtuální sítě. Proč se mi při pokusu o připojení vlastního trvalého úložiště k aplikacím zobrazila chyba Odepření oprávnění ?

  Koncový bod služby poskytuje přístup k síti pouze na úrovni podsítě. Ujistěte se, že jste do oboru koncového bodu služby přidali obě podsítě používané instancí Azure Spring Apps.

Další kroky

• Použití zpětného protokolování k zápisu protokolů do vlastního trvalého úložiště
• Škálování aplikace v Azure Spring Apps