Your progress

Overview

Since you have built your own container image in the previous lesson, now it is time to deploy and run it on the computer on module.

In this section, you will:

• Pull the generated image from Docker Hub.
• Run the image on the device.

$ Command in your PC

$$ Command inside a container in your PC

# Command in the target board, e.g. Colibri iMX6

## Command inside a container in Torizon

> Command in the Bootloader

$ Command waiting for output
Output

Prerequisites

For this Quickstart Guide:

• Development computer with Windows 10 version 2004 (a.k.a. May 2020 update) or higher.
• Successfully completed the previous lesson from this guide.

Note: Carefully read this module's cover page clicking on "Module 3: Creating my Own Container" on the left menu bar before starting this lesson.

Step 1

On the board, make sure there are no running containers:

# docker stop $(docker ps -a -q)

Step 2

Pull the image you just pushed to Docker Hub (See the previous lesson if you didn't) :

# docker pull <username>/gs-torizon

You can use the same command above to pull new container image versions every time a new one is pushed to Docker Hub.

Step 3

The following command starts a new container based on the Docker image and open the new container's terminal:

# docker run --rm -it -v /var/run/dbus:/var/run/dbus -v /dev:/dev <username>/gs-torizon

Step 4

Check that the package you've installed in the Dockerfile is available in this new container:

## nano

You are now inside the nano text editor. Press Ctrl + x to exit it.

Note: Please, note that all the changes made in a container after its creation will be lost when the container exits. To keep data, one needs to use methods to store data outside the container, for example, by using bind mounting.

Step 6

You can exit the container by either typing exit on the command-line or by pressing Ctrl + d:

## exit

FAQ

$ docker ps --help

Usage:  docker ps [OPTIONS]

List containers

Options:
  -a, --all             Show all containers (default shows just running)
  -f, --filter filter   Filter output based on conditions provided
      --format string   Pretty-print containers using a Go template
  -n, --last int        Show n last created containers (includes all states) (default -1)
  -l, --latest          Show the latest created container (includes all states)
      --no-trunc        Don't truncate output
  -q, --quiet           Only display numeric IDs
  -s, --size            Display total file sizes