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