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