grim/convey

Bump the version for release
v0.14.0-alpha3
2018-02-20, Gary Kramlich
166a6d1979fa
Bump the version for release
# Intrinsic
The intrinsic package provides some intrinsic tasks that convey provides.
## convey/clean Task
A clean task will remove files from the host relative and limited to the working directory of convey.
### Attributes
| Name | Required | Default | Description |
| --------- | -------- | ------- | ----------- |
| files | Yes | | A list of filenames relative to the convey working directory to remove. |
### Example
clean:
type: convey/clean
files:
- convey-amd64
- "**/*.pyc"
- "**/__pycache__"
----
## convey/extend Task
An convey/extend task overrides the environment of another task.
### Attributes
| Name | Required | Default | Description |
| ---------------- | -------- | ------- | ----------- |
| task | Yes | | The name of the task to extend |
| environment | | | The override environment |
| expand | | | The envvars which can be expanded into lists on use |
| expand_delimiter | | ; | The string to split mapped values by |
The `expand` and `expand_delimiter` attributes allow an environment variable, which is an unstructured string, to act as if it is an array. This is useful for supplying an "abstract" parent task with several arguments for the same attribute (e.g. tags in a build task). Variables that occur in the environment with a name in expand will be split by the expand delimiter to form a list, where applicable.
### Example
greeting:
type: docker/run
image: gliderlabs/alpine:edge
script:
- echo "${MESSAGE}"
environment:
- MESSAGE="Hello, World"
informal-greeting:
type: convey/extend
task: greeting
environment:
- MESSAGE="Hi!"
### Example with Variable Expansion
tag-alpine:
type: docker/tag
source: gliderlabs/alpine:edge
destinations: ${TAGS}
tag-concrete:
type: convey/extend
task: tag-alpine
environment:
- TAGS=foo;bar;baz
expand:
- TAGS
----
## convey/noop Task
A noop task does nothing. It is a "No Operation" task. It's used primarily in
testing, but could be used for stubbing stuff out or whatever.
### Attributes
None.
### Example
clean:
type: convey/noop