Django Academy · Leçon

Écrire et appeler @shared_task

Exécutez des fonctions de manière asynchrone avec delay().

Écrire et appeler @shared_task est une leçon Django Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Django Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Django Academy comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Tasks Are Just Functions

A Celery task is an ordinary Python function with a decorator on top. The decorator teaches Celery how to queue and run it later.

Why shared_task

Use @shared_task instead of @app.task so your tasks do not depend on a specific Celery app. It is the standard choice inside Django apps.

Write Your First Task

Put tasks in a tasks.py inside an app. Decorate a plain function and Celery picks it up via autodiscover.

from celery import shared_task

@shared_task
def add(x, y):
    return x + y

Call It with delay

To run a task in the background, call .delay() instead of calling the function directly. It queues the job and returns at once.

add.delay(2, 3)  # queued, runs on a worker

delay vs Calling Directly

Calling add(2, 3) runs it right now in your web process. Calling add.delay(2, 3) sends it to the queue. Same function, very different timing.

Pass Simple Arguments

Arguments are serialized to JSON and sent to the broker, so pass simple values like IDs and strings, not whole model objects.

send_email.delay(user.id)   # good
send_email.delay(user)      # avoid: not serializable

The AsyncResult Handle

delay() returns an AsyncResult. You can store its id and later check status or fetch the return value from the result backend.

result = add.delay(2, 3)
print(result.id)

More Control with apply_async

Need a countdown or a specific queue? Use apply_async(), the fuller version of delay with extra options.

add.apply_async((2, 3), countdown=10)  # run after 10s

Retry on Failure

Bind a task and call self.retry() to re-run it after an error, perfect for flaky network calls that may succeed next time.

@shared_task(bind=True, max_retries=3)
def fetch(self):
    try:
        call_api()
    except Exception as e:
        raise self.retry(exc=e)

Idempotent Tasks Win

Because tasks can retry, aim to make them idempotent: running twice should be safe and not double-charge or double-send. 🔁

Watch the Worker Log

When you call delay, watch the worker terminal. You will see the task received and its result, which is the fastest way to debug. 👀

Quick Check

How do you run a Celery task in the background?

Recap: Writing Tasks

Decorate a function with @shared_task, call it with .delay() to queue it, pass simple ids, and design tasks to retry safely. 🎯

Questions Fréquemment Posées

La leçon « Écrire et appeler @shared_task » est-elle gratuite ?

Oui — le texte complet de « Écrire et appeler @shared_task » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Django Academy, passe à CoddyKit PRO. Le cours Django Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Écrire et appeler @shared_task » ?

Exécutez des fonctions de manière asynchrone avec delay(). Tu pratiques Django Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Django Academy ?

Aucune expérience préalable n'est requise. Django Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Écrire et appeler @shared_task » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Django Academy ?

Oui. Chaque leçon Django Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Pourquoi utiliser des tâches en arrière-plan
Configurer Celery avec un courtier
Écrire et appeler @shared_task
Tâches planifiées avec Celery Beat

← Retour à Django Academy