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

NAME

6       buildah-manifest-add - Add an image to a manifest list or image index.
7
8

SYNOPSIS

10       buildah manifest add listNameOrIndexName imageName
11
12

DESCRIPTION

14       Adds the specified image to the specified manifest list or image index.
15
16

RETURN VALUE

18       The list image's ID and the digest of the image's manifest.
19
20

OPTIONS

22       --all
23
24
25       If  the  image  which  should be added to the list or index is itself a
26       list or index, add all of the contents to the local list.  By  default,
27       only  one  image from such a list or index will be added to the list or
28       index.  Combining --all with any of the other options  described  below
29       is NOT recommended.
30
31
32       --annotation annotation=value
33
34
35       Set an annotation on the entry for the newly-added image.
36
37
38       --arch
39
40
41       Override the architecture which the list or index records as a require‐
42       ment for the image.  If imageName refers to a manifest  list  or  image
43       index,  the architecture information will be retrieved from it.  Other‐
44       wise, it will be retrieved from the image's configuration information.
45
46
47       --authfile path
48
49
50       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
51       ers/auth.json,  which is set using buildah login.  If the authorization
52       state is not found there, $HOME/.docker/config.json is  checked,  which
53       is set using docker login.
54
55
56       --cert-dir path
57
58
59       Use  certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
60       istry.  The default certificates directory is /etc/containers/certs.d.
61
62
63       --creds creds
64
65
66       The [username[:password]] to use to authenticate with the  registry  if
67       required.   If  one  or  both  values  are not supplied, a command line
68       prompt will appear and the value  can  be  entered.   The  password  is
69       entered without echo.
70
71
72       --features
73
74
75       Specify  the  features list which the list or index records as require‐
76       ments for the image.  This option is rarely used.
77
78
79       --os
80
81
82       Override the OS which the list or index records as  a  requirement  for
83       the  image.  If imageName refers to a manifest list or image index, the
84       OS information will be  retrieved  from  it.   Otherwise,  it  will  be
85       retrieved from the image's configuration information.
86
87
88       --os-features
89
90
91       Specify  the  OS  features  list  which  the  list  or index records as
92       requirements for the image.  This option is rarely used.
93
94
95       --os-version
96
97
98       Specify the OS version which the list or index records as a requirement
99       for the image.  This option is rarely used.
100
101
102       --tls-verify bool-value
103
104
105       Require  HTTPS  and  verification  of certificates when talking to con‐
106       tainer registries (defaults to true).  TLS verification cannot be  used
107       when talking to an insecure registry.
108
109
110       --variant
111
112
113       Specify  the  variant  which  the  list or index records for the image.
114       This option is typically used to distinguish between  multiple  entries
115       which  share  the  same  architecture value, but which expect different
116       versions of its instruction set.
117
118

EXAMPLE

120              buildah manifest add mylist:v1.11 docker://fedora
121              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7
122
123
124
125              buildah manifest add --all mylist:v1.11 docker://fedora
126              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7
127
128
129
130              buildah manifest add --arch arm64 --variant v8 mylist:v1.11 docker://fedora@sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b
131              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b
132
133
134

SEE ALSO

136       buildah(1),   buildah-login(1),   buildah-manifest(1),    buildah-mani‐
137       fest-create(1),    buildah-manifest-remove(1),   buildah-manifest-anno‐
138       tate(1), buildah-manifest-inspect(1),  buildah-manifest-push(1),  buil‐
139       dah-rmi(1), docker-login(1)
140
141
142
143buildah                         September 2019         buildah-manifest-add(1)
Impressum