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
- SelectConfigurein the top menu and selectContainers and Container Stacks.
- On theContainers and Container Stacksscreen, click on theContainer Stackstab.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 buttonAdd Container Stack.
Step 2: Create a Container Stack
- On theContainer Stackstab, click onAdd Container Stack.
- Name the container stack. Don't use spaces or special characters. In the screen below, it is named:Hello_World_StackYou 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.
- 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
- Click onDeploy 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
- On theContainer Stackstab, click on the container stack you created in the previous step.In theContainer Stack Servicesscreen, you will see the list of services in the stack, as well as information about their images, configurations and date of last update.
- Click onEdit Container Stack.In theEdit Container Stackscreen, all fields can be modified.
- In the Web Editor, change the number of replicas in line 8:replicas: 2
- Click onUpdate 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