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 bring up the creation/addition page and fill in the fields:

    docker-add-filled

    Available options:

    • Select HA Service - The service/pool that will host the docker container. In the event of a failover of this service the complete docker container will be moved with it.
    • Container Description - An optional description of the docker container.
    • Dataset - Location of compose.yaml file within selected service.
    • Contents - The compose.yaml file for the docker container. Here is an example WEB server:
    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

  3. When finished click Create. This will add the service in a stopped state:

    docker-stopped

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

    docker-running

    Note

    When a container is started for the first time there maybe a slight delay as the required images for the container are downloaded.