We are very excited to announce Stash v0.9.0-rc.0
. This release introduces v1beta1
API and a design overhaul. The new API and design enable Stash to support the use cases that were not possible before. This makes Stash more powerful, transparent, extensible and customizable. We are expecting that this new API will graduate to GA after some maturity. Check out the new architecture from here.
What's New
This release introduces lots of new features and changes. A summary of these new features is given below:
New Custom Resources
The following custom resources have been introduced in this release:
New Features
In addition to improving existing features, this release introduces the following new features:
-
Backup & Restore Stand-alone PVC :
Stash now supports taking backup of a stand-alone PVC. To learn more about how Stash takes backup of a stand-alone PVC, please visit here. -
Backup & Restore Databases :
Stash now can backup PostgreSQL, MongoDB, Elasticsearch and MySQL databases in both stand-alone and clustered mode. To learn more about how Stash takes backup of a database, please visit here. -
VolumeSnapshot :
Now, you can take a scheduled snapshot of the volumes of a workload using Kubernetes VolumeSnapshot API. Check out how volume snapshotting works in Stash from here. -
Instant Backup :
You can now trigger a backup instantly. To learn how, please visit here. -
Auto Backup :
Now, Stash will let you configure a common template to backup similar types of target. You will require to add just a few annotations to the targeted workload to enable backup for it. Want to know how? Please visit here. -
Support PSP Enabled Cluster :
Stash now supports PSP enabled cluster. -
Improved Prometheus Metrics :
We have improved Prometheus metrics in this release. Check out the new metrics from here. -
Support REST Server as Backend :
Stash now supports REST server as backend. To learn how to configure REST backend, please visit here. -
KubeDB Integration :
Stash now seemingly integrates with KubeDB. It is now recommended tool to backup & restore KubeDB supported databases.
For a complete feature list of this release, please visit here.
Significant Changes
- Stash now has been moved from appscode Github organization to its own organization. New home for Stash is stashed organization.
- We have split the original
appscode/stash
repository into multiple repositories (stashed/stash, stashed/installer, stashed/docs). This enables us to push emergency fixes to installer and docs without requiring to cut a new release. - Now Stash uses a more industry-standard
Makefile
based build process. This makes building Stash from source code simple and easy (#800). - We have added ARM architecture support in this release. Thanks to @carlosedp (#802).
- We now use Docker manifest to build Stash docker images. Hence, Stash docker images are now platform aware. You don't have to worry about your platform architecture. Docker will take care of it (#802).
- We have updated restic version from
0.8.3
to0.9.5
(#789). - We have upgraded Kubernetes client to
v1.14.0
(#775). - Now Stash uses
failurePolicy: Ignore
in webhooks for Kubernetes official resources. So, Stash will no longer cause any problem for creating new Kubernetes resources when it is not ready (#726). - As RBAC is now default in most of the Kubenetes cluster and creating RBAC resources in an RBAC disabled cluster does not cause any problem, we have removed
--rbac
flag. Now, Stash will always start in RBAC enabled mode (#761). - We have moved to go mod from glide for dependency management (#775).
- We have changed Stash package path to
stash.appscode.dev/stash
(#776).
Upgrading from 0.8.3
If you are upgrading Stash from 0.8.3
to this version, pay attention to the following things:
What will work:
- Exiting scheduled backup will continue to work.
- Scheduling new backup using Restic crd will work.
- Restoring the already backed up data using Recovery crd will work.
What will not work:
- Restoring the data that was backed up using old API (
Restic
) with the new API (RestoreSession
) will not work. - Restoring the data that was backed up using new API (
BackupConfiguration
) with the old API (Recovery
) will not work. - Using new API (
BackupConfiguration
) to backup into already existing Repository will not work. Stash will upload all targeted data again into the backend. Old snapshots will not be usable any more. - Old Grafana dashboard will not work with new metrics.
Issues Fixed
- Sidecar RoleBinding is not being created when Mutating Webhook is enabled #395
- Cannot deploy stash with helm@3 #822
- Restore PVCs from templates using Restic #784
- Handle restored files permission properly #733
- Use restic 0.9.5 #781
- Support PSP or SCC (openshift) enabled clusters #462
- Configure environment variables (or proxy settings) on restic and recovery CRDs #621
- Proposal: Move cluster backup part from Kubed to Stash #601
- error: unable to retrieve the complete list of server APIs: admission.stash.appscode.com/v1alpha1: the server is currently unable to handle the request, repositories.stash.appscode.com/v1alpha1: the server is currently unable to handle the request #785
- Internal error occurred: failed calling webhook "deployment.admission.stash.appscode.com": the server is currently unable to handle the request #692
- MutatingWebhooks must be without side-effect #758
- Targeted Workload stuck in terminating state after deleted a Restic CRD #672
- OSM config and file permission issue #766
- Remove
--rbac
flag #705 - Use FailurePolicy ignore for K8s resource webhooks? #709
- FR: Add possibility to change settings of Restic #545
- Allow setting
nice
andionice
for backup command #366 - Cleanup old cache after backup #703
- Support Restic Rest server as backend. #126
Pull Request Summary
- Remove the
bs
short name for BackupSession #859 (tamalsaha) - Use github.com/golang/protobuf@v1.2.0 #855 (tamalsaha)
- Fix resolving Task when volumeClaimTemplate is specified in RestoreSession #852 (hossainemruz)
- Use POD_ORDINAL env var to restore using PVC template #849 (suaas21)
- Pass replicas from RestoreSession to Function #848 (hossainemruz)
- Rename BackupConfigurationTemplate to BackupBlueprint #847 (hossainemruz)
- Use variable for version in BackupConfigurationTemplate name #846 (hossainemruz)
- New variable from type field of AppBinding + Fix RoleBinding name conflict with KubeDB #845 (hossainemruz)
- Fix Platforms Issue #844 (suaas21)
- Add support to restore using volumeClaimTemplate in Function-Task model #841 (hossainemruz)
- Add GetSnapshotSize() function #839 (hossainemruz)
- Fix travis build #837 (tamalsaha)
- Update azure-sdk-for-go dependencies #836 (tamalsaha)
- Fix RestoreSession replicas logic #835 (suaas21)
- Use robfig/cron@v3 #834 (tamalsaha)
- Add support for parallel backup & restore #833 (hossainemruz)
- Fix restore Job parallel execution #832 (suaas21)
- Remove unused code #829 (tamalsaha)
- Generate docs files inside docs repo #828 (tamalsaha)
- Add License notice to makefile #825 ([tamalsaha]https://github.com/tamalsaha())
- Create default Functions and Tasks from operator #824 (hossainemruz)
- Fix default securityContext passing to restore init-container/job #823 (hossainemruz)
- Fix restore job RBAC #821 (hossainemruz)
- Fixed volumeSnapshot Error Issue #819 (suaas21)
- Always attempt to pull a newer image for
make container
#818 (tamalsaha) - Make --image-tag a required flag. #817 (tamalsaha)
- Add PusgatewayURL input for Functions #816 (hossainemruz)
- Add TARGET_RESOURCE variable for BackupConfigurationTemplate #814 (hossainemruz)
- Add make install, uninstall, purge commands #813 (tamalsaha)
- Move chart & deploy scripts to github.com/stashed/installer #811 (tamalsaha)
- Move docs to github.com/stashed/docs repo #810 (tamalsaha)
- Restore PVCs from templates using Restic #809 (hossainemruz)
- Move HandleResticError to util package #806 (tamalsaha)
- Remove canary support #805 ([tamalsaha]https://github.com/tamalsaha())
- Fix travis build #804 (tamalsaha)
- Update Version.go #803 (tamalsaha)
- Added ARM64 support to the install script and manifest #802 (tamalsaha)
- Pass labels to offshoot + add generic offshoot labels #801 (hossainemruz)
- Add Makefile #800 (tamalsaha)
- Skip BackupSession creation if target does not exist + use timestamp … #797 (hossainemruz)
- Use absolute path as aliases for reference docs. #796 (tamalsaha)
- Remove importance of order of rule in RestoreSession #795 (hossainemruz)
- Use restic 0.9.5 #789 (hossainemruz)
- VolumeSnapshot #787 (suaas21)
- Fix: User and group creation of stash for mongodb and mysql #786 (the-redback)
- Update backup manager #782 ([tamalsaha]https://github.com/tamalsaha())
- Configure Env variables for Functions #780 (tamalsaha)
- Fix rest backend for workloads + add more authentication method for swift backend #778 (hossainemruz)
- Update package path to stash.appscode.dev/stash #776 (tamalsaha)
- Update to k8s 1.14.0 client libraries using go.mod #775 (tamalsaha)
- MutatingWebhooks must be without side-effect #773 (suaas21)
- Introduce VolumeSnapshot APIs #772 (hossainemruz)
- Use osm pkg from kmodules/objectstore-api #770 (tamalsaha)
- Remove --rbac flag #761 (suaas21)
Skip creating/processing backup-session when backup-config is paused #759 (diptadas) - Add "Supported Backends" doc to new guides #756 (hossainemruz)
- Add guides template for new design #755 (hossainemruz)
- Run restic commands using docker #754 (diptadas)
- Stash v1beta1 E2E test for PVC #753 (suaas21)
- Update Kubernetes client libraries to 1.13.5 #752 [https://github.com//pull/752] (tamalsaha)
- Enable pipefail and update restore yamls #750 (diptadas)
- Implement snapshots for v1beta1 api #749 (diptadas)
- Stash v1beta1 E2E test for ReplicaSet #747 (suaas21)
- Apply nice/ionice settings from env #746 (diptadas)
- Fixed scratch-dir, output-dir and hostname in functions/tasks yamls #744 (diptadas)
- Stash v1beta1 E2E test for ReplicationController #742 (suaas21)
- Stash v1beta1 E2E test for DaemonSet #741 (suaas21)
- Update concept doc #739 (hossainemruz)
- Stash V1beta1 E2E test for StatefulSet #737 (suaas21)
- Attach volume for local backend #736 (diptadas)
- Add Stash CLI #734 (diptadas)
- Fix openapi path prefixes for validators and mutators #732 (tamalsaha)
- Add max-connections for GCS, Azure, B2 backend #730 (diptadas)
- Support PSP enabled cluster #729 (hossainemruz)
- Use FailurePolicy ignore for K8s resource webhooks #726 (diptadas)
- Rename admission webhooks to avoid name collision #725 (diptadas)
- Don't write secret data inside temp dir #724 (diptadas)
- Add support for backup cluster resources YAML #721 (hossainemruz)
- Add TempDir and PSP settings for Function #720 (tamalsaha)
- Apply EmptyDir settings to TmpDir #719 (diptadas)
- Use cleanup-cache flag #717 (diptadas)
- Use ionice and nice with Restic CMD #716 (diptadas)
- Add support for OpenShift DeploymentConfig #714 (hossainemruz)
- Add support for rest backend #713 (diptadas)
- Stash V1beta1 E2E test for Deployment #710 (suaas21)
- Backup and restore Elasticsearch #702 (diptadas)
- Add BackupSession Controller for Sidecar #701 (suaas21)
- Backup and restore Mongo DB #699 (diptadas)
- Backup and restore MySQL DB #696 (diptadas)
- Backup and restore Postgres DB #695 (diptadas)
- Backup from stdin and dump to stdout #694 (diptadas)
- Post backup/restore status update #691 (diptadas)
- Use ContainerRuntimeSettings in Function spec #689 (diptadas)
- Fix v1beta1 api for BackupConfigurationTemplate #688 (hossainemruz)
- Update Kubernetes client libraries to 1.13.0 #687 (tamalsaha)
- Backup and restore PVC #676 (diptadas)
- Update workload controller for new design #675 (hossainemruz)
- Resolve tasks for backup/restore sessions #674 (diptadas)
- Add restic wrapper library #673 (hossainemruz)
- Add BackupConfiguration Controller #671 (suaas21)
- Introduce v1beta1 api #647 (hossainemruz)