1atomic-reactor(1) General Commands Manual atomic-reactor(1)
2
6 atomic-reactor [-h] [-q | -v | -V] {build,create-build-image,inside-
7 build} ...
8
12 {build,create-build-image,inside-build}
13 commands
14 -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
23 atomic-reactor [OPTIONS] build
24 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
37 atomic-reactor [OPTIONS] build git
38 -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 atomic-reactor [OPTIONS] build json
79 -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 atomic-reactor [OPTIONS] build path
103 -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 atomic-reactor [OPTIONS] create-build-image
146 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 atomic-reactor [OPTIONS] inside-build
170 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
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 2016-12-14 atomic-reactor(1)