Edge Stacks is a feature that lets you deploy multiple applications to multiple environments from a single page and multiple sources, regardless of their current state.
The Edge Stacks page displays a list of Edge Stacks deployed across your environments and devices and includes their name, the status of the deployment across the relevant environments (acknowledged, images pre-pulled, deployed and failed), the total deployment count, and the creation date.
You can click on an individual stack's name to edit the stack:
You can also view details about the stack's deployment across environments on the Environments tab, as well as retrieve, download, and clear retrieved log files from the respective environments.
From the menu select Edge Stacks then click Add stack.
In Deployment type, select the type of deployment you are performing.
In the Build Method, define how to deploy your app from one of the following options:
Use the Portainer web editor to write or paste in your build file.
Upload a build file from your computer.
Use a GitHub repo where the build file is stored.
Use an Edge stack template. Only available for the Compose deployment type.
You can search within the web editor at any time by pressing
If your stack requires access to images in private registries, you can specify which registry to use as part of the deployment.
By default, Docker will start containers within the stack that it already has images for, while at the same time pulling any other images it needs from the upstream registries. In some cases you may want to wait until all of the needed images are pulled to the device before starting the stack. To do this, enable the Pre-pull images toggle. This can also help to avoid issues when some images in a stack are unable to be pulled, leading to an incomplete or partial deployment.
If a deployment of an Edge Stack fails (for example if the remote Edge environment is unavailable), by default Portainer will not try and redeploy the stack. If you wish to enable retrying of failed deployments, you can toggle Retry deployment to on.
When Retry deployment is enabled for an Edge Stack and the deployment of the Edge Stack fails, Portainer will:
- 1.Retry the deployment every 10 seconds for the first hour.
- 2.After the first hour, retry once an hour for 7 days.
- 3.After 7 days, Portainer will stop retrying and the Edge Stack will be given a "failed" status.
Once the configuration is completed, click Deploy stack.