App Service의 컨테이너에서 네트워크 공유로 Azure Storage 액세스Access Azure Storage as a network share from a container in App Service

이 가이드에서는 App Service의 windows 컨테이너에 Azure Storage 파일을 네트워크 공유로 연결 하는 방법을 보여 줍니다.This guide shows how to attach Azure Storage Files as a network share to a windows container in App Service. Azure Files 공유프리미엄 파일 공유 만 지원 됩니다.Only Azure Files Shares and Premium Files Shares are supported. 혜택에는 보안된 콘텐츠, 콘텐츠 이식성, 여러 앱에 대한 액세스 및 여러 가지 전송 메서드가 포함됩니다.Benefits include secured content, content portability, access to multiple apps, and multiple transferring methods.

이 가이드에서는 Azure Storage Linux 컨테이너 App Service에 연결 하는 방법을 보여 줍니다.This guide shows how to attach Azure Storage to a Linux container App Service. 보안 콘텐츠, 콘텐츠 이식성, 영구 저장소, 여러 앱에 대 한 액세스 및 여러 가지 전송 방법 등의 이점이 있습니다.Benefits include secured content, content portability, persistent storage, access to multiple apps, and multiple transferring methods.

전제 조건Prerequisites

참고

Azure Files은 기본이 아닌 저장소 이며 별도로 청구 되며 웹 앱에 포함 되지 않습니다.Azure Files is non-default storage and billed separately, not included with the web app. 인프라 제한으로 인 한 방화벽 구성 사용은 지원 하지 않습니다.It doesn't support using Firewall configuration due to infrastructure limitations.

제한 사항Limitations

  • App Service Azure Storage는 미리 보기 상태 이며 프로덕션 시나리오에서 지원 되지 않습니다 .Azure Storage in App Service is in preview and not supported for production scenarios.
  • App Service Azure Storage는 현재 고유한 코드 시나리오 (비 컨테이너 화 된 Windows 앱)를 사용할 수 없습니다 .Azure Storage in App Service is currently not supported for bring your own code scenarios (non-containerized Windows apps).
  • App Service Azure Storage는 인프라 제한으로 인해 저장소 방화벽 구성 사용을 지원 하지 않습니다 .Azure Storage in App Service doesn't support using the Storage Firewall configuration because of infrastructure limitations.
  • App Service Azure Storage를 사용 하면 앱 당 최대 5 개의 탑재 지점이 지정 됩니다.Azure Storage with App Service lets you specify up to five mount points per app.
  • App Service FTP/FTPs 끝점을 통해 앱에 탑재 된 Azure Storage에 액세스할 수 없습니다.Azure Storage mounted to an app is not accessible through App Service FTP/FTPs endpoints. Azure Storage Explorer를 사용합니다.Use Azure Storage Explorer.
  • App Service의 Azure Storage는 Linux 및 Web App for Containers App Service에 대 한 미리 보기 상태입니다.Azure Storage in App Service is in preview for App Service on Linux and Web App for Containers. 프로덕션 시나리오에는 지원 되지 않습니다 .It's not supported for production scenarios.
  • App Service에서 Azure Storage는 컨테이너 (읽기/쓰기) 및 Azure Blob 컨테이너 (읽기 전용)를 Azure Files 탑재 하는 것을 지원 합니다.Azure Storage in App Service supports mounting Azure Files containers (Read / Write) and Azure Blob containers (Read Only)
  • App Service Azure Storage는 인프라 제한으로 인해 저장소 방화벽 구성 사용을 지원 하지 않습니다 .Azure Storage in App Service doesn't support using the Storage Firewall configuration because of infrastructure limitations.
  • App Service에서 Azure Storage를 사용 하 여 앱 당 최대 5 개의 탑재 시점을 지정할 수 있습니다.Azure Storage in App Service lets you specify up to five mount points per app.
  • App Service FTP/FTPs 끝점을 통해 앱에 탑재 된 Azure Storage에 액세스할 수 없습니다.Azure Storage mounted to an app is not accessible through App Service FTP/FTPs endpoints. Azure Storage Explorer를 사용합니다.Use Azure Storage Explorer.

Azure Storage 계정, 파일 공유 및 디렉터리를 만들었으면 이제 Azure Storage를 사용 하 여 앱을 구성할 수 있습니다.Once you've created your Azure Storage account, file share and directory, you can now configure your app with Azure Storage.

App Service 앱의 디렉터리에 Azure Files 공유를 탑재 하려면 az webapp config storage-account add 명령을 사용 합니다.To mount an Azure Files Share to a directory in your App Service app, you use the az webapp config storage-account add command. 저장소 유형은 AzureFiles 여야 합니다.Storage Type must be AzureFiles.

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory of form c:<directory name> >

Azure Files 공유에 연결 하려는 다른 모든 디렉터리에 대해이 작업을 수행 해야 합니다.You should do this for any other directories you want to be linked to an Azure Files share.

Azure Storage 계정, 파일 공유 및 디렉터리를 만들었으면 이제 Azure Storage를 사용 하 여 앱을 구성할 수 있습니다.Once you've created your Azure Storage account, file share and directory, you can now configure your app with Azure Storage.

App Service 앱의 디렉터리에 저장소 계정을 탑재 하려면 az webapp config storage-account add 명령을 사용 합니다.To mount a storage account to a directory in your App Service app, you use the az webapp config storage-account add command. 스토리지 형식은 AzureBlob 또는 AzureFiles일 수 있습니다.Storage Type can be AzureBlob or AzureFiles. AzureFiles는이 예제에서 사용 됩니다.AzureFiles is used in this example. 탑재 경로 설정은 Azure Storage에서 탑재 하려는 폴더에 해당 합니다.The mount path setting corresponds to the folder you would like to mount from Azure Storage. '/'로 설정 하면 전체 Azure Storage가 탑재 됩니다.Setting it to '/' mounts the entire Azure Storage.

주의

웹 앱에서 탑재 경로로 지정 된 디렉터리는 비어 있어야 합니다.The directory specified as the mount path in your web app should be empty. 이 디렉터리에 저장 된 모든 콘텐츠는 외부 마운트가 추가 될 때 삭제 됩니다.Any content stored in this directory will be deleted when an external mount is added. 기존 앱에 대한 파일을 마이그레이션하는 경우 시작하기 전에 앱 및 해당 콘텐츠의 백업을 만듭니다.If you are migrating files for an existing app, make a backup of your app and its content before you begin.

az webapp config storage-account add --resource-group <group-name> --name <app-name> --custom-id <custom-id> --storage-type AzureFiles --share-name <share-name> --account-name <storage-account-name> --access-key "<access-key>" --mount-path <mount-path-directory>

스토리지 계정에 연결하려는 다른 디렉터리에 대해 이 작업을 수행해야 합니다.You should do this for any other directories you want to be linked to a storage account.

연결 된 저장소 확인Verify linked storage

공유가 앱에 연결 되 면 다음 명령을 실행 하 여이를 확인할 수 있습니다.Once the share is linked to the app, you can verify this by running the following command:

az webapp config storage-account list --resource-group <resource-group> --name <app-name>

다음 단계Next steps