Documentation

  • 4.0
  • 09/27/2021
  • Public Content

Create and Manage Container Stacks

A Container Stack (or Docker* Stack) is a group of services that make up a complete distributed application. Using a Container Stack, you are able to define and manage multiple services with a single configuration file.
Intel® Edge Software Configurator
provides a graphic interface that enables the creation and management of Container Stacks. Follow the instructions below to create and manage your first Container Stack.

Step 1: Go to Configure > Containers and Container Stacks

  1. Select
    Configure
    in the top menu and select
    Containers and Container Stacks
    .
  2. On the
    Containers and Container Stacks
    screen, click on the
    Container Stacks
    tab.
    If there are container stacks in the host machine, they will be listed in this tab. If there are no container stacks available, you will only see the button
    Add Container Stack
    .

Step 2: Create a Container Stack

  1. On the
    Container Stacks
    tab, click on
    Add Container Stack
    .
  2. Name the container stack. Don't use spaces or special characters. In the screen below, it is named:
    Hello_World_Stack
    You can use the Web Editor to type in or paste commands of the Docker* Compose file for the stack. The Docker* Compose versions supported are 3.0 and 3.7.
  3. Copy the example commands below and paste in the Web Editor.
    version: '3' services: roach1: image: cockroachdb/cockroach:latest command: "start --insecure" deploy: replicas: 1 ports: - 8080 roachN: image: cockroachdb/cockroach:latest command: "start --insecure --join=roach1,roachN" deploy: mode: global
  4. Click on
    Deploy Container Stack
    .
    You will see the stack deployment in progress notification.
Once the container stack is deployed, you will see a success notification, and the new stack will be displayed in the
Container Stacks
tab.

Step 3: Manage Container Stacks

  1. On the
    Container Stacks
    tab, click on the container stack you created in the previous step.
    In the
    Container Stack Services
    screen, you will see the list of services in the stack, as well as information about their images, configurations and date of last update.
  2. Click on
    Edit Container Stack
    .
    In the
    Edit Container Stack
    screen, all fields can be modified.
  3. In the Web Editor, change the number of replicas in line 8:
    replicas: 2
  4. Click on
    Update Container Stack
    .
    You will see the stack update in progress notification.
    Once the update is complete, you will see a notification.
    You can update and delete individual services in the stack as well.

Troubleshooting

The Edge Software Configurator package was previously named
edge_software_manager
. Some screenshots, commands, and file paths in this guide still use
esm
or
edge_software_manager
at this time.
No Container Stacks displayed.
If the list of Container Stacks is not displayed, check the logs for
esm_portainer_edge_agent
Docker service for more information using the following command in a terminal:
docker service logs esm_portainer_edge_agent

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.