Managing A Container
Managing containers in the portal is done through the containers modal.
To get there:
- Environments from the main, left-hand navigation.
- Select the environment the container is in from the first column.
- Use the Containers tab to view existing containers.
- Select the desired container from the list, opening the modal at the container dashboard.
The container modal has several sub categories that can be used for management and administration:
Around the border of the container modal are additional butttons that can change the state of the container and its instances.
Container Start
The first button which looks like a "play" button will send a start job to the container.
Container Restart
The second button which looks like a circle made of two arrows will send a restart job to the container.
Container Stop
The third button which looks like a square will send a stop job to the container.
Container Delete
The final button which looks like a trash can will navigate you to the container settings page where the container can be deleted.
Restarting the Container
Container restarts can happen a few different ways:
- Use the restart button on the container modal.
- Use the stop / start button on the container modal.
- Using the global Stop All / Start All button on the environment dashboard.
- When a container configuration change is made.
By default the platform will provide all restart events with a 3 second stagger, this helps make sure that there is at least some time between the stop and start signals sent to the containers further reducing the chance of missed requests to that containers instances.
Container Settings
Users can make changes to container settings using the Settings tab on the container modal.
Basic Settings
Gives the user a space to make changes to:
| Field | Description |
|---|---|
| Name | The human readable name for the container. |
| Identifier | How the platform identifies this resource. |
| Deprecate | If checked, the container will be marked deprecated. |
| Lock Container | If checked, the container will be locked and the platform will deny attempts to delete it. |
Reimage
The reimage form can be used to replace the existing container image with a new one.
The Image dropdown shows all compatible images that this image can be replaced by. To show incompatible images, open the Advanced dropdown and select the checkbox.
For users that want to reconfigure on reimage, this options is also available.
Incompatible Images
Allowing "incompatible images" opens the reimage form up to all recent images instead of just those matching the current image source.
Scaling
The scaling slider gives users an intuitive way to adjust the current number of container instances. The scaling respects the currently selected deployment strategy when placing new instances on servers.
Container ID
This is a quick way to view and copy the container ID for this resource.
Annotations
Annotations are custom data that was added to this container via the API or a stack.
Delete
Use the container delete form. This will not work if "locked" is enabled.