You are looking at the documentation of a prior release. To read the documentation of the latest release, please
visit here.
Install Elasticsearch Addon for Stash
Stash uses Function-Task model to backup databases. This Function-Task model enables Stash to extend its capability via addons. In order to backup Elasticsearch databases, you have to install Elasticsearch addon (stash-elasticsearch) for Stash. This addon creates necessary Function and Task definitions to backup/restore Elasticsearch database.
You can install the addon either as a helm chart or you can create only the YAMLs of the respective resources.
Using Helm 3
Run the following script to install stash-elasticsearch addon as a Helm chart using Helm 3.
curl -fsSL https://github.com/stashed/catalog/raw/v2020.08.27/deploy/helm3.sh | bash -s -- --catalog=stash-elasticsearch
Using Helm 2
Run the following script to install stash-elasticsearch addon as a Helm chart using Helm 2.
curl -fsSL https://github.com/stashed/catalog/raw/v2020.08.27/deploy/helm2.sh | bash -s -- --catalog=stash-elasticsearch
Using YAML
Run the following script to install stash-elasticsearch addon as Kubernetes YAMLs.
curl -fsSL https://github.com/stashed/catalog/raw/v2020.08.27/deploy/script.sh | bash -s -- --catalog=stash-elasticsearch
The above script uses Helm 3 for rendering the charts to generate the YAMLs.
Verify Installation
After installation is completed, this addon will create elasticsearch-backup-* and elasticsearch-restore-* Functions and Tasks for all supported Elasticsearch versions. To verify, run the following command:
$ kubectl get functions.stash.appscode.com
NAME AGE
elasticsearch-backup-7.2 20s
elasticsearch-backup-6.8 20s
elasticsearch-backup-6.5 19s
elasticsearch-backup-6.4 20s
elasticsearch-backup-6.3 20s
elasticsearch-backup-6.2 20s
elasticsearch-backup-5.6 20s
elasticsearch-restore-7.2 20s
elasticsearch-restore-6.8 20s
elasticsearch-restore-6.5 19s
elasticsearch-restore-6.4 20s
elasticsearch-restore-6.3 20s
elasticsearch-restore-6.2 20s
elasticsearch-restore-5.6 20s
pvc-backup 7h6m
pvc-restore 7h6m
update-status 7h6m
Also, verify that the Task have been created.
$ kubectl get tasks.stash.appscode.com
NAME AGE
elasticsearch-backup-7.2 2m7s
elasticsearch-backup-6.8 2m7s
elasticsearch-backup-6.5 2m6s
elasticsearch-backup-6.4 2m7s
elasticsearch-backup-6.3 2m7s
elasticsearch-backup-6.2 2m7s
elasticsearch-backup-5.6 2m7s
elasticsearch-restore-7.2 2m7s
elasticsearch-restore-6.8 2m7s
elasticsearch-restore-6.5 2m6s
elasticsearch-restore-6.4 2m7s
elasticsearch-restore-6.3 2m7s
elasticsearch-restore-6.2 2m7s
elasticsearch-restore-5.6 2m7s
pvc-backup 7h7m
pvc-restore 7h7m
Now, Stash is ready to backup Elasticsearch databases.
Customizing Installation
In order to install Function and Task only for a specific Elasticsearch version, use --version flag to specify the desired database version.
curl -fsSL https://github.com/stashed/catalog/raw/v2020.08.27/deploy/helm3.sh | bash -s -- --catalog=stash-elasticsearch --version=6.5
The flowing flags are available for customizing Elasticsearch addon installation:
| Flag | Usage |
|---|---|
--version | Specify a specific version of a specific addon to install. Use it along with --catalog flag. |
--docker-registry | Specify the docker registry to use to pull respective addon images. Default Value: stashed. |
--image | Specify the name of the docker image to use for respective addons. |
--image-tag | Specify the tag of the docker image to use for respective addon. |
--es-backup-args | Specify optional arguments to pass to multielaticdump command during backup. These arguments apply to all Elasticsearch instances in this cluster. To set arguments for a specific Elasticsearch database instance, set esArgs parameter in spec.task.params field of the respective BackupConfiguration. |
--es-restore-args | Specify optional arguments to pass to multielastic command during restore. These arguments apply to all Elasticsearch instances in this cluster. To set arguments for a specific Elasticsearch database instance, set esArgs parameter in spec.task.params field of the respective RestoreSession. |