Container Integrations Configuration

container integrations

Container integration configuration exposes multiple integration options to users.

To navigate to a container integration settings go to any container and select the Config navigation option. From there select Integrations from the sub menu.

There are four options when setting up container integrations:

Files

The files integration has a Source and Destination setting for each entry. The source entry is an endpoint serving the files and the destination is where the file should be written to in the container.

Shared Directories

Shared directories allow for a shared directory between containers running on the same host.

These directories are defined as identifiers in the server configuration.

This integration has three parts:

FieldDescription
IdentifierA special identifier, used to associate with the underlying directory.
WritableA boolean where true means the given container can write to the directory.
Mount PointWhere in the container to mount the shared directory.

The mount point can be a directory that does not yet exist on the container. For example /app/shared can be used and if that directory does not exist on the host it will be added.

Let's Encrypt

Allows the user to control where TLS certificates are installed for a container. Using this option on a container means reserving a specific inbound port as the load balancer will have no information other than port to route the traffic if the connection is still encrypted.

TLS Certificates that use this integration must be generated through the DNS tooling.

Choosing the checkbox under enable will install all four options to the default location /var/run/cycle/tls/* where * represents the specific asset path. Click the customize checkbox next to the files and supply a path if a custom path is desired.

Webhooks

The integration webhooks represent the 4 different types of events that can be hooked into for this container.

FieldDescription
StartAn endpoint to hit when the container starts.
StopAn endpoint to hit when the container stops.
DeployAn endpoint to hit when a deploy event happens (tied to stack deployments).
ConfigAn endpoint that hosts a container config object to be used for granular configuration changes at runtime.