Documentation for version v0.3.0 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
This doc provides sample Ark commands for the following common scenarios:
Using Schedules and Restore-Only Mode
If you periodically back up your cluster’s resources, you are able to return to a previous state in case of some unexpected mishap, such as a service outage. Doing so with Heptio Ark looks like the following:
After you first run the Ark server on your cluster, set up a daily backup (replacing
<SCHEDULE NAME> in the command as desired):
ark schedule create <SCHEDULE NAME> --schedule "0 7 * * *"
This creates a Backup object with the name
A disaster happens and you need to recreate your resources.
Ark server Config, setting
true. This prevents Backup objects from being created or deleted during your Restore process.
Create a restore with your most recent Ark Backup:
ark restore create <SCHEDULE NAME>-<TIMESTAMP>
Using Backups and Restores
Heptio Ark can help you port your resources from one cluster to another, as long as you point each Ark Config to the same cloud object storage. In this scenario, we are also assuming that your clusters are hosted by the same cloud provider. Note that Heptio Ark does not support the migration of persistent volumes across cloud providers.
(Cluster 1) Assuming you haven’t already been checkpointing your data with the Ark
schedule operation, you need to first back up your entire cluster (replacing
<BACKUP-NAME> as desired):
ark backup create <BACKUP-NAME> --snapshot-volumes
The default TTL is 24 hours; you can use the
--ttl flag to change this as necessary.
(Cluster 2) Make sure that the
backupStorageProvider fields in the Ark Config match the ones from Cluster 1, so that your new Ark server instance is pointing to the same bucket.
(Cluster 2) Make sure that the Ark Backup object has been created. Ark resources are synced with the backup files available in cloud storage.
(Cluster 2) Once you have confirmed that the right Backup (
<BACKUP-NAME>) is now present, you can restore everything with:
ark restore create <BACKUP-NAME> --restore-volumes