salt.modules.smartos_imgadm#

Module for running imgadm command on SmartOS

salt.modules.smartos_imgadm.avail(search=None, verbose=False)#

Return a list of available images

searchstring: search keyword
verboseboolean (False): toggle verbose output

CLI Example:

salt '*' imgadm.avail [percona]
salt '*' imgadm.avail verbose=True

salt.modules.smartos_imgadm.delete(uuid)#

Remove an installed image

uuidstring: Specifies uuid to import

CLI Example:

salt '*' imgadm.delete e42f8c84-bbea-11e2-b920-078fab2aab1f

salt.modules.smartos_imgadm.docker_to_uuid(uuid)#: Get the image uuid from an imported docker image

New in version 2019.2.0.

salt.modules.smartos_imgadm.get(uuid)#

Return info on an installed image

uuidstring: uuid of image

CLI Example:

salt '*' imgadm.get e42f8c84-bbea-11e2-b920-078fab2aab1f
salt '*' imgadm.get plexinc/pms-docker:plexpass

salt.modules.smartos_imgadm.import_image(uuid, verbose=False)#

Import an image from the repository

uuidstring: uuid to import
verboseboolean (False): toggle verbose output

CLI Example:

salt '*' imgadm.import e42f8c84-bbea-11e2-b920-078fab2aab1f [verbose=True]

salt.modules.smartos_imgadm.list_installed(verbose=False)#

Return a list of installed images

verboseboolean (False): toggle verbose output

Changed in version 2019.2.0: Docker images are now also listed

CLI Example:

salt '*' imgadm.list
salt '*' imgadm.list docker=True
salt '*' imgadm.list verbose=True

salt.modules.smartos_imgadm.show(uuid)#

Show manifest of a given image

uuidstring: uuid of image

CLI Example:

salt '*' imgadm.show e42f8c84-bbea-11e2-b920-078fab2aab1f
salt '*' imgadm.show plexinc/pms-docker:plexpass

salt.modules.smartos_imgadm.source_add(source, source_type='imgapi')#

Add a new source

sourcestring: source url to add
source_trypestring (imgapi): source type, either imgapi or docker

New in version 2019.2.0.

CLI Example:

salt '*' imgadm.source_add https://updates.joyent.com
salt '*' imgadm.source_add https://docker.io docker

salt.modules.smartos_imgadm.source_delete(source)#

Delete a source

sourcestring: source url to delete

New in version 2019.2.0.

CLI Example:

salt '*' imgadm.source_delete https://updates.joyent.com

salt.modules.smartos_imgadm.sources(verbose=False)#

Return a list of available sources

verboseboolean (False): toggle verbose output

New in version 2019.2.0.

CLI Example:

salt '*' imgadm.sources

salt.modules.smartos_imgadm.update_installed(uuid='')#

Gather info on unknown image(s) (locally installed)

uuidstring: optional uuid of image

CLI Example:

salt '*' imgadm.update [uuid]

salt.modules.smartos_imgadm.vacuum(verbose=False)#

Remove unused images

verboseboolean (False): toggle verbose output

CLI Example:

salt '*' imgadm.vacuum [verbose=True]

salt.modules.smartos_imgadm.version()#

Return imgadm version

CLI Example:

salt '*' imgadm.version

Table of Contents

salt.modules.smartos_imgadm#