mirror of
https://github.com/redhat-actions/push-to-registry.git
synced 2025-02-23 02:21:22 +01:00
Update readme
Signed-off-by: Tim Etchells <tetchel@gmail.com>
This commit is contained in:
parent
321a4c5e98
commit
9257a569a9
1 changed files with 25 additions and 23 deletions
48
README.md
48
README.md
|
@ -14,7 +14,7 @@ Push-to-registry is a GitHub Action for pushing a container image to an image re
|
||||||
|
|
||||||
This action only runs on Linux, as it uses [podman](https://github.com/containers/Podman) to perform the push. [GitHub's Ubuntu action runners](https://github.com/actions/virtual-environments#available-environments) come with Podman preinstalled. If you are not using those runners, you must first [install Podman](https://podman.io/getting-started/installation).
|
This action only runs on Linux, as it uses [podman](https://github.com/containers/Podman) to perform the push. [GitHub's Ubuntu action runners](https://github.com/actions/virtual-environments#available-environments) come with Podman preinstalled. If you are not using those runners, you must first [install Podman](https://podman.io/getting-started/installation).
|
||||||
|
|
||||||
To log in to a container image registry, [**podman-login**](https://github.com/redhat-actions/podman-login) action can be used.
|
You can log in to your container registry for the entire job using the [**podman-login**](https://github.com/redhat-actions/podman-login) action. Otherwise, use the `username` and `password` inputs to log in for this step.
|
||||||
|
|
||||||
## Action Inputs
|
## Action Inputs
|
||||||
|
|
||||||
|
@ -23,22 +23,31 @@ Refer to the [`podman push`](http://docs.podman.io/en/latest/markdown/podman-man
|
||||||
| Input Name | Description | Default |
|
| Input Name | Description | Default |
|
||||||
| ---------- | ----------- | ------- |
|
| ---------- | ----------- | ------- |
|
||||||
| image | Name of the image you want to push. | **Required**
|
| image | Name of the image you want to push. | **Required**
|
||||||
| tags | The tag or tags of the image to push. For multiple tags, seperate by a space. For example, `latest ${{ github.sha }}` | `latest`
|
| tags | The tag or tags of the image to push. For multiple tags, separate by a space. For example, `latest ${{ github.sha }}`. | `latest`
|
||||||
| registry | URL of the registry to push the image to. Eg. `quay.io/<username>` | **Required**
|
| registry | URL of the registry to push the image to. Eg. `quay.io/<username>` | **Required**
|
||||||
| username | Username with which to authenticate to the registry. Required unless already logged in to the registry | None
|
| username | Username with which to authenticate to the registry. Required unless already logged in to the registry. | None
|
||||||
| password | Password, encrypted password, or access token with which to authenticate to the registry. Required unless already logged in to the registry | None
|
| password | Password, encrypted password, or access token to use to log in to the registry. Required unless already logged in to the registry. | None
|
||||||
| tls-verify | Verify TLS certificates when contacting the registry. Set to `false` to skip certificate verification. | `true`
|
| tls-verify | Verify TLS certificates when contacting the registry. Set to `false` to skip certificate verification. | `true`
|
||||||
| digestfile | After copying the image, write the digest of the resulting image to the file. The contents of this file are the digest output. | Auto determined from image and tag
|
| digestfile | After copying the image, write the digest of the resulting image to the file. The contents of this file are the digest output. | Auto-generated from image and tag
|
||||||
| extra-args | Extra args to be passed to podman push. Separate arguments by newline. Do not use quotes. | None
|
| extra-args | Extra args to be passed to podman push. Separate arguments by newline. Do not use quotes. | None
|
||||||
|
|
||||||
## Action Outputs
|
## Action Outputs
|
||||||
|
|
||||||
`digest`: The pushed image digest, as written to the `digestfile`.<br>
|
`digest`: The pushed image digest, as written to the `digestfile`.<br>
|
||||||
For example, `sha256:66ce924069ec4181725d15aa27f34afbaf082f434f448dc07a42daa3305cdab3`.
|
For example:
|
||||||
|
```
|
||||||
|
sha256:66ce924069ec4181725d15aa27f34afbaf082f434f448dc07a42daa3305cdab3
|
||||||
|
```
|
||||||
|
|
||||||
For multiple tags, the digest is the same.
|
For multiple tags, the digest is the same.
|
||||||
|
|
||||||
`registry-paths`: A JSON array of registry paths to which the tag(s) were pushed.<br>
|
`registry-paths`: A JSON array of registry paths to which the tag(s) were pushed.<br>
|
||||||
For example, `[ quay.io/username/spring-image:v1, quay.io/username/spring-image:latest ]`.
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
```
|
||||||
|
[ "quay.io/username/spring-image:v1", "quay.io/username/spring-image:latest" ]
|
||||||
|
```
|
||||||
|
|
||||||
`registry-path`: The first element of `registry-paths`, as a string.
|
`registry-path`: The first element of `registry-paths`, as a string.
|
||||||
|
|
||||||
|
@ -54,11 +63,6 @@ jobs:
|
||||||
build:
|
build:
|
||||||
name: Build and push image
|
name: Build and push image
|
||||||
runs-on: ubuntu-20.04
|
runs-on: ubuntu-20.04
|
||||||
env:
|
|
||||||
IMAGE_NAME: my-app
|
|
||||||
IMAGE_TAGS: latest v1
|
|
||||||
REGISTRY_USER: quayuser
|
|
||||||
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
|
@ -67,27 +71,25 @@ jobs:
|
||||||
id: build-image
|
id: build-image
|
||||||
uses: redhat-actions/buildah-build@v2
|
uses: redhat-actions/buildah-build@v2
|
||||||
with:
|
with:
|
||||||
image: ${{ env.IMAGE_NAME }}
|
image: my-app
|
||||||
tags: ${{ env.IMAGE_TAGS }}
|
tags: latest ${{ github.sha }}
|
||||||
base-image: some_image
|
|
||||||
dockerfiles: |
|
dockerfiles: |
|
||||||
./Dockerfile
|
./Dockerfile
|
||||||
|
|
||||||
# Podman Login action (https://github.com/redhat-actions/podman-login) can be used
|
# Podman Login action (https://github.com/redhat-actions/podman-login) also be used to log in,
|
||||||
# in the previous step to log in to a container registry. In that case input "username"
|
# in which case 'username' and 'password' can be omitted.
|
||||||
# "password" can be omitted in this push action.
|
|
||||||
- name: Push To quay.io
|
- name: Push To quay.io
|
||||||
id: push-to-quay
|
id: push-to-quay
|
||||||
uses: redhat-actions/push-to-registry@v2
|
uses: redhat-actions/push-to-registry@v2
|
||||||
with:
|
with:
|
||||||
image: ${{ steps.build-image.outputs.image }}
|
image: ${{ steps.build-image.outputs.image }}
|
||||||
tags: ${{ steps.build-image.outputs.tags }}
|
tags: ${{ steps.build-image.outputs.tags }}
|
||||||
registry: ${{ secrets.QUAY_REPO }}
|
registry: quay.io/quay-user
|
||||||
username: ${{ env.REGISTRY_USER }}
|
username: quay-user
|
||||||
password: ${{ env.REGISTRY_PASSWORD }}
|
password: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
|
|
||||||
- name: Use the image
|
- name: Print image url
|
||||||
run: echo "New image has been pushed to ${{ steps.push-to-quay.outputs.registry-paths }}"
|
run: echo "Image pushed to ${{ steps.push-to-quay.outputs.registry-paths }}"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Note about images built with Docker
|
## Note about images built with Docker
|
||||||
|
|
Loading…
Add table
Reference in a new issue