Merge pull request #297982 from msangapu-msft/webjobs

draft

Author: v-shils

articles/app-service/media/quickstart-webjobs/delete-webjobs.png

@@ -0,0 +1,42 @@
+---
+title: "App Service WebJobs Overview"
+description: "An overview of Azure WebJobs, covering its types, supported platforms, file types, scheduling with NCRONTAB expressions, deployment options, and benefits for background processing within Azure App Service."
+keywords: "Azure WebJobs, App Service, background processing, triggered jobs, continuous jobs, NCRONTAB, deployment, Azure, technical overview"
+ms.topic: overview
+ms.date: 5/1/2025
+author: msangapu-msft
+ms.author: msangapu
+ms.reviewer: ggailey
+#Customer intent: As a web developer, I want to leverage background tasks to keep my application running smoothly.
+---
+
+# App Service WebJobs overview
+
+## Introduction
+Azure WebJobs is a built-in feature of Azure App Service that enables you to run background tasks, scripts, and programs alongside your web, API, or mobile applications without needing separate infrastructure. This integration simplifies the automation of routine or resource-intensive operations—such as data processing, file cleanups, or queue monitoring—by leveraging the same scalable, managed environment as your primary application.
+
+## WebJob types
+WebJobs come in two primary types:
+- **Triggered WebJobs:** Run on demand, on a schedule, or in response to specific events.
+- **Continuous WebJobs:** Operate perpetually, ensuring that critical background processes are always active.
+
+For scheduled tasks, NCRONTAB expressions are used to define precise execution intervals, giving you fine-grained control over when the jobs run.
+
+## Supported platforms and file types
+Azure WebJobs is fully supported on Windows code, Windows containers, Linux code, and Linux containers.
+
+Supported file types include:
+- Windows command scripts (`.cmd`, `.bat`, `.exe`)
+- PowerShell scripts (`.ps1`)
+- Bash scripts (`.sh`)
+- Scripting languages such as Python (`.py`), PHP (`.php`), Node.js (`.js`), and F# (`.fsx`)
+
+This versatility enables integration of WebJobs into a wide range of application architectures.
+
+## Benefits and deployment
+By incorporating WebJobs into your App Service, you reduce operational overhead while gaining robust capabilities for background processing. Deployment options are flexible and include:
+- **Visual Studio Integration:** Seamlessly deploy WebJobs alongside your ASP.NET applications.
+- **Azure Portal and ZIP Deployment:** Easily upload and deploy your WebJob packages.
+- **Automated Pipelines:** Use ARM templates or Git for automated deployments.
+
+Additionally, WebJobs provide built-in logging and monitoring, as well as seamless integration with other Azure services, making them a cost-effective and efficient solution for automating background tasks.

articles/app-service/media/quickstart-webjobs/review-webjobs-logs.png

@@ -0,0 +1,64 @@
+---
+title: 'Create a scheduled WebJob using a prebuilt script'
+description: Quickly schedule a time-based WebJob in Azure App Service using a prebuilt script for Windows or Linux.
+ms.topic: quickstart
+ms.date: 4/24/2025
+author: msangapu-msft
+ms.author: msangapu
+ms.reviewer: glenga
+#Customer intent: As a web developer, I want to quickly run a background script that prints the current time.
+---
+
+# Quickstart: Create a scheduled WebJob
+
+WebJobs in Azure App Service let you run scripts or programs as background tasks. In this quickstart, you create a scheduled WebJob that prints the current time, using a prebuilt script for either Windows or Linux.
+
+## Prerequisites
+
+- An Azure account. [Create one for free](https://azure.microsoft.com/free/).
+- An existing App Service app running on your preferred OS:
+  - Windows App Service (any stack: code or container)
+  - Linux App Service (any stack: code or container)
+- Enable **Always On** in the App Service settings: [Configure Always On](configure-common.md?tabs=portal#configure-general-settings)
+- For Windows containers and all Linux apps, set the app setting `WEBSITE_SKIP_RUNNING_KUDUAGENT = false`
+
+## Step 1: Download a sample WebJob
+
+Choose the version that matches your App Service OS:
+
+| Platform | Download link | Included script |
+|----------|----------------|-----------------|
+| **Windows** | [Download CMD version](https://github.com/Azure-Samples/App-Service-WebJobs-Quickstart/raw/main/windows/webjob-windows.zip) | `run.cmd` (uses `echo %date% %time%`) |
+| **Linux**   | [Download Bash version](https://github.com/Azure-Samples/App-Service-WebJobs-Quickstart/raw/main/linux/webjob-linux.zip)   | `run.sh` (uses `date`) |
+
+Each zip contains a single script that prints the current system date and time.
+
+## Step 2: Add the WebJob in the Azure portal
+
+1. In the [Azure portal](https://portal.azure.com), go to your **App Service** app.
+2. In the left menu, select **WebJobs** > **+ Add**.
+3. Fill in the form with the following values:
+
+   | Setting            | Value             |
+   |--------------------|-------------------|
+   | **Name**           | `webjob`          |
+   | **File Upload**    | The `.zip` file you downloaded |
+   | **Type**           | `Triggered`       |
+   | **Triggers**       | `Scheduled`       |
+   | **CRON Expression**| `0 0/1 * * * *`   |
+
+4. Select **OK** to create the WebJob.
+
+## Step 3: Monitor WebJob logs
+
+1. Go to the **WebJobs** tab.
+2. Select your WebJob and open **Logs**.
+3. Confirm that it runs every minute and prints the system time.
+
+## Step 4: Clean up
+
+To remove the WebJob, select the WebJob in the portal and select `Delete`.
+
+## <a name="NextSteps"></a> Next step
+
+[Build a custom scheduled WebJob from scratch using .NET, Python, Node.js, Java, or PHP](tutorial-webjobs.md)

articles/app-service/media/quickstart-webjobs/webjobs-log-output.png

@@ -463,7 +463,16 @@ items:
       href: invoke-openapi-web-app-from-azure-ai-agent-service.md
 - name: WebJobs
   items:
-    - name: Create WebJobs
+    - name: Overview 
+      href: overview-webjobs.md 
+      displayName: WebJobs overview
+    - name: WebJobs Quickstart
+      href: quickstart-webjobs.md
+      displayName: Create a scheduled WebJob
+    - name: WebJobs Tutorial
+      href: tutorial-webjobs.md      
+      displayName: Prepare and schedule a WebJob
+    - name: WebJobs How-to
       href: webjobs-create.md
     - name: Develop WebJobs using VS
       href: webjobs-dotnet-deploy-vs.md