kaxil commented on a change in pull request #10916:
URL: https://github.com/apache/airflow/pull/10916#discussion_r487943708
##########
File path: docs/executor/kubernetes.rst
##########
@@ -41,6 +41,62 @@ The volumes are optional and depend on your configuration.
There are two volumes
To troubleshoot issue with KubernetesExecutor, you can use ``airflow
kubernetes generate-dag-yaml`` command.
This command generates the pods as they will be launched in Kubernetes and
dumps them into yaml files for you to inspect.
+.. _concepts:pod_template_file:
+
+pod_template_file
+#################
+
+As of Airflow 1.10.12, you can now use the ``pod_template_file`` option in the
``kubernetes`` section
+of their airflow.cfg to form the basis of your KubernetesExecutor pods. This
process is faster to execute
+and easier to modify.
+
+We include multiple examples of working pod operators below, but we would also
like to explain a few necessary components
+if you want to customize your template files. As long as you have these
components, every other element
+in the template is
+customizable.
+
+1. Airflow will overwrite the base container image and the pod name
+
+There are two points where airflow potentially overwrites the base image: in
the airflow.cfg
Review comment:
```suggestion
There are two points where Airflow potentially overwrites the base image: in
the airflow.cfg
```
##########
File path: docs/executor/kubernetes.rst
##########
@@ -41,6 +41,62 @@ The volumes are optional and depend on your configuration.
There are two volumes
To troubleshoot issue with KubernetesExecutor, you can use ``airflow
kubernetes generate-dag-yaml`` command.
This command generates the pods as they will be launched in Kubernetes and
dumps them into yaml files for you to inspect.
+.. _concepts:pod_template_file:
+
+pod_template_file
+#################
+
+As of Airflow 1.10.12, you can now use the ``pod_template_file`` option in the
``kubernetes`` section
+of their airflow.cfg to form the basis of your KubernetesExecutor pods. This
process is faster to execute
+and easier to modify.
+
+We include multiple examples of working pod operators below, but we would also
like to explain a few necessary components
+if you want to customize your template files. As long as you have these
components, every other element
+in the template is
+customizable.
+
+1. Airflow will overwrite the base container image and the pod name
+
+There are two points where airflow potentially overwrites the base image: in
the airflow.cfg
Review comment:
```suggestion
There are two points where Airflow potentially overwrites the base image: in
the ``airflow.cfg``
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
