2. Saving Data
By default, all data produced by the agent will be lost when the container is destroyed. This loss of data will manifest itself in two obvious ways:
1. When using the external command, a new external server entry will be created in ICE Server each time the Docker container is run (for example, if using external patch, a new patch server will appear in ICE Desktop > Settings > Patch Servers).
2. When using the tactical command, any configuration changes made in the ICE Configuration Wizard will be lost; restarting the container will revert to the default configuration.
Both issues can be resolved by mapping the /app/conf directory inside the container to a path on the local host. Use the -v argument to Docker to achieve this.
Only the paths (in the ICE Agent) listed in the Agent Path Mapping table (below) can be mapped to a local directory on the Docker host system with the -v command. For more advanced use cases, including mapping other paths not listed here, use the --mount command. Consult the official Docker documentation for details.
Agent Path Mapping | |
Path | Contents |
/app/conf | Configuration state produced by the agent |
/app/logs | Log files written by the agent |
/app/status | Status files written and updated by child processes (such as rallypointd or engagebridged). |
/app/cert | Certificate store files |
For example:
docker run -v /path/on/disk:/app/status ...