IMPORTANT NOTICE we have archived this project because with our multi-tenant hosted S3 gateways you can use Velero AWS plugin to store the data in Storj decentralized storage network.
Example configuration of Velero AWS plugin with Storj DCS.
velero install \
--provider aws \
--plugins velero/velero-plugin-for-aws:v1.6.0 \
--bucket <YOUR_STORJ_BUCKET_NAME> \
--backup-location-config region=global,s3Url=gateway.storjshare.io \
--secret-file ./credentials-storj \
--use-volume-snapshots=false \
--use-restic
Velero is a tool to backup Kubernetes clusters. Velero does two things:
- Performs backups of the workloads running in a kubernetes cluster and,
- Takes snapshots of persistent volumes.
Velero is able to integrate with a variety of storage systems plugins. There are two types of plugins available: object store or volume snapshotter (or both).
Here we implement a Velero Object Store plugin that is backed by Storj DCS object storage.
- Complete Velero prerequisites and install the CLI: docs
- Create a Storj DCS account: docs
- Create an Access Grant: docs
- Set up Uplink CLI with the previously created Access Grant: doc
- Create a bucket where Velero will store the backups: docs
$ velero install --provider tardigrade \
--plugins storjlabs/velero-plugin \
--bucket $BUCKET \
--backup-location-config accessGrant=$ACCESS \
--no-secret
Perform a backup:
$ velero backup create $BACKUP_NAME
Perform a restore:
$ velero restore create $RESTORE_NAME --from-backup $BACKUP_NAME
This repository contains a Makefile that expose several targets for creating, running and performing several Velero operations for easing the development of this plugin but also for being able to try it out.
Use make help to see the list of targets and a brief description of what they offer.
The local environment requires the following tools:
- Kind: Local Kubernetes cluster using Docker containers. It requires to have Docker installed.
- Kubectl: The Kubernetes command-line tool.
- Velero CLI: The Velero command-line tool.
Be aware that the Makefile uses some Unix like tools that you may need to install depending of your Linux distribution and OSX and you will have to install for sure in Windows. While this local environment has been working fine in some Linux distributions and probably works in almost all of them, we believe that also works in OSX but we don't know if it will in Windows.
NOTE: Kind has some known issues and some of them are related with the OS and architecture.
For development you'll also need Go installed.
The Makefile contains a list of targets with the prefix dev-env-. The purpose of them are for easing the development cycle. For example, there the dev-env-refresh target that uninstall, build and install again the plugin, which is useful when you make changes in the plugin source code.
The local Kubernetes cluster created with Kind by the Makefile creates a Kubernetes configuraiton file in .k8s directory.
For connecting to this cluster with kubectl or Velero CLI you need to export the KUBECONFIG environment variable pointing to such file (e.g. export KUBECONFIG=$(pwd)/.k8s/config).
Follow the MAINTAINERS guide.