[3/3] incubator-airflow git commit: Add known issue of 'num_runs'

[bo...@apache.org]

Add known issue of 'num_runs'


Project: http://git-wip-us.apache.org/repos/asf/incubator-airflow/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-airflow/commit/8aacc283
Tree: http://git-wip-us.apache.org/repos/asf/incubator-airflow/tree/8aacc283
Diff: http://git-wip-us.apache.org/repos/asf/incubator-airflow/diff/8aacc283

Branch: refs/heads/v1-8-test
Commit: 8aacc283a6b3a605648bf4bd1361225a2a3678d9
Parents: 7925bed
Author: Bolke de Bruin <bo...@xs4all.nl>
Authored: Fri Feb 10 14:53:02 2017 +0100
Committer: Bolke de Bruin <bo...@xs4all.nl>
Committed: Fri Feb 10 14:55:49 2017 +0100

----------------------------------------------------------------------
 UPDATING.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-airflow/blob/8aacc283/UPDATING.md
----------------------------------------------------------------------
diff --git a/UPDATING.md b/UPDATING.md
index b56aca8..b0ab212 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -43,7 +43,7 @@ loops. This is now time bound and defaults to `-1`, which means run continuously
 #### num_runs
 Previously `num_runs` was used to let the scheduler terminate after a certain amount of loops. Now num_runs specifies 
 the number of times to try to schedule each DAG file within `run_duration` time. Defaults to `-1`, which means try
-indefinitely.
+indefinitely. This is only available on the command line.
 
 #### min_file_process_interval
 After how much time should an updated DAG be picked up from the filesystem.
@@ -107,6 +107,21 @@ supported and will be removed entirely in Airflow 2.0
   Previously, `Operator.__init__()` accepted any arguments (either positional `*args` or keyword `**kwargs`) without 
   complaint. Now, invalid arguments will be rejected. (https://github.com/apache/incubator-airflow/pull/1285)
 
+### Known Issues
+There is a report that the default of "-1" for num_runs creates an issue where errors are reported while parsing tasks.
+It was not confirmed, but a workaround was found by changing the default back to `None`.
+
+To do this edit `cli.py`, find the following:
+
+```
+        'num_runs': Arg(
+            ("-n", "--num_runs"),
+            default=-1, type=int,
+            help="Set the number of runs to execute before exiting"),
+```
+
+and change `default=-1` to `default=None`. Please report on the mailing list if you have this issue.
+
 ## Airflow 1.7.1.2
 
 ### Changes to Configuration