1OC ADM RELEASE(1) June 2016 OC ADM RELEASE(1)
2
6 oc adm release new - Create a new OpenShift release
7
11 oc adm release new [OPTIONS]
12
16 OpenShift uses long-running active management processes called "opera‐
17 tors" to keep the cluster running and manage component lifecycle. This
18 command assists composing a set of images and operator definitions into
19 a single update payload that can be used to update a cluster.
20 Operators are expected to host the config they need to be installed to
23 a cluster in the '/manifests' directory in their image. This command
24 iterates over a set of operator images and extracts those manifests
25 into a single, ordered list of Kubernetes objects that can then be
26 iteratively updated on a cluster by the cluster version operator when
27 it is time to perform an update.
28 Experimental: This command is under active development and may change
31 without notice.
32
36 --allow-missing-images=false
37 Ignore errors when an operator references a release image that is
38 not included.
39 --dir=""
42 Directory to write release contents to, will default to a temporary
43 directory.
44 -f, --filename=[]
47 A file defining a mapping of input images to use to build the
48 release
49 --from-dir=""
52 Use this directory as the source for the release payload.
53 --from-image-stream=""
56 Look at all tags in the provided image stream and build a release
57 payload from them.
58 --max-per-registry=4
61 Number of concurrent images that will be extracted at a time.
62 --name=""
65 The name of the release. Will default to the current time.
66 -o, --output=""
69 Output the mapping definition in this format.
70 -p, --pattern=""
73 The default image pattern.
74 --to-file=""
77 Output the release to a tar file instead of creating an image.
78 --to-image=""
81 The location to upload the release image to.
82 --to-image-base=""
85 If specified, the image to add the release layer on top of.
86
90 --allow_verification_with_non_compliant_keys=false
91 Allow a SignatureVerifier to use keys which are technically
92 non-compliant with RFC6962.
93 --alsologtostderr=false
96 log to standard error as well as files
97 --application_metrics_count_limit=100
100 Max number of application metrics to store (per container)
101 --as=""
104 Username to impersonate for the operation
105 --as-group=[]
108 Group to impersonate for the operation, this flag can be repeated
109 to specify multiple groups.
110 --azure-container-registry-config=""
113 Path to the file containing Azure container registry configuration
114 information.
115 --boot_id_file="/proc/sys/kernel/random/boot_id"
118 Comma-separated list of files to check for boot-id. Use the first
119 one that exists.
120 --cache-dir="/builddir/.kube/http-cache"
123 Default HTTP cache directory
124 --certificate-authority=""
127 Path to a cert file for the certificate authority
128 --client-certificate=""
131 Path to a client certificate file for TLS
132 --client-key=""
135 Path to a client key file for TLS
136 --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
139 CIDRs opened in GCE firewall for LB traffic proxy health checks
140 --cluster=""
143 The name of the kubeconfig cluster to use
144 --container_hints="/etc/cadvisor/container_hints.json"
147 location of the container hints file
148 --containerd="unix:///var/run/containerd.sock"
151 containerd endpoint
152 --context=""
155 The name of the kubeconfig context to use
156 --default-not-ready-toleration-seconds=300
159 Indicates the tolerationSeconds of the toleration for
160 notReady:NoExecute that is added by default to every pod that does not
161 already have such a toleration.
162 --default-unreachable-toleration-seconds=300
165 Indicates the tolerationSeconds of the toleration for unreach‐
166 able:NoExecute that is added by default to every pod that does not
167 already have such a toleration.
168 --docker="unix:///var/run/docker.sock"
171 docker endpoint
172 --docker-tls=false
175 use TLS to connect to docker
176 --docker-tls-ca="ca.pem"
179 path to trusted CA
180 --docker-tls-cert="cert.pem"
183 path to client certificate
184 --docker-tls-key="key.pem"
187 path to private key
188 --docker_env_metadata_whitelist=""
191 a comma-separated list of environment variable keys that needs to
192 be collected for docker containers
193 --docker_only=false
196 Only report docker containers in addition to root stats
197 --docker_root="/var/lib/docker"
200 DEPRECATED: docker root is read from docker info (this is a fall‐
201 back, default: /var/lib/docker)
202 --enable_load_reader=false
205 Whether to enable cpu load reader
206 --event_storage_age_limit="default=24h"
209 Max length of time for which to store events (per type). Value is a
210 comma separated list of key values, where the keys are event types
211 (e.g.: creation, oom) or "default" and the value is a duration. Default
212 is applied to all non-specified event types
213 --event_storage_event_limit="default=100000"
216 Max number of events to store (per type). Value is a comma sepa‐
217 rated list of key values, where the keys are event types (e.g.: cre‐
218 ation, oom) or "default" and the value is an integer. Default is
219 applied to all non-specified event types
220 --global_housekeeping_interval=0
223 Interval between global housekeepings
224 --housekeeping_interval=0
227 Interval between container housekeepings
228 --insecure-skip-tls-verify=false
231 If true, the server's certificate will not be checked for validity.
232 This will make your HTTPS connections insecure
233 --kubeconfig=""
236 Path to the kubeconfig file to use for CLI requests.
237 --log-flush-frequency=0
240 Maximum number of seconds between log flushes
241 --log_backtrace_at=:0
244 when logging hits line file:N, emit a stack trace
245 --log_cadvisor_usage=false
248 Whether to log the usage of the cAdvisor container
249 --log_dir=""
252 If non-empty, write log files in this directory
253 --logtostderr=true
256 log to standard error instead of files
257 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
260 Comma-separated list of files to check for machine-id. Use the
261 first one that exists.
262 --match-server-version=false
265 Require server version to match client version
266 -n, --namespace=""
269 If present, the namespace scope for this CLI request
270 --request-timeout="0"
273 The length of time to wait before giving up on a single server
274 request. Non-zero values should contain a corresponding time unit (e.g.
275 1s, 2m, 3h). A value of zero means don't timeout requests.
276 -s, --server=""
279 The address and port of the Kubernetes API server
280 --stderrthreshold=2
283 logs at or above this threshold go to stderr
284 --storage_driver_buffer_duration=0
287 Writes in the storage driver will be buffered for this duration,
288 and committed to the non memory backends as a single transaction
289 --storage_driver_db="cadvisor"
292 database name
293 --storage_driver_host="localhost:8086"
296 database host:port
297 --storage_driver_password="root"
300 database password
301 --storage_driver_secure=false
304 use secure connection with database
305 --storage_driver_table="stats"
308 table name
309 --storage_driver_user="root"
312 database username
313 --token=""
316 Bearer token for authentication to the API server
317 --user=""
320 The name of the kubeconfig user to use
321 -v, --v=0
324 log level for V logs
325 --version=false
328 Print version information and quit
329 --vmodule=
332 comma-separated list of pattern=N settings for file-filtered log‐
333 ging
334
338 # Create a release from the latest origin images and push to a DockerHub repo
339 %[1] new --from-image-stream=origin-v3.11 -n openshift --to-image docker.io/mycompany/myrepo:latest
340
345 oc-adm-release(1),
346
350 June 2016, Ported from the Kubernetes man-doc generator
351Openshift Openshift CLI User Manuals OC ADM RELEASE(1)