root
/
buildah
mirror of https://github.com/containers/buildah.git
1
0
Fork 0
Code Issues Actions 3 Packages Projects Releases Wiki Activity
buildah/docs/buildah-source-add.1.md

22 lines
634 B
Markdown
Raw Permalink Normal View History

Install new manpages to correct sections Signed-off-by: Reinhard Tartler <siretart@tauware.de>
2021-08-30 03:28:53 +08:00
# buildah-source-add "1" "March 2021" "buildah"
buildah source - create and manage source images Add new `buildah source {create,add,push,pull}` commands. All commands are marked as experimental. None of it is meant to be officially supported at the time of writing. All code resides in `internal/source` and is hence not visible to external consumers of Buildah; just to be on the safe side. A source container or source image is an OCI artifact, that is an OCI image with custom config (media type). There is a longer history behind source images which are intended to ship the source artifacts of an ordinary "executable" container image. Until now, source images at Red Hat are built with github.com/containers/BuildSourceImage. We had a growing desire (and always the long-term plan) to eventually replace BuildSurceImage with something else, in this case Buildah. This commit adds the initial base functionality along with tests to make sure we're not regressing. The new commands do the following: * `create` - creates an empty and initialized source image * `add` - tar up a local path and add it as a layer to the souce image * `push/pull` - intentionally separate commands from `buildah push/pull` to allow for an easier usage and prevent the implementations from undesired (future) interference Further note: also vendor in c/image@master which ships a required fix. Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2021-03-22 20:02:39 +08:00
## NAME
buildah\-source\-add - Add a source artifact to a source image
## SYNOPSIS
**buildah source add** [*options*] *path* *artifact*
## DESCRIPTION
Add add a source artifact to a source image. The artifact will be added as a
gzip-compressed tar ball. Add attempts to auto-tar and auto-compress only if
necessary.
Note that the buildah-source command and all its subcommands are experimental
and may be subject to future changes
## OPTIONS
imagebuildah: handle --manifest directly When we're told to add built images to a manifest list, manipulate the list ourselves, so that if we're creating a list, we won't have a partially-populated list if some of the builds fail. This also lets us include all of the platform information (including variant info, which we can't sniff out after the fact) that we were given when we started building the images. Signed-off-by: Nalin Dahyabhai <nalin@redhat.com>
2021-08-11 06:11:15 +08:00
buildah source - create and manage source images Add new `buildah source {create,add,push,pull}` commands. All commands are marked as experimental. None of it is meant to be officially supported at the time of writing. All code resides in `internal/source` and is hence not visible to external consumers of Buildah; just to be on the safe side. A source container or source image is an OCI artifact, that is an OCI image with custom config (media type). There is a longer history behind source images which are intended to ship the source artifacts of an ordinary "executable" container image. Until now, source images at Red Hat are built with github.com/containers/BuildSourceImage. We had a growing desire (and always the long-term plan) to eventually replace BuildSurceImage with something else, in this case Buildah. This commit adds the initial base functionality along with tests to make sure we're not regressing. The new commands do the following: * `create` - creates an empty and initialized source image * `add` - tar up a local path and add it as a layer to the souce image * `push/pull` - intentionally separate commands from `buildah push/pull` to allow for an easier usage and prevent the implementations from undesired (future) interference Further note: also vendor in c/image@master which ships a required fix. Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
2021-03-22 20:02:39 +08:00
**--annotation** *key=value*
Add an annotation to the layer descriptor in the source-image manifest. The input format is `key=value`.