An OCI plugin for the Pants build system
Project description
OCI backend for Pants
This is a backend implementing support for building OCI images in pants; running them, and publishing them to container registries. To do this, this plugin uses three different tools:
Planned and missing features
- Currently there's no support for pulling tags, as that would break determinism
- Multi-platform SHA/.sig is untested/unsupported
- skopeo doesn't support MacOS, preventing pulling and pushing images.
- No empty image base
- No "in-container" build steps
Targets
There's three targets currently implemented:
oci_pull_image
oci_pull_images
oci_build_image
There are also plans to support targets optimized for various languages.
oci_pull_image
Pull an image from a repository with a specific digest.
oci_pull_image(
name="base-python",
repository="docker.io/library/python",
sha="b78b777208be08edd8f297035cdfbacddb45170ad778fd643c792ee045187e39"
)
Argument | Meaning | Default value |
---|---|---|
name | The target name | Same as any other target, which is the directory name |
repository | Fully qualified repository name | Required |
sha | The digest of the image, minus the @sha: prefix. | Required |
decsription | A description of the target | "" |
tags | List of tags | [] |
oci_pull_images
Pull multiple shas for an image, generating a target for each. In the below example, we'd get the targets :python#slim
and :python#buster
.
oci_pull_image(
name="python",
repository="docker.io/library/python",
variants={
"slim": "f8fbb2370c6314c806b2ddbec8d94375987e16bc122379bef979c6fc5e962920",
"buster": "97c123c899c8c9ca46248f4002ec4173322e0a1086b386efefac163c64967ba2"
}
)
Argument | Meaning | Default value |
---|---|---|
name | The target name | Same as any other target, which is the directory name |
repository | Fully qualified repository name | Required |
variants | Dictionary with local tags to the remote sha | Required |
decsription | A description of the target | "" |
tags | List of tags | [] |
oci_build_image
Pull multiple shas for an image, generating a target for each.
oci_build_image(
name="my-server",
base=":python#slim",
repository="my-registry.example.com/a-namespace/an-image",
tag="latest",
packages=[":my_pex"]
)
Argument | Meaning | Default value |
---|---|---|
name | The target name | Same as any other target, which is the directory name |
base | The base image to use. Matches the FROM directive in a Dockerfile |
Required |
packages | Packaged targets to include. The first element will be used as the entrypoint. | [] |
repository | Fully qualified repository name | Required when publishing |
tag | Remote tag to use | Required when publishing |
decsription | A description of the target | "" |
tags | List of tags | [] |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pants-backend-oci-0.1.1.tar.gz
(11.3 kB
view hashes)
Built Distribution
Close
Hashes for pants_backend_oci-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 550dc44a5bda1de4dce247eb48e87224b01da4bbf4d512f95ed3a55d3dd89609 |
|
MD5 | 49e0e0fdbf1c2278a424f5feee6798d7 |
|
BLAKE2b-256 | 54f38f1d8119409e474cdcfa0c676df6e21ef00229640424c4a1db9cea5ec3d0 |