Merge pull request #303812 from msangapu-msft/webjobs

webjobs note

Author: JamesJBarnett

articles/app-service/includes/webjobs-create/alpine-note.md

@@ -0,0 +1,10 @@
+---
+author: msangapu-msft
+ms.service: azure-app-service
+ms.topic: include
+ms.date: 08/04/2025
+ms.author: msangapu
+---
+> [!IMPORTANT]
+> WebJobs aren't supported in custom Linux containers based on Alpine Linux, including Linux apps using Java 8 and Java 11 runtime stacks. Starting with Java 17 Linux apps, Azure App Service uses non-Alpine based images, which are compatible with WebJobs.
+>

articles/app-service/includes/webjobs-create/webjob-types.md

@@ -8,6 +8,8 @@ ms.author: msangapu
 
 ### <a name="acceptablefiles"></a>Supported file types for scripts or programs
 
+[!INCLUDE [alpine note](alpine-note.md)]
+
 ### [Windows code](#tab/windowscode)
 
 The following file types are supported:

articles/app-service/includes/webjobs-create/webjobs-supported-platforms.md

@@ -0,0 +1,31 @@
+---
+author: msangapu-msft
+ms.author: msangapu
+ms.topic: include
+ms.date: 08/04/2025
+ms.service: azure-app-service
+ms.subservice: web-apps
+---
+
+<a name="webjobs-supported-note" ></a>
+
+## Supported platforms and file types
+
+[!INCLUDE [alpine note](alpine-note.md)]
+
+WebJobs are supported on the following App Service hosting options:
+
+- Windows code
+- Windows containers
+- Linux code
+- Linux containers
+
+Supported file/script types include:
+
+- Windows executables and scripts: `.exe`, `.cmd`, `.bat`
+- PowerShell scripts: `.ps1`
+- Bash scripts: `.sh`
+- Scripting languages: Python (`.py`), Node.js (`.js`), PHP (`.php`), F# (`.fsx`), Java (`.jar`, `.war`)
+- Any language runtime included in your container app
+
+This versatility enables you to integrate WebJobs into a wide range of application architectures using the tools and languages you're already comfortable with.

articles/app-service/overview-webjobs.md

