update README.md

This commit is contained in:
eine
2020-06-06 21:44:33 +02:00
parent 6cf8de253a
commit b4dbe55c26

View File

@@ -1,4 +1,6 @@
**tip** is a Docker GitHub Action written in Python. **tip** allows to keep a pre-release and its artifacts up to date with a latest builds. Combined with a workflow that is executed periodically, **tip** allows to provide a fixed release name for users willing to use daily/nightly artifacts of a project. **tip** is a Docker GitHub Action written in Python. **tip** allows to keep a pre-release and its artifacts up to date with latest builds. Combined with a workflow that is executed periodically, **tip** allows to provide a fixed release name for users willing to use daily/nightly artifacts of a project.
# Usage
The following block shows a minimal YAML workflow file: The following block shows a minimal YAML workflow file:
@@ -35,6 +37,22 @@ jobs:
Note that the tag and the pre-release need to be created manually the first time. The workflow above will fail if the release does not exist. Note that the tag and the pre-release need to be created manually the first time. The workflow above will fail if the release does not exist.
The default tag name is `tip`, but it can be optionally overriden through option `tag` or setting envvar `INPUT_TAG`. # Options
If you systematically want to remove previous artifacts (e.g. old versions), set the `rm` option to true. All options can be optionally provided as environment variables: `INPUT_TOKEN`, `INPUT_FILES`, `INPUT_TAG` and/or `INPUT_RM`.
## token (required)
Token to make authenticated API calls; can be passed in using `{{ secrets.GITHUB_TOKEN }}`.
## files (required)
Either a single filename/pattern or a multi-line list can be provided. All the artifacts are uploaded regardless of the hierarchy.
## tag
The default tag name for the tip/nightly pre-release is `tip`, but it can be optionally overriden through option `tag`.
## rm
Set option `rm` to `true` for systematically removing previous artifacts (e.g. old versions). Otherwise (by default), all previours artifacts are preserved or overwritten.