气流：你能把任务的描述放在仪表板上吗？

Question

我似乎找不到一种方法来描述 Airflow 任务，以便它们显示在仪表板中。我正在阅读他们的文档，但也找不到。有谁知道这是否可能？

Answer 1

您可以使用doc或doc_<json|yaml|md|rst>字段记录 DAG 和任务，具体取决于您希望它的格式。这些将显示在 DAG 的“图形视图”和任务的“任务详细信息”下的仪表板上。

例子：

"""
# Foo
Hello, these are DAG docs.
"""

...

dag = DAG(
    'test.foo',
    default_args=default_args,
)
dag.doc_md = __doc__

with dag:
    task1 = DummyOperator(
        task_id='task1',
    )
    task1.doc_md = 'Hi, these are task docs.'

这将导致以下结果：

此功能记录在https://airflow.apache.org/docs/apache-airflow/stable/concepts/dags.html#dag-task-documentation 中。