1buildah-manifest-push(1)    General Commands Manual   buildah-manifest-push(1)
2
3
4

NAME

6       buildah-manifest-push  -  Push a manifest list or image index to a reg‐
7       istry.
8
9

SYNOPSIS

11       buildah manifest push  [options...]  listNameOrIndexName  transport:de‐
12       tails
13
14

DESCRIPTION

16       Pushes a manifest list or image index to a registry.
17
18

RETURN VALUE

20       The list image's ID and the digest of the image's manifest.
21
22

OPTIONS

24       --add-compression compression
25
26
27       Makes  sure  that  requested  compression  variant for each platform is
28       added to the manifest list keeping original instance intact in the same
29       manifest list. Supported values are (gzip, zstd and zstd:chunked)
30
31
32       Note:  This is different than --compression which replaces the instance
33       with requested with specified compression while --add-compression makes
34       sure  than  each instance has it variant added to manifest list without
35       modifying the original instance.
36
37
38       --all
39
40
41       Push the images mentioned in the manifest list or image index, in addi‐
42       tion to the list or index itself.
43
44
45       --authfile path
46
47
48       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
49       ers/auth.json, which is set using buildah login.  If the  authorization
50       state  is  not found there, $HOME/.docker/config.json is checked, which
51       is set using docker login.
52
53
54       --cert-dir path
55
56
57       Use certificates at path (*.crt, *.cert, *.key) to connect to the  reg‐
58       istry.  The default certificates directory is /etc/containers/certs.d.
59
60
61       --compression-format format
62
63
64       Specifies  the  compression format to use.  Supported values are: gzip,
65       zstd and zstd:chunked.
66
67
68       --compression-level level
69
70
71       Specify the compression level used with the compression.
72
73
74       Specifies the compression level to use.  The value is specific  to  the
75       compression  algorithm  used,  e.g. for zstd the accepted values are in
76       the range 1-20 (inclusive), while for gzip it is 1-9 (inclusive).
77
78
79       --creds creds
80
81
82       The [username[:password]] to use to authenticate with the  registry  if
83       required.   If  one  or  both  values  are not supplied, a command line
84       prompt will appear and the value can be entered.  The password  is  en‐
85       tered without echo.
86
87
88       --digestfile Digestfile
89
90
91       After copying the image, write the digest of the resulting image to the
92       file.
93
94
95       --force-compression
96
97
98       If set, push uses the specified compression algorithm even if the  des‐
99       tination  contains  a differently-compressed variant already.  Defaults
100       to true if --compression-format is explicitly specified on the command-
101       line, false otherwise.
102
103
104       --format, -f
105
106
107       Manifest  list type (oci or v2s2) to use when pushing the list (default
108       is oci).
109
110
111       --quiet, -q
112
113
114       Don't output progress information when pushing lists.
115
116
117       --remove-signatures
118
119
120       Don't copy signatures when pushing images.
121
122
123       --rm
124
125
126       Delete the manifest list or image index from local storage  if  pushing
127       succeeds.
128
129
130       --sign-by fingerprint
131
132
133       Sign  the  pushed  images  using the GPG key that matches the specified
134       fingerprint.
135
136
137       --tls-verify bool-value
138
139
140       Require HTTPS and verification of certificates  when  talking  to  con‐
141       tainer  registries (defaults to true).  TLS verification cannot be used
142       when talking to an insecure registry.
143
144

EXAMPLE

146              buildah manifest push mylist:v1.11 registry.example.org/mylist:v1.11
147
148
149

SEE ALSO

151       buildah(1),  buildah-login(1),  buildah-manifest(1),  buildah-manifest-
152       create(1),  buildah-manifest-add(1),  buildah-manifest-remove(1), buil‐
153       dah-manifest-annotate(1), buildah-manifest-inspect(1),  buildah-rmi(1),
154       docker-login(1)
155
156
157
158buildah                         September 2019        buildah-manifest-push(1)
Impressum