Documentation for version v0.9.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.

Heptio Ark is now Velero! v0.11 is our first release with the new name. For instructions on migrating your Ark deployments and data to Velero, please see the Upgrade section in the latest version. For more details on the renaming, please read our blog post.

FAQ

When is it appropriate to use Ark instead of etcd’s built in backup/restore?

Etcd’s backup/restore tooling is good for recovering from data loss in a single etcd cluster. For example, it is a good idea to take a backup of etcd prior to upgrading etcd itself. For more sophisticated management of your Kubernetes cluster backups and restores, we feel that Ark is generally a better approach. It gives you the ability to throw away an unstable cluster and restore your Kubernetes resources and data into a new cluster, which you can’t do easily just by backing up and restoring etcd.

Examples of cases where Ark is useful:

Will Ark restore my Kubernetes resources exactly the way they were before?

Yes, with some exceptions. For example, when Ark restores pods it deletes the nodeName from the pod so that it can be scheduled onto a new node. You can see some more examples of the differences in pod_action.go

I’m using Ark in multiple clusters. Should I use the same bucket to store all of my backups?

We strongly recommend that you use a separate bucket per cluster to store backups. Sharing a bucket across multiple Ark instances can lead to numerous problems - failed backups, overwritten backups, inadvertently deleted backups, etc., all of which can be avoided by using a separate bucket per Ark instance.

Related to this, if you need to restore a backup from cluster A into cluster B, please use restore-only mode in cluster B’s Ark instance while it’s configured to use cluster A’s bucket. This will ensure no new backups are created, and no existing backups are deleted or overwritten.

I receive ‘custom resource not found’ errors when starting up the Ark server

Ark’s server will not start if the required Custom Resource Definitions are not found in Kubernetes. Apply the examples/common/00-prereqs.yaml file to create these defintions, then restart Ark.