.TH "OPENSHIFT CLI" "1" " Openshift CLI User Manuals" "Openshift" "June 2016" "" .SH NAME .PP openshift cli tag \- Tag existing images into image streams .SH SYNOPSIS .PP \fBopenshift cli tag\fP [OPTIONS] .SH DESCRIPTION .PP Tag existing images into image streams .PP The tag command allows you to take an existing tag or image from an image stream, or a Docker image pull spec, and set it as the most recent image for a tag in 1 or more other image streams. It is similar to the 'docker tag' command, but it operates on image streams instead. .PP Pass the \-\-insecure flag if your external registry does not have a valid HTTPS certificate, or is only served over HTTP. Pass \-\-scheduled to have the server regularly check the tag for updates and import the latest version (which can then trigger builds and deployments). Note that \-\-scheduled is only allowed for Docker images. .SH OPTIONS .PP \fB\-\-alias\fP=false Should the destination tag be updated whenever the source tag changes. Defaults to false. .PP \fB\-d\fP, \fB\-\-delete\fP=false Delete the provided spec tags .PP \fB\-\-insecure\fP=false Set to true if importing the specified Docker image requires HTTP or has a self\-signed certificate. Defaults to false. .PP \fB\-\-reference\fP=false Should the destination tag continue to pull from the source namespace. Defaults to false. .PP \fB\-\-scheduled\fP=false Set a Docker image to be periodically imported from a remote repository. Defaults to false. .PP \fB\-\-source\fP="" Optional hint for the source type; valid values are 'imagestreamtag', 'istag', 'imagestreamimage', 'isimage', and 'docker' .SH OPTIONS INHERITED FROM PARENT COMMANDS .PP \fB\-\-api\-version\fP="" DEPRECATED: The API version to use when talking to the server .PP \fB\-\-as\fP="" Username to impersonate for the operation .PP \fB\-\-certificate\-authority\fP="" Path to a cert. file for the certificate authority .PP \fB\-\-client\-certificate\fP="" Path to a client certificate file for TLS .PP \fB\-\-client\-key\fP="" Path to a client key file for TLS .PP \fB\-\-cluster\fP="" The name of the kubeconfig cluster to use .PP \fB\-\-config\fP="" Path to the config file to use for CLI requests. .PP \fB\-\-context\fP="" The name of the kubeconfig context to use .PP \fB\-\-google\-json\-key\fP="" The Google Cloud Platform Service Account JSON Key to use for authentication. .PP \fB\-\-insecure\-skip\-tls\-verify\fP=false If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure .PP \fB\-\-log\-flush\-frequency\fP=0 Maximum number of seconds between log flushes .PP \fB\-\-match\-server\-version\fP=false Require server version to match client version .PP \fB\-n\fP, \fB\-\-namespace\fP="" If present, the namespace scope for this CLI request .PP \fB\-\-request\-timeout\fP="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. .PP \fB\-\-server\fP="" The address and port of the Kubernetes API server .PP \fB\-\-token\fP="" Bearer token for authentication to the API server .PP \fB\-\-user\fP="" The name of the kubeconfig user to use .SH EXAMPLE .PP .RS .nf # Tag the current image for the image stream 'openshift/ruby' and tag '2.0' into the image stream 'yourproject/ruby with tag 'tip'. openshift cli tag openshift/ruby:2.0 yourproject/ruby:tip # Tag a specific image. openshift cli tag openshift/ruby@sha256:6b646fa6bf5e5e4c7fa41056c27910e679c03ebe7f93e361e6515a9da7e258cc yourproject/ruby:tip # Tag an external Docker image. openshift cli tag \-\-source=docker openshift/origin:latest yourproject/ruby:tip # Remove the specified spec tag from an image stream. openshift cli tag openshift/origin:latest \-d .fi .RE .SH SEE ALSO .PP \fBopenshift\-cli(1)\fP, .SH HISTORY .PP June 2016, Ported from the Kubernetes man\-doc generator