Skip to content

Document best practices for using ‎uvicorn API server on Kubernetes #61431

@jason810496

Description

@jason810496

Body

When running the Airflow API server with the default ‎uvicorn mode on Kubernetes, users may still want a strategy to periodically restart pods to avoid long‑lived process issues (e.g. memory growth, stale state), especially since ‎uvicorn does not support rolling worker restarts like the new ‎gunicorn mode.

We should:

  • Extend ‎airflow-core/docs/administration-and-deployment/web-stack.rst to document:
    • Best practices for running the API server with ‎uvicorn on Kubernetes.
    • Example approaches for periodically restarting API server pods (e.g. cluster‑level mechanisms, rolling restarts) and when this is recommended vs. relying on Kubernetes OOM/restarts.
    • Cross‑link this section from any API server / web‑stack docs that discuss server types (‎server_type = uvicorn|gunicorn).

Committer

  • I acknowledge that I am a maintainer/committer of the Apache Airflow project.

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions