django tasks manager

Django任務管理器

超級簡單的Django＆Celery集成 - 該庫由Appseed積極支持。

特徵：

• 創建/撤銷Celery Tasks
• View LOGS和輸出
• Minimal Configuration
• 可用任務（作為開始樣本提供）
  • users_in_db() - 列出所有註冊用戶
  • execute_script() - 讓用戶執行CELERY_SCRIPTS_DIR中定義的腳本（CFG參數）
    • check-db-health.py（樣本）

如何使用它

通過PIP安裝軟件包

$ pip install django-tasks-manager
// OR
$ pip install git+https://github.com/app-generator/django-tasks-manager.git

包括新路由

 # core/urls.py

from django . urls import path , include     # <-- UPDATE: Add 'include' HELPER

urlpatterns = [
    ...
    
    path ( "" , include ( "django_tm.urls" )),  # <-- New Routes

    ...
]

創建Scrips＆Logs Directories-推薦的位置在項目的根源中：

$ mkdir celery_scripts # Used in Settings -> CELERY_SCRIPTS_DIR
$ mkdir celery_logs    # Used in Settings -> CELERY_SCRIPTS_DIR

• 確保執行應用程序的用戶具有寫入權限。
• 在腳本目錄中復制示例腳本。
• 所有腳本都將在UI中可用，可以由經理執行。

更新配置添加os對象導入

 import os # <-- NEW

更新配置：包括新應用程序

 INSTALLED_APPS = [
    ...                  
    'django_tm' ,              # Django Tasks Manager   # <-- NEW
    'django_celery_results' ,  # Django Celery Results  # <-- NEW
]

更新配置：包括新模板

 TEMPLATE_DIR_TASKS = os . path . join ( BASE_DIR , "django_tm/templates" )     # <-- NEW

TEMPLATES = [
    {
        'BACKEND' : 'django.template.backends.django.DjangoTemplates' ,   
        'DIRS' : [ TEMPLATE_DIR_TASKS ],                                  # <-- Updated 
        'APP_DIRS' : True ,
    },
]

更新配置：新芹菜部分

 #############################################################
# Celery configurations
# https://docs.celeryq.dev/en/stable/django/first-steps-with-django.html

# !!!
# BASE_DIR points to the ROOT of the project
# Note: make sure you have 'os' object imported
# !!!

# !!!
# BASE_DIR = os.path.dirname(os.path.dirname(__file__))
# !!! 

# Working Directories required write permission
CELERY_SCRIPTS_DIR        = os . path . join ( BASE_DIR , "celery_scripts" )
CELERY_LOGS_DIR           = os . path . join ( BASE_DIR , "celery_logs"    )

CELERY_BROKER_URL         = os . environ . get ( "CELERY_BROKER" , "redis://localhost:6379" )
CELERY_RESULT_BACKEND     = os . environ . get ( "CELERY_BROKER" , "redis://localhost:6379" )

CELERY_TASK_TRACK_STARTED = True
CELERY_TASK_TIME_LIMIT    = 30 * 60
CELERY_CACHE_BACKEND      = "django-cache"
CELERY_RESULT_BACKEND     = "django-db"
CELERY_RESULT_EXTENDED    = True
CELERY_RESULT_EXPIRES     = 60 * 60 * 24 * 30 # Results expire after 1 month
CELERY_ACCEPT_CONTENT     = [ "json" ]
CELERY_TASK_SERIALIZER    = 'json'
CELERY_RESULT_SERIALIZER  = 'json'

#############################################################
#############################################################

啟動應用程序

$ # Set up the database
$ python manage.py makemigrations
$ python manage.py migrate
$
$ # Create the superuser
$ python manage.py createsuperuser
$
$ # Start the application (development mode)
$ python manage.py runserver # default port 8000

• 身份驗證為superuser
• 訪問任務頁面： http://127.0.0.1:8000/tasks 8000/ Tasks

啟動芹菜經理（另一個終端）和更新環境

使用manage.py中提供的值導出DJANGO_SETTINGS_MODULE

$ export DJANGO_SETTINGS_MODULE=cfg.settings  

使用的值應從manage.py中獲取：

 def main ():
    
    """Run administrative tasks."""
    os . environ . setdefault ( "DJANGO_SETTINGS_MODULE" , "cfg.settings" )  # <-- VALUE to be exported

    try :
        from django . core . management import execute_from_command_line
    except ImportError as exc :
        ...

注意：端口6379 （默認）預計Redis服務器。如果redis在其他PORT上運行，請更新配置： CELERY_BROKER_URL和CELERY_RESULT_BACKEND 。

$ celery --app=django_tm.celery.app worker --loglevel=info 

螢幕

View all tasks

View Task LOG

鏈接和資源

• 通過電子郵件和不和諧免費支持
• Django Tasks Manager- free sample ，解釋：
  • Project Creation （添加最小文件）
  • Install和生成Django核心
  • 安裝Django-TM （此軟件包）
  • Update Configuration
  • Start the app
  • 使用Tasks Manager

---

Django Tasks Manager- Appseed提供的開源庫