OC IMAGE - Online Linux Manual Page

Section : 1
Updated : Openshift CLI User Manuals
Source : Openshift
Note : June 2016

NAME

oc image mirror − Mirror images from one repository to another

SYNOPSIS

oc image mirror

[OPTIONS]

DESCRIPTION

Mirror images from one image repository to another.

Accepts a list of arguments defining source images that should be pushed to the provided destination image tag. The images are streamed from registry to registry without being stored locally. The default docker credentials are used for authenticating to the registries.

When using S3 mirroring the region and bucket must be the first two segments after the host. Mirroring will create the necessary metadata so that images can be pulled via tag or digest, but listing manifests and tags will not be possible. You may also specify one or more −−s3−source−bucket parameters (as <bucket>/ <path>) to designate buckets to look in to find blobs (instead of uploading). The source bucket also supports the suffix "/ [store]", which will transform blob identifiers into the form the Docker registry uses on disk, allowing you to mirror directly from an existing S3−backed Docker registry. Credentials for S3 may be stored in your docker credential file and looked up by host.

Images in manifest list format will be copied as−is unless you use −−filter−by−os to restrict the allowed images to copy in a manifest list. This flag has no effect on regular images.

OPTIONS

−−dry−run

=false
Print the actions that would be taken and exit without writing to the destinations.

−f

−−filename

]

One or more files to read SRC=DST or SRC DST [DST ...] mappings from.

−−filter−by−os

A regular expression to control which images are mirrored. Images will be passed as '<platform>/<architecture>[/<variant>

]

−−force

=false
Attempt to write all layers and manifests even if they exist in the remote repository.

−−insecure

=false
Allow push and pull operations to registries to be made over HTTP

−−max−per−registry

=6
Number of concurrent requests allowed per registry.

−−max−registry

=4
Number of concurrent registries to connect to at any one time.

−−s3−source−bucket

]

A list of bucket/path locations on S3 that may contain already uploaded blobs. Add [store] to the end to use the Docker registry path convention.

−−skip−mount

=false
Always push layers instead of cross−mounting them

−−skip−multiple−scopes

=false
Some registries do not support multiple scopes passed to the registry login.

OPTIONS INHERITED FROM PARENT COMMANDS

−−allow_verification_with_non_compliant_keys

=false
Allow a SignatureVerifier to use keys which are technically non−compliant with RFC6962.

−−alsologtostderr

=false
log to standard error as well as files

−−application_metrics_count_limit

=100
Max number of application metrics to store (per container)

−−as

Username to impersonate for the operation

−−as−group

]

Group to impersonate for the operation, this flag can be repeated to specify multiple groups.

−−azure−container−registry−config

Path to the file containing Azure container registry configuration information.

−−boot_id_file

="/proc/sys/kernel/random/boot_id"
Comma−separated list of files to check for boot−id. Use the first one that exists.

−−cache−dir

="/builddir/.kube/http−cache"
Default HTTP cache directory

−−certificate−authority

Path to a cert file for the certificate authority

−−client−certificate

Path to a client certificate file for TLS

−−client−key

Path to a client key file for TLS

−−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
CIDRs opened in GCE firewall for LB traffic proxy health checks

−−cluster

The name of the kubeconfig cluster to use

−−container_hints

="/etc/cadvisor/container_hints.json"
location of the container hints file

−−containerd

="unix:///var/run/containerd.sock"
containerd endpoint

−−context

The name of the kubeconfig context to use

−−default−not−ready−toleration−seconds

=300
Indicates the tolerationSeconds of the toleration for notReady:NoExecute that is added by default to every pod that does not already have such a toleration.

−−default−unreachable−toleration−seconds

=300
Indicates the tolerationSeconds of the toleration for unreachable:NoExecute that is added by default to every pod that does not already have such a toleration.

−−docker

="unix:///var/run/docker.sock"
docker endpoint

−−docker−tls

=false
use TLS to connect to docker

−−docker−tls−ca

="ca.pem"
path to trusted CA

−−docker−tls−cert

="cert.pem"
path to client certificate

−−docker−tls−key

="key.pem"
path to private key

−−docker_env_metadata_whitelist

a comma−separated list of environment variable keys that needs to be collected for docker containers

−−docker_only

=false
Only report docker containers in addition to root stats

−−docker_root

="/var/lib/docker"
DEPRECATED: docker root is read from docker info (this is a fallback, default: /var/lib/docker)

−−enable_load_reader

=false
Whether to enable cpu load reader

−−event_storage_age_limit

="default=24h"
Max length of time for which to store events (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is a duration. Default is applied to all non−specified event types

−−event_storage_event_limit

="default=100000"
Max number of events to store (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is an integer. Default is applied to all non−specified event types

−−global_housekeeping_interval

=0
Interval between global housekeepings

−−housekeeping_interval

=0
Interval between container housekeepings

−−insecure−skip−tls−verify

=false
If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure

−−kubeconfig

Path to the kubeconfig file to use for CLI requests.

−−log−flush−frequency

=0
Maximum number of seconds between log flushes

−−log_backtrace_at

=:0
when logging hits line file:N, emit a stack trace

−−log_cadvisor_usage

=false
Whether to log the usage of the cAdvisor container

−−log_dir

If non−empty, write log files in this directory

−−logtostderr

=true
log to standard error instead of files

−−machine_id_file

="/etc/machine−id,/var/lib/dbus/machine−id"
Comma−separated list of files to check for machine−id. Use the first one that exists.

−−match−server−version

=false
Require server version to match client version

−n

−−namespace

If present, the namespace scope for this CLI request

−−request−timeout

="0"
The length of time to wait before giving up on a single server request. Non−zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests.

−s

−−server

The address and port of the Kubernetes API server

−−stderrthreshold

=2
logs at or above this threshold go to stderr

−−storage_driver_buffer_duration

=0
Writes in the storage driver will be buffered for this duration, and committed to the non memory backends as a single transaction

−−storage_driver_db

="cadvisor"
database name

−−storage_driver_host

="localhost:8086"
database host:port

−−storage_driver_password

="root"
database password

−−storage_driver_secure

=false
use secure connection with database

−−storage_driver_table

="stats"
table name

−−storage_driver_user

="root"
database username

−−token

Bearer token for authentication to the API server

−−user

The name of the kubeconfig user to use

−v

−−v

=0
log level for V logs

−−version

=false
Print version information and quit

−−vmodule

=
comma−separated list of pattern=N settings for file−filtered logging

EXAMPLE

# Copy image to another tag oc image mirror myregistry.com/myimage:latest myregistry.com/myimage:stable # Copy image to another registry oc image mirror myregistry.com/myimage:latest docker.io/myrepository/myimage:stable # Copy image to S3 (pull from <bucket>.s3.amazonaws.com/image:latest) oc image mirror myregistry.com/myimage:latest s3://s3.amazonaws.com/<region>/<bucket>/image:latest # Copy image to S3 without setting a tag (pull via @<digest>) oc image mirror myregistry.com/myimage:latest s3://s3.amazonaws.com/<region>/<bucket>/image # Copy image to multiple locations oc image mirror myregistry.com/myimage:latest docker.io/myrepository/myimage:stable docker.io/myrepository/myimage:dev # Copy multiple images oc image mirror myregistry.com/myimage:latest=myregistry.com/other:test myregistry.com/myimage:new=myregistry.com/other:target