image image image image image

On This Page

docker


docker
no docker

Enables dockers then enters docker configuration context.
The no form of the command disables dockers, removes configuration, and deletes all containers and docker images.

Syntax DescriptionN/A
DefaultN/A
Configuration Modeconfig
History4.3.0
Example
ufm [ mgmt-sa ] (config) # docker
ufm [ mgmt-sa ] (config docker) #
Related Commands


Notes

commit


commit <container-name> <image-name> <image-version>

Creates a new image from a running container.

Syntax Descriptioncontainer-nameName of the running container to commit (limited to 180 characters)
image-nameName of the new image to be created
image-versionVersion of the new image to be created
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # commit mycontainer test latest
Related Commands

docker

Notes

remove image


remove image <image-name> <image-version>

Removes an image from the Linux docker service.

Syntax Descriptionimage-nameName of the new image to be deleted
image-versionVersion of the new image to be deleted
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # remove image test latest
Related Commands

docker

Notes

exec


exec <container-name> <program-executable>

Executes a program within a running container.

Syntax Descriptioncontainer-nameName of the running container to commit (limited to 180 characters)
program-executableLinux command
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # exec mycontainer "ls -la"
Related Commands

docker

Notes

file fetch


file fetch <url>

Download a docker file from a remote host or a USB device.

