You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -453,22 +453,22 @@ The name of resources, and later the name of task outputs, determines the name u
453
453
So, `hello-world` can access anything from `resource-tutorial` (this tutorial's `git` repository) under the `resource-tutorial/` path. Since the relative path of `task_hello_world.yml` task file inside this repo is `01_task_hello_world/task_hello_world.yml`, the `task: hello-world` references it by joining the two: `file: resource-tutorial/01_task_hello_world/task_hello_world.yml`
454
454
455
455
456
-
There is a benefit and a downside to abstracting tasks into YAML files outside of the pipeline.
456
+
There are benefits and downsides to abstracting tasks into YAML files outside of the pipeline.
457
457
458
458
One benefit is that the behavior of the task can be kept in sync with the primary input resource (for example, a software project with tasks for running tests, building binaries, etc).
459
459
460
-
One downside is that the `pipeline.yml` no longer explains exactly what commands will be invoked. Comprehension of pipeline behavior is potentially reduced.
460
+
Another benefit of extracting inline tasks into task files is that `pipeline.yml` files can get long and it can be hard to read and comprehend all the YAML. When extracting tasks into separate files we can give them long names so that readers can understand the purpose and expectation of the tasks at a glance.
461
461
462
-
But one benefit of extracting inline tasks into task files is that `pipeline.yml` files can get long and it can be hard to read and comprehend all the YAML. Instead, give tasks long names so that readers can understand what the purpose and expectation of the task is at a glance.
462
+
One downside is that the `pipeline.yml` no longer explains exactly what commands will be invoked. Comprehension of pipeline behavior is potentially reduced.
463
463
464
-
But one downside of extracting inline tasks into files is that `fly set-pipeline` is no longer the only step to updating a pipeline.
464
+
Also, when we extract inline tasks into files, `fly set-pipeline` is no longer the only step to updating a pipeline.
465
465
466
466
From now onwards, any change to your pipeline might require you to do one or both:
467
467
468
468
* `fly set-pipeline` to update Concourse on a change to the job build plan and/or input/output resources
469
469
* `git commit` and `git push` your primary resource that contains the task files and task scripts
470
470
471
-
If a pipeline is not performing new behaviour then it might be you skipped one of the two steps above.
471
+
If the new behavior you intended is not showing up in the pipeline then you may have skipped one of the two steps above.
0 commit comments