Files
docker-check-tag-exists/README.md
2023-01-11 01:07:37 -05:00

44 lines
1.5 KiB
Markdown

# docker-check-base-image-diff
A Github Action that checks whether a derived image does not consist of a base image. Leverages
[`skopeo`](https://github.com/containers/skopeo) and [`jq`](https://stedolan.github.io/jq/).
Based on [lucacome's docker-image-update-checker](https://github.com/lucacome/docker-image-update-checker).
## Usage
Note that this action _assumes_ that `skopeo` is installed; this appears to be true for GitHub's Ubuntu runners.
### Inputs
#### `base-image`
A required argument, this represents the "base" image you want to check against.
As this is based on `skopeo`, it expects a string representing a container, and following a certain format
(e.g. `docker://rust:slim-buster`). For more information, see [the `skopeo` README](https://github.com/containers/skopeo#skopeo-).
#### `derived-image`
A required argument, this represents the "derived" image you want to check.
As this is based on `skopeo`, it expects a string representing a container, and following a certain format
(e.g. `docker://rust:slim-buster`). For more information, see [the `skopeo` README](https://github.com/containers/skopeo#skopeo-).
### Outputs
#### `differs`
The action returns either `true` or `false`, indicating if the derived image differs from the base image (e.g. if derived does not contain the base, it returns `true`).
## Example
```yaml
- name: Run
id: run
uses: ClementTsang/docker-check-base-image-diff@v0.0.2
with:
base-image: docker://rust:slim-buster
derived-image: docker://ghcr.io/clementtsang/cargo-deb-arm
```