Как настроить собственное хранилище для Azure Spring Apps

Примечание.

Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.

Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.

Эта статья относится к:✅ Java ✅ C#

Эта статья относится к:✅ Basic/Standard ✅ Enterprise

В этой статье показано, как настроить собственное хранилище для Azure Spring Apps

При использовании встроенного постоянного хранилища Azure Spring Apps все созданные приложением артефакты передаются в учетные записи службы хранилища Azure. Майкрософт управляет политикой шифрования при хранении и политикой управления жизненным циклом для этих артефактов.

При использовании собственного постоянного хранилища артефакты, созданные приложением, передаются в учетную запись хранения, которую вы управляете. Вы управляете политикой шифрования, политикой управления временем существования и сетевым доступом. Вы несете ответственность за расходы, связанные с этой учетной записью хранения.

Необходимые компоненты

• Существующая учетная запись служба хранилища Azure и существующую общую папку Azure. Если вам нужно создать учетную запись хранения и общую папку в Azure, см. статью "Создание общей папки SMB Azure".
• Azure CLI версии 2.45.0 или более поздней.

Внимание

Если вы развернули Azure Spring Apps в собственной виртуальной сети и хотите, чтобы учетная запись хранения была доступна только из виртуальной сети, см. статью "Использование частных конечных точек для служба хранилища Azure и предоставления доступа из раздела "Настройка служба хранилища Azure брандмауэров и виртуальных сетей".

Подключение собственного постоянного хранилища к приложениям

Примечание.

Обновление постоянного хранилища перезапускает приложения.

При использовании интеграции виртуальной сети убедитесь, что открыты порты 80 и 445.

Портал Azure

Выполните следующие действия, чтобы привязать учетную запись служба хранилища Azure в качестве ресурса хранения для Azure Spring Apps и создать приложение с собственным постоянным хранилищем.

1. Перейдите на страницу обзора службы и выберите хранилище в области навигации слева.

2. На странице хранилища выберите "Добавить хранилище".

   

3. Введите следующие сведения на странице "Добавить хранилище " и нажмите кнопку "Применить".

   Параметр	Значение
   Имя хранилища	Имя ресурса хранилища, которое является ресурсом уровня службы в Azure Spring Apps.
   Имя учетной записи	Имя учетной записи хранения.
   Ключ учетной записи	Ключ учетной записи хранения.

   

4. Перейдите на страницу "Приложения" , а затем выберите приложение для подключения постоянного хранилища.

   

5. Выберите "Конфигурация" и выберите "Постоянное хранилище".

6. Выберите " Добавить постоянное хранилище". Добавьте значения в следующую таблицу и нажмите кнопку "Применить".

   Параметр	Значение
   Имя хранилища	Имя ресурса хранилища, которое вы ввели ранее.
   Тип постоянного хранилища	AzureFileVolume
   Имя общего ресурса	Имя общей папки Azure в учетной записи службы хранилища Azure.
   Путь подключения	Уникальный путь для подключения хранилища.
   Параметры подключения	Необязательно
   Только чтение	Необязательно

   

7. Нажмите кнопку "Сохранить", чтобы применить изменения конфигурации.

   

Azure CLI

Выполните следующие действия, чтобы включить собственное хранилище с помощью Azure CLI.

1. Используйте следующую команду, чтобы привязать учетную запись служба хранилища Azure в качестве ресурса хранения в экземпляре 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. Выполните следующую команду, чтобы создать приложение с собственным постоянным хранилищем:

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

   В следующем примере показан JSON-файл, передаваемый параметру --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. При необходимости используйте следующую команду, чтобы добавить дополнительное постоянное хранилище в существующее приложение.

   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. При необходимости используйте следующую команду для перечисления существующего постоянного хранилища определенного ресурса хранилища.

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

Рекомендации

При добавлении собственного постоянного хранилища в Azure Spring Apps используйте следующие рекомендации.

• Чтобы избежать потенциальных проблем с задержкой, разместите экземпляр Azure Spring Apps и учетную запись службы хранилища Azure в одном регионе Azure.

• В учетной записи служба хранилища Azure не создавайте ключ учетной записи, который вы используете. Учетная запись хранения содержит два разных ключа. Используйте пошаговый подход, чтобы гарантировать, что постоянное хранилище остается доступным для приложений во время восстановления ключей.

  Например, выполните следующие действия, чтобы убедиться, что постоянное хранилище остается доступным, если вы использовали ключ1 для привязки учетной записи хранения к Azure Spring Apps.

  1. Повторно создайте ключ 2.
  2. Обновите ключ учетной записи ресурса хранилища, чтобы использовать повторно созданный ключ 2.
  3. Перезапустите все приложения, которые подключают постоянное хранилище из этого ресурса хранилища. Используйте команду для перечисления az spring storage list-persistent-storage всех связанных приложений.
  4. Повторно создайте ключ 1.

• Если удалить учетную запись служба хранилища Azure или общую папку Azure, избежать возможных ошибок, удалив соответствующий ресурс хранилища или постоянное хранилище в приложениях.

• Если вы хотите записать файлы в один путь для каждого отдельного экземпляра приложения, но сохранить их в отдельных подкаталогах с точки зрения общей папки, можно использовать параметр SubPath . Обратите внимание, что параметр SubPath несовместим только с чтением, так как SubPath используется для записи новых файлов и используется только для чтения существующих файлов.

Вопросы и ответы

В этом разделе рассматриваются часто задаваемые вопросы об использовании собственного постоянного хранилища с Azure Spring Apps.

• Если у меня есть встроенный постоянный хранилище, а затем я включил собственное хранилище в качестве дополнительного постоянного хранилища, переносятся ли мои данные в мою учетную запись служба хранилища Azure?

  № Но мы предоставим вам документ, который поможет выполнить такую миграцию самостоятельно.

• Какие пути подключения зарезервированы?

  Azure Spring Apps резервирует следующие пути подключения:

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

• Какие доступны варианты подключения?

  В настоящее время поддерживаются следующие варианты подключения:

  • uid
  • gid
  • file_mode
  • dir_mode

  Свойство mountOptions необязательное. Значения по умолчанию для этих параметров подключения: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]

• Я использую конечную точку службы для настройки учетной записи хранения, чтобы разрешить доступ только из моей виртуальной сети. Почему при попытке подключить пользовательское постоянное хранилище к приложениям я получил ошибку "Отказано в разрешении"?

  Конечная точка службы предоставляет сетевой доступ только на уровне подсети. Убедитесь, что вы добавили обе подсети, используемые экземпляром Azure Spring Apps в область конечной точки службы.

Следующие шаги

• Использование Logback для записи журналов в пользовательское постоянное хранилище.
• Масштабирование приложения в Azure Spring Apps.