cloud-common.md

Set up Ark with your cloud provider

To run Ark with your cloud provider, you specify provider-specific settings for the Ark server. In version 0.7.0 and later, you can run Ark in any namespace, which requires additional customization. See Run in custom namespace.

The Ark repository includes a set of example YAML files that specify the settings for each cloud provider. For provider-specific instructions, see:

• Run Ark on AWS
• Run Ark on GCP
• Run Ark on Azure
• Use IBM Cloud Object Store as Ark's storage destination

Examples

After you set up the Ark server, try these examples:

Basic example (without PersistentVolumes)

1. Start the sample nginx app:

   kubectl apply -f examples/nginx-app/base.yaml

2. Create a backup:

   ark backup create nginx-backup --include-namespaces nginx-example

3. Simulate a disaster:

   kubectl delete namespaces nginx-example

   Wait for the namespace to be deleted.

4. Restore your lost resources:

   ark restore create --from-backup nginx-backup

Snapshot example (with PersistentVolumes)

NOTE: For Azure, your Kubernetes cluster needs to be version 1.7.2+ to support PV snapshotting of its managed disks.

1. Start the sample nginx app:

   kubectl apply -f examples/nginx-app/with-pv.yaml

2. Create a backup with PV snapshotting:

   ark backup create nginx-backup --include-namespaces nginx-example

3. Simulate a disaster:

   kubectl delete namespaces nginx-example

   Because the default reclaim policy for dynamically-provisioned PVs is "Delete", these commands should trigger your cloud provider to delete the disk backing the PV. The deletion process is asynchronous so this may take some time. Before continuing to the next step, check your cloud provider to confirm that the disk no longer exists.

4. Restore your lost resources:

   ark restore create --from-backup nginx-backup