.nh
.TH umoci-tag(1) # umoci tag - Create tags in OCI images
Aleksa Sarai
DECEMBER 2016

.SH NAME
.PP
umoci tag - Create tags in OCI images


.SH SYNOPSIS
.PP
\fBumoci tag\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
\fInew-tag\fP


.SH DESCRIPTION
.PP
Creates a new tag that is a copy of \fItag\fP with the name \fInew-tag\fP\&. If \fInew-tag\fP
already exists, it will be replaced. The original \fItag\fP will be unchanged.


.SH OPTIONS
.PP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
  The source OCI image tag to create a copy of. \fIimage\fP must be a path to a
  valid OCI image and \fItag\fP must be a valid tag in the image. If \fItag\fP is not
  provided it defaults to "latest".


.SH EXAMPLE
.PP
The following swaps two image tags in an OCI image.

.PP
.RS

.nf
% umoci tag --image image:to-change new
% umoci tag --image image:latest to-change
% umoci tag --image image:new latest
% umoci rm --image image:new

.fi
.RE


.SH SEE ALSO
.PP
\fBumoci\fP(1), \fBumoci-remove\fP(1)