Skip to content
Docker - HAC documentation hub

Docker

Clustering a Docker Container

These steps show the process of creating a Clustered docker container. The container will be created using a standard docker compose.yaml file.

Install docker engine

Before using docker in the cluster, the docker engine must be installed on all cluster nodes. Please see here for installation instructions.

  1. Navigate to HA-Cluster -> Docker in the webapp:

    docker-no-clustered-applications

  2. Click Cluster a Docker application to get to the creation/addition page and fill in the fields:

    docker-add-blank

    Available options:

    • Select HA Service - Select the service/pool that will host the docker container. In the event of a failover
    • Container Description - An optional description of the docker container
    • Location of compose.yaml file within selected service - The path in the selected pool/service to save the compose.yaml
    • Contents of compose.yaml file - Enter the contents of the compose.yaml file for the container
    • An Example compose.yaml:
    services:
      apache:
       image: httpd:latest
       container_name: my-apache-app
       ports:
        - 8080:80
       volumes:
        - ./website:/usr/local/apache2/htdocs
       restart: no
    

    Warning

    When adding your content, make sure to add restart: no to your service configurations. RSF-1 will manage the restart of clustered containers in the event of a failover

    docker-add-filled

  3. When finished click Create.

    docker-stopped

  4. By default the container will remain stopped until started. Click the Start button to spin up the container.

    docker-running