1atomic-reactor(1)           General Commands Manual          atomic-reactor(1)
2
3
4

SYNOPSIS

6        atomic-reactor  [-h]  [-q | -v | -V] {build,create-build-image,inside-
7       build} ...
8
9
10

OPTIONS

12         {build,create-build-image,inside-build}
13                               commands
14
15         -h, --help            show this help message and exit
16         -q, --quiet
17         -v, --verbose
18         -V, --version         show program's version number and exit
19
20
21

COMMANDS

23       atomic-reactor [OPTIONS] build
24
25         This command enables you to build images. Currently,  you  can  build
26       images
27         from  git  repo, local path or a json file with full build specifica‐
28       tion.
29         There are several methods for performing the build: inside a build
30         container using docker from host, inside a build container using new
31         instance of docker, or within current environment.
32         -h, --help  show this help message and exit
33
34
35

COMMANDS

37       atomic-reactor [OPTIONS] build git
38
39         -h, --help            show this help message and exit
40         --image IMAGE         name under which the image will be accessible
41         --uri URI             URI of the git repo
42         --df-path SOURCE__DOCKERFILE_PATH
43                               path to Dockerfile within git repo (default  is
44       ./)
45         --source-registry REGISTRY
46                               registry to pull base image from
47         --source-registry-insecure
48                               allow  connecting to source registry over plain
49       http
50         --target-registries [REGISTRY [REGISTRY ...]]
51                               list of registries to push image to
52         --target-registries-insecure
53                               allow  connecting  to  target  registries  over
54       plain http
55         --dont-pull-base-image
56                               don't pull or update base image specified in
57                               dockerfile
58         --build-image BUILD_IMAGE
59                               name  of  build  image to use (build image type
60       has to
61                               match method)
62         --load-plugin [PLUGIN_FILE [PLUGIN_FILE ...]]
63                               list of files where plugins live
64         --method {hostdocker,privileged,here}
65                               choose method for building image:  'hostdocker'
66       mounts
67                               socket   inside  privileged  container  to  use
68       docker from
69                               host,   'privileged'   runs   separate   docker
70       instance
71                               inside privileged container and 'here' executes
72       build
73                               in current environment
74         --commit SOURCE__PROVIDER_PARAMS__GIT_COMMIT
75                               checkout this commit (default is master)
76
77
78       atomic-reactor [OPTIONS] build json
79
80         -h, --help            show this help message and exit
81         --build-image BUILD_IMAGE
82                               name of build image to use  (build  image  type
83       has to
84                               match method)
85         --load-plugin [PLUGIN_FILE [PLUGIN_FILE ...]]
86                               list of files where plugins live
87         --method {hostdocker,privileged,here}
88                               choose  method for building image: 'hostdocker'
89       mounts
90                               socket  inside  privileged  container  to   use
91       docker from
92                               host,   'privileged'   runs   separate   docker
93       instance
94                               inside privileged container and 'here' executes
95       build
96                               in current environment
97         --substitute [SUBSTITUTE [SUBSTITUTE ...]]
98                               provide   substitutions   for   json   in  form
99       "foo.bar=spam"
100
101
102       atomic-reactor [OPTIONS] build path
103
104         -h, --help            show this help message and exit
105         --image IMAGE         name under which the image will be accessible
106         --uri URI             URI of the directory with source (e.g.
107                               "file:///foo/bar") or path  (e.g.  "/foo/bar");
108       path can
109                               be relative
110         --df-path SOURCE__DOCKERFILE_PATH
111                               path   to  Dockerfile  within  given  directory
112       (default is
113                               ./)
114         --source-registry REGISTRY
115                               registry to pull base image from
116         --source-registry-insecure
117                               allow connecting to source registry over  plain
118       http
119         --target-registries [REGISTRY [REGISTRY ...]]
120                               list of registries to push image to
121         --target-registries-insecure
122                               allow  connecting  to  target  registries  over
123       plain http
124         --dont-pull-base-image
125                               don't pull or update base image specified in
126                               dockerfile
127         --build-image BUILD_IMAGE
128                               name of build image to use  (build  image  type
129       has to
130                               match method)
131         --load-plugin [PLUGIN_FILE [PLUGIN_FILE ...]]
132                               list of files where plugins live
133         --method {hostdocker,privileged,here}
134                               choose  method for building image: 'hostdocker'
135       mounts
136                               socket  inside  privileged  container  to   use
137       docker from
138                               host,   'privileged'   runs   separate   docker
139       instance
140                               inside privileged container and 'here' executes
141       build
142                               in current environment
143
144
145       atomic-reactor [OPTIONS] create-build-image
146
147         Create  build  image;  Atomic  Reactor  installs itself inside and is
148       capable
149         of building images within this image.
150         -h, --help            show this help message and exit
151         --reactor-latest      put latest Atomic Reactor inside  (from  public
152       git)
153         --reactor-remote-git REACTOR_REMOTE_GIT
154                               URL  to  git  repo  with Atomic Reactor (has to
155       contain
156                               setup.py)
157         --reactor-local-path REACTOR_LOCAL_PATH
158                               path to directory with Atomic Reactor  (has  to
159       contain
160                               setup.py)
161         --reactor-tarball-path REACTOR_TARBALL_PATH
162                               path  to distribution tarball with Atomic Reac‐
163       tor
164         --use-cache           use cache to build image (may  be  faster,  but
165       not up to
166                               date)
167
168
169       atomic-reactor [OPTIONS] inside-build
170
171         We do expect we are inside container, therefore we'll read build
172         configuration  from json at '/run/share/build.json'and when the build
173       is
174         done, results are written in that dir so Atomic Reactor from host may
175       read
176         those.
177         -h, --help            show this help message and exit
178         --input  INPUT          input  plugin  name (determined automatically
179       unless
180                               given)
181         --input-arg INPUT_ARG
182                               argument  for  input   plugin   (in   form   of
183       'key=value'),
184                               see  input  plugins to know what arguments they
185       accept
186                               (can be specified multiple times)
187         --dont-pull-base-image
188                               don't pull or update base image specified in
189                               dockerfile
190         --substitute SUBSTITUTE
191                               substitute values in build json (key=value, or
192                               plugin_type.plugin_name.key=value)
193

AUTHORS

195        Jiri  Popelka  <jpopelka@redhat.com>,  Martin   Milata   <mmilata@red‐
196       hat.com>,  Slavek  Kabrda  <slavek@redhat.com>,  Tim Waugh <twaugh@red‐
197       hat.com>, Tomas Tomecek <ttomecek@redhat.com>
198
199
200
201                                  2016-12-14                 atomic-reactor(1)
Impressum