Add readme.
This commit is contained in:
parent
a9d5b4e264
commit
76a2282124
1 changed files with 56 additions and 0 deletions
56
README.md
Normal file
56
README.md
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
# concourse-oci-resource
|
||||||
|
|
||||||
|
A resource type for oci image tarballs.
|
||||||
|
|
||||||
|
## Source configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
resource_types:
|
||||||
|
- name: oci-image
|
||||||
|
type: registry-image
|
||||||
|
source:
|
||||||
|
repository: redxef/concourse-oci-resource
|
||||||
|
resources:
|
||||||
|
- name: my-image
|
||||||
|
type: oci-image
|
||||||
|
source:
|
||||||
|
repository: redxef/concourse-oci-resource
|
||||||
|
tag: latest
|
||||||
|
username: ((registry.username))
|
||||||
|
password: ((registry.password))
|
||||||
|
```
|
||||||
|
|
||||||
|
- repository: *Required*. The URI of the image repository.
|
||||||
|
- tag: *Optional*. *Default* `latest`. The tag of this image.
|
||||||
|
- username: *Optional*. Username used to authenticate.
|
||||||
|
- password: *Optional*. Password used to authenticate.
|
||||||
|
|
||||||
|
## `check`
|
||||||
|
|
||||||
|
Check if there is a new version represented with the given source
|
||||||
|
configuration.
|
||||||
|
|
||||||
|
## `in` receive a OCI tarball
|
||||||
|
|
||||||
|
Creates the following files:
|
||||||
|
|
||||||
|
- `./image.tar`: The image tarball.
|
||||||
|
- `./digest`: A file containing the digest of the pulled image.
|
||||||
|
- `./repository`: The repository name (the same as the source configuration).
|
||||||
|
|
||||||
|
## `out` push an image to a repository
|
||||||
|
|
||||||
|
Push the image to the repository and add tags.
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- put: my-image
|
||||||
|
params:
|
||||||
|
additional_tags: path/to/tags/file
|
||||||
|
```
|
||||||
|
|
||||||
|
### Parameters
|
||||||
|
|
||||||
|
- additional\_tags: *Optional*. The path to a file containing more tags.
|
||||||
|
|
Reference in a new issue