Syntax DescriptionurlFTP, TFTP, SCP and SFTP are supported (e.g. scp://username[:password]@hostname-or-ip/path/filename)
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # file fetch scp://root:*******@ufm/tmp/test.txt telemetry.1.config
Related Commands

docker

Notes

image upload


image upload <filename> <upload_url>

Uploads an image file to a remote host.

Syntax DescriptionfilenameName of file
upload_urlFTP, TFTP, SCP and SFTP are supported (e.g. scp://username[:password]@hostname-or-ip/path/filename)
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # image upload centos.img.gz scp://username:password@10.10.10.10/var/www/html/<image_name>
Related Commands

docker

Notes

file image upload


file image upload <filename> <upload_url>

Uploads a file to a remote host.

Syntax DescriptionfilenameName of file
upload_urlFTP, TFTP, SCP and SFTP are supported (e.g. scp://username[:password]@hostname-or-ip/path/filename)
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # file image upload centos.img.gz scp://username:password@10.10.10.10/var/www/html/<image_name>
Related Commands

docker

Notes

label


label <label-name>
no label <label-name>

Creates a label which can be used as a shared storage between containers.
The no form of the command removes the label.

Syntax Descriptionlabel-nameName of label
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # label new_label
Related Commands

docker

Notes

label-fetch


label-fetch <url>

Downloads label output files from a remote host or USB device.

Syntax DescriptionurlFTP, TFTP, SCP and SFTP are supported (e.g. scp://username[:password]@hostname-or-ip/path/filename)
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # label-fetch scp://root:******@r-ufm208/tmp/telemetry.1.config.zip telemetry.1.config
100.0%  [#############################################################]
Related Commands

docker

Notes

label-upload


label-upload <url>

Uploads label output files to a remote host or USB device.

Syntax DescriptionurlFTP, TFTP, SCP and SFTP are supported (e.g. scp://username[:password]@hostname-or-ip/path/filename)
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # label-upload telemetry.1.config scp://root:********@r-ufm208/tmp
Related Commands

docker

Notes

pull


pull <image-name>[:<version>]

Pulls a docker image from a docker repository.

Syntax Descriptionimage-nameImage name
Format: Name:Version
If only “Name” is provided, “version” defaults to latest
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # pull test
Using default tag: latest
latest: Pulling from library/test
45a2e645736c: Pull complete
Digest: sha256:c577af3197aacedf79c5a204cd7f493c8e07ffbce7f88f7600bf19c688c38799
Status: Downloaded newer image for test:latest
Related Commands

docker

Notes

save


save <image-name> <image-version> <filename>

Saves an image to a TAR archive.

Syntax Descriptionimage-nameName of image
image-versionVersion of image
filenameName of file in which to save image
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # save busybox latest my_image
Saving and compressing image: busybox version: latest
this could take a while...
Related Commands

docker
docker load

NotesAfter the file is created, the filename gets appended a *.gz suffix.

shutdown


shutdown
no shutdown

Stops all docker containers, and deletes all non-auto containers.
The no form of the command enables the docker Linux service and runs all configured auto-start containers.

Syntax DescriptionN/A
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # no shutdown
Related Commands

docker

NotesAfter the file is created, the filename gets appended a *.gz suffix.

start


start <image-name> <image-version> <container-name> <starting-point> [privileged {network | events-forwarder | ufm-licenses}] [cpus <max-cpu-resources>] [memory <max-memory>] [usb-mount] [label <label-name>] [cmd <command>]
no start <container-name>

Starts a new container from an image.
The no form of the command stops a running docker container (and removes the container if it is not persistent).

Syntax Descriptionimage-nameName of the new image to start
image-versionVersion of the image to start
container-nameName of the running container to commit (limited to 180 characters)
starting-point
  • init – persistent, start the container after boot, when system initialization is done
  • now – start the container now, this is not persistent
  • now-and-init – starts the container now and after boot, when system configuration is done
privileged
  • network – adds network privileges to the container (--privilege flag)
  • events-forwarder – adds required mounts to use events forwarder
  • ufm-licenses – adds required mounts to use license file
cpusSets how much of the available CPU resources a container can use (e.g. "cpus 1.5" guarantees at most one and a half of the available CPUs for the container)
memorySets the maximum amount of memory the container can use in MB. The minimum amount of memory to configure is 4MB.
usb-mountEnables USB mount to the docker container
labelCreates one or two labels to use as a shared storage between containers
cmdExecutes specified command inside the docker
DefaultN/A
Configuration Modeconfig docker
History4.3.0
Example
ufm [ mgmt-sa ] (config docker) # start centos latest test now
Starting docker container. Please wait (this can take a minute)...
switch (config) # docker start imagename latestver containername init cpus 0.2 memory 25
Related Commands

docker

NotesOnly one of the privileged options (i.e. events-forwarder, ufm-licenses) can be used

show docker containers


show docker containers <container-name>

Displays set parameters on containers already running, and containers planned to run in the future.

Syntax DescriptionN/A
DefaultN/A
Configuration ModeAny configuration mode
History4.3.0
Example
ufm [ mgmt-sa ] (config) # show docker containers

cont_example:
  image       : busybox
  version     : latest
  status      : running
  start point : data-path-ready
  cpu limit   : 0.2
  memory limit: 10m
  labels      : -
  privileges  : network, sdk
  usb mount   : enabled
another_container:
  image       : busybox
  version     : latest
  status      : -
  start point : init
  cpu limit   : 0.2
  memory limit: 10m
  labels      : my_label
  privileges  : network, sdk
  usb mount   : disabled

ufm [ mgmt-sa ] (config) # show docker containers cont_example

cont_example:
  image       : busybox
  version     : latest
  status      : running
  start point : data-path-ready
  cpu limit   : 0.2
  memory limit: 10m
  labels      : -
  privileges  : network, sdk
  usb mount   : enabled
Related Commands


Notes
  • If a container is already started, the status field displays its current status
  • If a container is configured to run on the next boot, the start point field displays when it will start
  • If there is a mismatch between the configuration of a running container and its next-boot configuration, two entries for the container are shown with both of the configurations

show docker images


show docker images

Display docker images.

Syntax DescriptionN/A
DefaultN/A
Configuration ModeAny configuration mode
History4.3.0
Example
ufm [ mgmt-sa ] (config) # show docker images
-------------------------------------------------------------
Image              Version      Created            Size
-------------------------------------------------------------
ubuntu             latest       Less than a secon  117MB
                                d ago
ubuntu-sdk         v1           41 seconds ago     215MB
Related Commands


Notes

show docker labels


show docker labels

Displays docker labels.

Syntax DescriptionN/A
DefaultN/A
Configuration ModeAny configuration mode
History4.3.0
Example
ufm [ mgmt-sa ] (config) # show docker labels 
Storage label : label_name1
    configured containers list : cont_name2
    active containers list : cont_name1

Storage label : label_name2
Related Commands


Notes

show docker ps


show docker ps

Display docker containers.

Syntax DescriptionN/A
DefaultN/A
Configuration ModeAny configuration mode
History4.3.0
Example
ufm [ mgmt-sa ] (config) # show docker ps
---------------------------------------------------------------------------------
Container           Image:Version           Created                Status
---------------------------------------------------------------------------------
my_ubuntu_app       ubuntu:latest           56 seconds ago         Up 50 seconds 
Related Commands


Notes