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}/con‐
51       tainers/auth.json.  If  XDG_RUNTIME_DIR  is  not  set,  the  default is
52       /run/containers/$UID/auth.json. This file is created using using  buil‐
53       dah login.
54
55
56       If  the  authorization  state  is  not  found there, $HOME/.docker/con‐
57       fig.json is checked, which is set using docker login.
58
59
60       Note: You can also override the default path of the authentication file
61       by  setting  the  REGISTRY_AUTH_FILE  environment variable. export REG‐
62       ISTRY_AUTH_FILE=path
63
64
65       --cert-dir path
66
67
68       Use certificates at path (*.crt, *.cert, *.key) to connect to the  reg‐
69       istry.  The default certificates directory is /etc/containers/certs.d.
70
71
72       --creds creds
73
74
75       The  [username[:password]]  to use to authenticate with the registry if
76       required.  If one or both values  are  not  supplied,  a  command  line
77       prompt  will  appear and the value can be entered.  The password is en‐
78       tered without echo.
79
80
81       --features
82
83
84       Specify the features list which the list or index records  as  require‐
85       ments for the image.  This option is rarely used.
86
87
88       --os
89
90
91       Override  the  OS  which the list or index records as a requirement for
92       the image.  If imageName refers to a manifest list or image index,  the
93       OS  information  will  be retrieved from it.  Otherwise, it will be re‐
94       trieved from the image's configuration information.
95
96
97       --os-features
98
99
100       Specify the OS features list which the list or  index  records  as  re‐
101       quirements for the image.  This option is rarely used.
102
103
104       --os-version
105
106
107       Specify the OS version which the list or index records as a requirement
108       for the image.  This option is rarely used.
109
110
111       --tls-verify bool-value
112
113
114       Require HTTPS and verification of certificates  when  talking  to  con‐
115       tainer  registries (defaults to true).  TLS verification cannot be used
116       when talking to an insecure registry.
117
118
119       --variant
120
121
122       Specify the variant which the list or  index  records  for  the  image.
123       This  option  is typically used to distinguish between multiple entries
124       which share the same architecture value,  but  which  expect  different
125       versions of its instruction set.
126
127

EXAMPLE

129              buildah manifest add mylist:v1.11 docker://fedora
130              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7
131
132
133
134              buildah manifest add --all mylist:v1.11 docker://fedora
135              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:f81f09918379d5442d20dff82a298f29698197035e737f76e511d5af422cabd7
136
137
138
139              buildah manifest add --arch arm64 --variant v8 mylist:v1.11 docker://fedora@sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b
140              506d8f4bb54931ea03a7e70173a0ed6302e3fb92dfadb3955ba5c17812e95c51: sha256:c829b1810d2dbb456e74a695fd3847530c8319e5a95dca623e9f1b1b89020d8b
141
142
143

SEE ALSO

145       buildah(1),    buildah-login(1),   buildah-manifest(1),   buildah-mani‐
146       fest-create(1),   buildah-manifest-remove(1),    buildah-manifest-anno‐
147       tate(1),  buildah-manifest-inspect(1),  buildah-manifest-push(1), buil‐
148       dah-rmi(1), docker-login(1)
149
150
151
152buildah                         September 2019         buildah-manifest-add(1)
Impressum