Skip to content

Commit 191bacf

Browse files
Merge pull request #225321 from cephalin/pr99454
Pr99454
2 parents f46e9f3 + e325fb7 commit 191bacf

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

articles/app-service/deploy-run-package.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The command also restarts the app. Because `WEBSITE_RUN_FROM_PACKAGE` is set, Ap
4949

5050
## Run from external URL instead
5151

52-
You can also run a package from an external URL, such as Azure Blob Storage. You can use the [Azure Storage Explorer](../vs-azure-tools-storage-manage-with-storage-explorer.md) to upload package files to your Blob storage account. You should use a private storage container with a [Shared Access Signature (SAS)](../vs-azure-tools-storage-manage-with-storage-explorer.md#generate-a-sas-in-storage-explorer) or [use a managed identity](#fetch-a-package-from-azure-blob-storage-using-a-managed-identity) to enable the App Service runtime to access the package securely.
52+
You can also run a package from an external URL, such as Azure Blob Storage. You can use the [Azure Storage Explorer](../vs-azure-tools-storage-manage-with-storage-explorer.md) to upload package files to your Blob storage account. You should use a private storage container with a [Shared Access Signature (SAS)](../vs-azure-tools-storage-manage-with-storage-explorer.md#generate-a-sas-in-storage-explorer) or [use a managed identity](#access-a-package-in-azure-blob-storage-using-a-managed-identity) to enable the App Service runtime to access the package securely.
5353

5454
Once you upload your file to Blob storage and have an SAS URL for the file, set the `WEBSITE_RUN_FROM_PACKAGE` app setting to the URL. The following example does it by using Azure CLI:
5555

@@ -59,10 +59,21 @@ az webapp config appsettings set --name <app-name> --resource-group <resource-gr
5959

6060
If you publish an updated package with the same name to Blob storage, you need to restart your app so that the updated package is loaded into App Service.
6161

62-
### Fetch a package from Azure Blob Storage using a managed identity
62+
### Access a package in Azure Blob Storage using a managed identity
6363

6464
[!INCLUDE [Run from package via Identity](../../includes/app-service-run-from-package-via-identity.md)]
6565

66+
## Deploy WebJob files when running from package
67+
68+
There are two ways to deploy [WebJob](webjobs-create.md) files when you [enable running an app from package](#enable-running-from-package):
69+
70+
71+
- Deploy in the same ZIP package as your app: include them as you normally would in `<project-root>\app_data\jobs\...` (which maps to the deployment path `\site\wwwroot\app_data\jobs\...` as specified in the [WebJobs quickstart](webjobs-create.md#webjob-types)).
72+
- Deploy separately from the ZIP package of your app: Since the usual deployment path `\site\wwwroot\app_data\jobs\...` is now read-only, you can't deploy WebJob files there. Instead, deploy WebJob files to `\site\jobs\...`, which is not read only. WebJobs deployed to `\site\wwwroot\app_data\jobs\...` and `\site\jobs\...` both run.
73+
74+
> [!NOTE]
75+
> When `\site\wwwroot` becomes read-only, operations like the creation of the *disable.job* will fail.
76+
6677
## Troubleshooting
6778

6879
- Running directly from a package makes `wwwroot` read-only. Your app will receive an error if it tries to write files to this directory.

0 commit comments

Comments
 (0)