github-actions
is a collection of end-user GitHub Actions that integrate with Cloud Native Buildpacks projects.
The buildpack-info action parses a buildpack.toml
and exposes the contents of the [buildpack]
block as output parameters.
uses: docker://ghcr.io/buildpacks/actions/buildpack-info
Parameter | Description |
---|---|
path |
Optional path to buildpack.toml . Defaults to <working-dir>/buildpack.toml |
Parameter | Description |
---|---|
id |
The contents of buildpack.id |
name |
The contents of buildpack.name |
version |
The contents of buildpack.version |
homepage |
The contents of buildpack.homepage |
The registry action adds and yanks buildpack releases in the Buildpack Registry Index.
uses: docker://ghcr.io/buildpacks/actions/registry
with:
token: ${{ secrets.IMPLEMENTATION_PAT }}
id: $buildpacksio/test-buildpack
version: ${{ steps.deploy.outputs.version }}
address: index.docker.io/buildpacksio/test-buildpack@${{ steps.deploy.outputs.digest }}
Parameter | Description |
---|---|
token |
A GitHub token with public_repo scope to open an issue against buildpacks/registry-index . |
id |
A buildpack id that your user is allowed to manage. This is must be in {namespace}/{name} format. |
version |
The version of the buildpack that is being added to the registry. |
address |
The Docker URI of the buildpack artifact. This is must be in {host}/{repo}@{digest} form. |
uses: docker://ghcr.io/buildpacks/actions/registry
with:
token: ${{ secrets.IMPLEMENTATION_PAT }}
id: buildpacksio/test-buildpack
version: ${{ steps.deploy.outputs.version }}
yank: true
Parameter | Description |
---|---|
token |
A GitHub token with public_repo scope to open an issue against buildpacks/registry-index . |
id |
A buildpack id that your user is allowed to manage. This is must be in {namespace}/{name} format. |
version |
The version of the buildpack that is being added to the registry. |
yank |
true if this version should be yanked. |
The setup-pack action adds crane, jq
, pack
, and yj
to the environment.
uses: buildpacks/github-actions/setup-pack
Parameter | Description |
---|---|
crane-version |
Optional version of crane to install. Defaults to latest release. |
jq-version |
Optional version of jq to install. Defaults to latest release. |
pack-version |
Optional version of pack to install. Defaults to latest release. |
yj-version |
Optional version of yj to install. Defaults to latest release. |
The verify-buildpackage action parses the metadata on a buildpackage and verifies that the id
and version
match expected values.
uses: docker://ghcr.io/buildpacks/actions/verify-buildpackage
with:
id: test-buildpack
version: "1.0.0"
address: ghcr.io/example/test-buildpack@sha256:04ba2d17480910bd340f0305d846b007148dafd64bc6fc2626870c174b7c7de7
Parameter | Description |
---|---|
id |
The expected id for the buildpackage |
version |
The expected version for the buildpackage |
address |
The digest-style address of the buildpackage to verify |
This library is released under version 2.0 of the Apache License.