@@ -42,27 +42,9 @@ WebJobs come in three main types:
 - **Scheduled WebJobs**: A specialized type of triggered WebJob that runs on a defined schedule using a `settings.job` file with [NCRONTAB expressions](webjobs-create.md#ncrontab-expressions).
 - **Continuous WebJobs**: Run persistently in the background while your App Service app is running. Ideal for queue polling or background monitoring tasks.
 
-
 :::image type="content" border="false" source="media/overview-webjobs/webjob-types-app-service.png" alt-text="Diagram overview of WebJobs in Azure App Service, showing job types.":::
 
-## Supported platforms and file types
-
-WebJobs are supported on the following App Service hosting options:
-
-- Windows code
-- Windows containers
-- Linux code
-- Linux containers
-
-Supported file/script types include:
-
-- Windows executables and scripts: `.exe`, `.cmd`, `.bat`
-- PowerShell scripts: `.ps1`
-- Bash scripts: `.sh`
-- Scripting languages: Python (`.py`), Node.js (`.js`), PHP (`.php`), F# (`.fsx`)
-- Any language runtime included in your container app
-
-This versatility enables you to integrate WebJobs into a wide range of application architectures using the tools and languages you're already comfortable with.
+[!INCLUDE [webjobs supported platforms and file types](./includes/webjobs-create/webjobs-supported-platforms.md)]
 
 ## Deployment options
 
@@ -77,15 +59,15 @@ WebJobs also provide **built-in logging** via Kudu and integration with App Serv
 
 ## Scaling considerations
 
-WebJobs scale together with your App Service plan. If your app is configured to scale out to multiple instances, your WebJobs will run on each instance as appropriate:
+WebJobs scale together with your App Service plan. If your app is configured to scale out to multiple instances, your WebJobs run on each instance as appropriate:
 - **Triggered WebJobs** will run on a single instance by default.
 - **Continuous WebJobs** can be configured to run on all instances or a single one using the `WEBJOBS_RUN_ONCE` setting.
 
 If you need independently scalable or event-driven execution, [Azure Functions](../azure-functions/functions-overview.md) may be more appropriate.
 
 ## Best practices
 
-- Use **triggered** WebJobs for ad hoc or scheduled operations.
+- Use **triggered** WebJobs for improvised or scheduled operations.
 - Use **continuous** WebJobs only when the task needs to run constantly (e.g., polling a queue).
 - Implement **retry logic and error handling** within your scripts.
 - Use **application logging** and **Kudu logs** to monitor job behavior.
@@ -103,8 +85,8 @@ If you need independently scalable or event-driven execution, [Azure Functions](
 
 ## <a name="NextSteps"></a> Next steps
 
-- [Background jobs best practices – Azure Architecture Center](/azure/architecture/best-practices/background-jobs)
+- [Review background jobs best practices – Azure Architecture Center](/azure/architecture/best-practices/background-jobs)
 - [Develop WebJobs using Visual Studio](webjobs-dotnet-deploy-vs.md)
 - [Get started with the WebJobs SDK](webjobs-sdk-get-started.md)
 - [Use the WebJobs SDK to build advanced jobs](webjobs-sdk-how-to.md)
-- [Kudu WebJobs reference on GitHub](https://github.com/projectkudu/kudu/wiki/WebJobs)
+- [Review Kudu WebJobs reference on GitHub](https://github.com/projectkudu/kudu/wiki/WebJobs)

articles/app-service/tutorial-webjobs.md

@@ -235,6 +235,10 @@ node webjob.js
 
 WebJobs is a feature of Azure App Service that enables you to run a program or script in the same instance as a web app. All app service plans support WebJobs at no additional cost. This sample uses a scheduled (Triggered) WebJob to output the system time once every minute.  
 
+> [!IMPORTANT]
+> WebJobs aren't supported in custom Linux containers based on Alpine Linux, including Linux apps using Java 8 and Java 11 runtime stacks. Starting with Java 17 Linux apps, Azure App Service uses non-Alpine based images, which are compatible with WebJobs.
+>
+
 ## Prerequisites
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
@@ -267,13 +271,13 @@ public class HelloWorld {
 
 ### Build the Java WebJob
 
-1. The `run.sh` script runs a jar with the name that set in the Maven configuration. This script will run when our WebJob is triggered.
+1. The `run.sh` script runs a jar with the name that sets in the Maven configuration. This script runs when our WebJob is triggered.
 
     ```bash
     java -jar webjob-artifact-1.0.0.jar
     ``` 
 
-1. Next, we compile the Java project to produce the executable `.jar`. There are multiple ways to do this, but for this example, we’ll use Maven. Run the following commands from the `project/` directory:
+1. Next, we compile the Java project to produce the executable `.jar`. There are multiple ways to do this, but for this example, we use Maven. Run the following commands from the `project/` directory:
 
     ```bash
     mvn install 
@@ -318,7 +322,7 @@ public class HelloWorld {
 
 :::zone target="docs" pivot="php"
 
-WebJobs is a feature of Azure App Service that enables you to run a program or script in the same instance as a web app. All app service plans support WebJobs at no additional cost. This sample uses a scheduled (Triggered) WebJob to output the system time once every minute.  
+WebJobs is a feature of Azure App Service that enables you to run a program or script in the same instance as a web app. All app service plans support WebJobs at no extra cost. This sample uses a scheduled (Triggered) WebJob to output the system time once every minute.  
 
 ## Prerequisites
 
@@ -329,7 +333,7 @@ WebJobs is a feature of Azure App Service that enables you to run a program
 
 ## Download the sample WebJob
 
-You can [download a pre-built sample project](https://github.com/Azure-Samples/App-Service-PHP-WebJobs-QuickStart/archive/refs/heads/main.zip) to get started quickly. The sample includes two files: `webjob.php` and `run.sh`.
+You can [download a prebuilt sample project](https://github.com/Azure-Samples/App-Service-PHP-WebJobs-QuickStart/archive/refs/heads/main.zip) to get started quickly. The sample includes two files: `webjob.php` and `run.sh`.
 
 The PHP script, `webjob.php`, outputs the current time to the console as shown below: