mirror of https://github.com/projectatomic/atomic.git synced 2026-02-05 18:45:01 +01:00

Files

Giuseppe Scrivano f3c6b8bb74 uninstall: inhibit UNINSTALL if there are running containers

Closes: https://bugzilla.redhat.com/show_bug.cgi?id=1456451

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>

Closes: #1050
Approved by: rhatdan

2017-07-18 21:48:46 +00:00

2.6 KiB

Raw Permalink Blame History

% ATOMIC(1) Atomic Man Pages % Dan Walsh % January 2015

NAME

atomic-uninstall - Remove/Uninstall container/container image from system

SYNOPSIS

atomic uninstall [--display] [-f][--force] [-h|--help] [-n][--name[=NAME]] [--storage] IMAGE [ARG...]

DESCRIPTION

atomic uninstall attempts to read the LABEL UNINSTALL field in the container IMAGE, if this field does not exist atomic uninstall will just uninstall the image.

The image won't be removed if there are containers using it and --force is not used.

If the container image has a LABEL UNINSTALL instruction like the following:

LABEL UNINSTALL /usr/bin/docker run -t -i --rm \${OPT1} --privileged -v /:/host --net=host --ipc=host --pid=host -e HOST=/host -e NAME=${NAME} -e IMAGE=${IMAGE} -e CONFDIR=\/etc/${NAME} -e LOGDIR=/var/log/\${NAME} -e DATADIR=/var/lib/\${NAME} ${IMAGE} \${OPT2} /bin/uninstall.sh \${OPT3}

atomic uninstall will set the following environment variables for use in the command:

NAME The name specified via the command. NAME will be replaced with IMAGE if it is not specified.

IMAGE The name and image specified via the command.

OPT1, OPT2, OPT3 Additional options which can be specified via the command.

SUDO_UID The SUDO_UID environment variable. This is useful with the docker -u option for user space tools. If the environment variable is not available, the value of /proc/self/loginuid is used.

SUDO_GID The SUDO_GID environment variable. This is useful with the docker -u option for user space tools. If the environment variable is not available, the default GID of the value for SUDO_UID is used. If this value is not available, the value of /proc/self/loginuid is used.

Any additional arguments will be appended to the command.

OPTIONS:

--display Display the image's uninstall options and environment variables populated into the uninstall command. The uninstall command will not execute if --display is specified. If --display is not specified the uninstall command will execute.

-f --force Remove all containers based on this image before removing the image.

-h --help Print usage statement

-n --name="" If name is specified atomic uninstall will uninstall the named container from the system, otherwise it will uninstall the container images.

--storage The --storage option will direct atomic where it should look for the image prior to uninstalling. Valid options are docker and ostree.

HISTORY

January 2015, Originally compiled by Daniel Walsh (dwalsh at redhat dot com)

2.6 KiB Raw Permalink Blame History