Swarm¶

This documentation describes how to perform the backup and restoration operations of a TraefikEE cluster in Swarm. For a general introduction of the backup and restore mechanism, we suggest reading the introduction first.

Note

In order to perform those operations, you will need to use traefikeectl. To set it up, please refer to the manual installation guide

Creating a Backup¶

This section describes how to backup a TraefikEE cluster on Swarm.

Command

traefikeectl backup

Expected output

Successfully generated backup archive at: 2019-03-13T174230_traefikee-backup.tar

Note

If you need to, TraefikEE also supports creating zip archives for backup, with the --archivetype=zip option.

Note

If, somehow, the backup system fails to generate a valid backup, you can force the generation of a new one with the --force flag.

Restoring a Cluster¶

traefikeectl install comes with a --archivepath option, which enables you to install a new cluster and restore a cluster state from given backup.

Command

traefikeectl install \
        --swarm \
        --archivepath=./your-backup.tar

Replacing an Existing Cluster¶

With traefikeectl, you can perform a "forced installation" which is going to replace the existing installation with a new cluster restored from given backup. Be careful, though, as installing a cluster with the --force option will uninstall the previous cluster an install a new one, which will cause a momentary service interruption.

Command

traefikeectl install \
        --swarm \
        --archivepath=./your-backup.tar \
        --force