Azure Linux App Service中Django定时任务方案咨询（非Cronjobs）

设计逻辑 #

针对你遇到的Linux App Service无法用WebJobs、内置Cron不稳定且无日志权限的问题，选择Azure Functions作为定时任务执行载体的核心原因：

• 自带稳定的定时触发器：由Azure云平台负责调度，不受App Service资源波动或重启影响
• 完整日志体系：每一次任务执行都有可追溯的日志，支持在Azure门户直接查看或集成到Log Analytics
• 与Django生态兼容：Python运行时可以直接加载Django配置，执行管理命令
• 云原生集成：和App Service共享同一Azure环境，便于配置数据库、密钥等环境变量

详细配置步骤 #

1. 创建Azure Functions实例 #

• 在Azure门户创建Python运行时的Functions应用，选择和你的App Service相同的区域（减少网络延迟）
• 触发器类型选择Timer Trigger，设置对应的Cron表达式（比如0 0 * * *表示每天凌晨执行）
• 在Functions的「配置」页面，添加与App Service完全一致的环境变量：
  • DJANGO_SETTINGS_MODULE（如your_project.settings）
  • DATABASE_URL或数据库连接参数
  • SECRET_KEY、ALLOWED_HOSTS等Django核心配置

2. 编写Functions执行Django管理命令的代码 #

在Functions的触发器目录（默认是TimerTrigger1/）下修改__init__.py，示例代码如下：

import os
import django
from django.core.management import call_command
import azure.functions as func

def main(mytimer: func.TimerRequest) -> None:
    # 初始化Django环境
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project.settings')
    django.setup()

    # 执行你需要的Django管理命令，示例为清理过期会话
    call_command('clearsessions')

• 确保Functions的requirements.txt包含Django及你的项目依赖（可以直接复用App Service的requirements.txt内容）

3. 配置代码共享（可选） #

如果你的Django管理命令依赖项目内的自定义模块，有两种方式让Functions访问代码：

• 方式1：将Functions代码放在Django项目的同一GitHub仓库中（比如新增functions/目录），这样CI/CD可以同时部署两者
• 方式2：将Django项目的核心模块打包成私有Python包，发布到Azure Artifacts或私有PyPI，在Functions的requirements.txt中引用该包

GitHub Actions CI/CD集成（修改你的现有YAML） #

在你提供的部署流程中，新增Azure Functions的部署步骤，同时更新部分Actions版本（提升兼容性）：

name: Build and deploy Python app to Azure Web App & Functions

on:
  push:
    branches:
      - prod
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Set up Python version
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'

      - name: Create and start virtual environment
        run: |
          python -m venv venv
          source venv/bin/activate

      - name: Install dependencies
        run: pip install -r requirements.txt

      # 可选：添加Django测试步骤
      # - name: Run Django tests
      #   run: |
      #     source venv/bin/activate
      #     python manage.py test

      - name: Upload artifact for deployment jobs
        uses: actions/upload-artifact@v3
        with:
          name: python-app
          path: |
            .
            !venv/

  deploy_app_service:
    runs-on: ubuntu-latest
    needs: build
    environment:
      name: 'Production'
      url: ${{ steps.deploy-to-webapp.outputs.webapp-url }}

    steps:
      - name: Download artifact from build job
        uses: actions/download-artifact@v3
        with:
          name: python-app
          path: .

      - name: 'Deploy to Azure Web App'
        uses: azure/webapps-deploy@v2
        id: deploy-to-webapp
        with:
          app-name: 'AppName'
          slot-name: 'Production'
          publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}

  deploy_functions:
    runs-on: ubuntu-latest
    needs: build
    environment:
      name: 'Production'

    steps:
      - name: Download artifact from build job
        uses: actions/download-artifact@v3
        with:
          name: python-app
          path: .

      - name: 'Deploy to Azure Functions'
        uses: Azure/functions-action@v1
        with:
          app-name: 'YourFunctionsAppName' # 替换为你的Functions应用名称
          publish-profile: ${{ secrets.AZURE_FUNCTIONS_PUBLISH_PROFILE }} # 在GitHub Secrets中添加该密钥
          package: ./functions # 替换为你的Functions代码所在目录

关键配置说明 #

• 在GitHub仓库的「Settings → Secrets and variables → Actions」中，新增AZURE_FUNCTIONS_PUBLISH_PROFILE，值为Azure Functions门户下载的发布配置文件内容
• 调整package参数为你的Functions代码在仓库中的路径（比如./functions）

问题对应解决 #

1. 替代不稳定的Cronjobs：Azure Functions的定时触发器由Azure云原生调度，可靠性远高于App Service的内置Cron，且任务执行独立于App Service实例
2. 日志查看权限：在Azure Functions门户的「Monitor → Logs」中可以直接查看每一次任务执行的详细日志，也可以配置Log Analytics做长期存储和分析
3. Linux环境兼容：Azure Functions的Python运行时基于Linux，完全适配你的环境，无需担心兼容性问题

内容的提问来源于stack exchange，提问作者Raamesh Bhardwaj