From ec41cce24397a4452a0e44099d1d73a5e3ad8550 Mon Sep 17 00:00:00 2001 From: kosabogi Date: Wed, 12 Feb 2025 15:02:43 +0100 Subject: [PATCH 01/18] Adds Manage snapshot repositories page --- .../manage-snapshot-repositories.md | 56 ++++++++++++++++++- 1 file changed, 55 insertions(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index fa4c3e669..d87701717 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -4,4 +4,58 @@ % GitHub issue: https://github.com/elastic/docs-projects/issues/343 -% Scope notes: Landing page for this containing links for Cloud and ECE \ No newline at end of file +% Scope notes: Landing page for this containing links for Cloud and ECE + +Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), or managing your own [Elasticsearch deployment](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. + +## Supported repository types + +### Elastic Cloud Hosted + +Elastic Cloud Hosted deployments automatically register the `found-snapshots` repository. Elastic Cloud Hosted deployments use this repository and the `cloud-snapshot-policy` to take periodic snapshots of your cluster. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. + +The `found-snapshots` repository is specific to each deployment. However, you can restore snapshots from another deployment’s found-snapshots repository if the deployments are under the same account and in the same region. + +Elastic Cloud Hosted deployments also support the following repository types: + +* [Azure](/deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md) +* [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md) +* [AWS S3](/deploy-managetools/snapshot-and-restore/ec-aws-custom-repository.md) +* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) + +For more details, refer to Managing snapshot repositories in [Elastic Cloud Hosted](/deploy-manage/tools/snapshot-and-restore/elastic-cloud-hosted.md). + +### Elastic Cloud Enterprise (ECE) + +Snapshot repositories are managed for your entire Elastic Cloud Enterprise installation and can be specified for an Elasticsearch cluster when you create or manage it. + +When a repository is specified, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis. + +Elastic Cloud Enterprise installations support the following Elasticsearch snapshot repository types: + +* [Azure](/deploy-manage/tools/snapshot-and-restore/azure-storage-repository.md) +* [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/google-cloud-storage-gcs-repository.md) +* [AWS S3](/deploy-manage/tools/snapshot-and-restore/minio-on-premise-repository.md) + +:::{note} +No repository types other than those listed are supported in the Elastic Cloud Enterprise platform, even if they are supported by Elasticsearch. +::: + +For more details, refer to Managing snapshot repositories in [Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.html). + +### Self-managed + +If you manage your own Elasticsearch cluster, you can use the following built-in snapshot repository types: + +* [Azure](/deploy-manage/tools/snapshot-and-restore/azure-repository.md) +* [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/google-cloud-storage-repository.md) +* [AWS S3](/deploy-manage/tools/snapshot-and-restore/s3-repository.md) +* [Shared file system](/deploy-manage/tools/snapshot-and-restore/shared-file-system-repository.md) +* [Read-only URL](/deploy-manage/tools/snapshot-and-restore/read-only-url-repository.html) +* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.html) + +Other repository types are available through official plugins: + +* [Hadoop Distributed File System (HDFS)](https://www.elastic.co/guide/en/elasticsearch/plugins/current/repository-hdfs.html) + +For more details, refer to the Managing snapshot repositories in [Self managed deployments](/deploy-manage/tools/snapshot-and-restore/self-managed.md) documentation. \ No newline at end of file From 9f10ef8300584a79227ce4c1d5538d403a1e715d Mon Sep 17 00:00:00 2001 From: kosabogi Date: Wed, 12 Feb 2025 18:05:09 +0100 Subject: [PATCH 02/18] Fixes link --- .../snapshot-and-restore/manage-snapshot-repositories.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index d87701717..96f8bab09 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -41,7 +41,7 @@ Elastic Cloud Enterprise installations support the following Elasticsearch snaps No repository types other than those listed are supported in the Elastic Cloud Enterprise platform, even if they are supported by Elasticsearch. ::: -For more details, refer to Managing snapshot repositories in [Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.html). +For more details, refer to Managing snapshot repositories in [Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md). ### Self-managed @@ -51,8 +51,8 @@ If you manage your own Elasticsearch cluster, you can use the following built-in * [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/google-cloud-storage-repository.md) * [AWS S3](/deploy-manage/tools/snapshot-and-restore/s3-repository.md) * [Shared file system](/deploy-manage/tools/snapshot-and-restore/shared-file-system-repository.md) -* [Read-only URL](/deploy-manage/tools/snapshot-and-restore/read-only-url-repository.html) -* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.html) +* [Read-only URL](/deploy-manage/tools/snapshot-and-restore/read-only-url-repository.md) +* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) Other repository types are available through official plugins: From ec3c453b03b235094095ea623bbcebfe2e7a88f1 Mon Sep 17 00:00:00 2001 From: kosabogi Date: Wed, 12 Feb 2025 18:09:12 +0100 Subject: [PATCH 03/18] Fix link --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 96f8bab09..a8168e462 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -20,7 +20,7 @@ Elastic Cloud Hosted deployments also support the following repository types: * [Azure](/deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md) * [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md) -* [AWS S3](/deploy-managetools/snapshot-and-restore/ec-aws-custom-repository.md) +* [AWS S3](/deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md) * [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) For more details, refer to Managing snapshot repositories in [Elastic Cloud Hosted](/deploy-manage/tools/snapshot-and-restore/elastic-cloud-hosted.md). From b357dde23923da6c046498547ed6b416e3cd311e Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:23:26 +0100 Subject: [PATCH 04/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index a8168e462..23304d25a 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -12,7 +12,7 @@ Snapshot repositories allow you to back up and restore your Elasticsearch data e ### Elastic Cloud Hosted -Elastic Cloud Hosted deployments automatically register the `found-snapshots` repository. Elastic Cloud Hosted deployments use this repository and the `cloud-snapshot-policy` to take periodic snapshots of your cluster. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. +Elastic Cloud Hosted deployments automatically register the `found-snapshots` repository. Elastic Cloud Hosted deployments use this repository and the `cloud-snapshot-policy` to take periodic snapshots of your {{es}} cluster. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. The `found-snapshots` repository is specific to each deployment. However, you can restore snapshots from another deployment’s found-snapshots repository if the deployments are under the same account and in the same region. From f08f571f951c2318091b75eae1f82d0fdbd2f922 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:23:58 +0100 Subject: [PATCH 05/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 23304d25a..4a2a40e6b 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -27,7 +27,7 @@ For more details, refer to Managing snapshot repositories in [Elastic Cloud Host ### Elastic Cloud Enterprise (ECE) -Snapshot repositories are managed for your entire Elastic Cloud Enterprise installation and can be specified for an Elasticsearch cluster when you create or manage it. +Snapshot repositories are managed at the platform level in Elastic Cloud Enterprise (ECE) and can be associated with deployments as needed. ECE supports the creation and maintenance of multiple repositories, but each deployment can be linked to only one repository for automatic snapshots. When a repository is specified, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis. From b1c19a5c7274d412d1d689526350c63f51418063 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:24:19 +0100 Subject: [PATCH 06/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 4a2a40e6b..85ac53b65 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -29,7 +29,7 @@ For more details, refer to Managing snapshot repositories in [Elastic Cloud Host Snapshot repositories are managed at the platform level in Elastic Cloud Enterprise (ECE) and can be associated with deployments as needed. ECE supports the creation and maintenance of multiple repositories, but each deployment can be linked to only one repository for automatic snapshots. -When a repository is specified, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis. +When a platform-level repository is associated with a deployment, the `found-snapshots` repository is added to the {{es}} cluster, and, similar to Elastic Cloud, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis.``` Elastic Cloud Enterprise installations support the following Elasticsearch snapshot repository types: From d1e7839507c03c1f4722a400768f7e6b5104a3a6 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:24:34 +0100 Subject: [PATCH 07/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 85ac53b65..0eaae415b 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -41,7 +41,7 @@ Elastic Cloud Enterprise installations support the following Elasticsearch snaps No repository types other than those listed are supported in the Elastic Cloud Enterprise platform, even if they are supported by Elasticsearch. ::: -For more details, refer to Managing snapshot repositories in [Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md). +For more details, refer to [Managing snapshot repositories in Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md). ### Self-managed From eef0ad503fbb13b1a013f02ec0fdad4d2d5e722c Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:24:44 +0100 Subject: [PATCH 08/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 0eaae415b..91bb318cf 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -23,7 +23,7 @@ Elastic Cloud Hosted deployments also support the following repository types: * [AWS S3](/deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md) * [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) -For more details, refer to Managing snapshot repositories in [Elastic Cloud Hosted](/deploy-manage/tools/snapshot-and-restore/elastic-cloud-hosted.md). +For more details, refer to [Managing snapshot repositories in Elastic Cloud Hosted](/deploy-manage/tools/snapshot-and-restore/elastic-cloud-hosted.md). ### Elastic Cloud Enterprise (ECE) From 53b255d323789211aa0c8453d1d760792452ae33 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:25:26 +0100 Subject: [PATCH 09/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 91bb318cf..01ecb891d 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -6,7 +6,7 @@ % Scope notes: Landing page for this containing links for Cloud and ECE -Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), or managing your own [Elasticsearch deployment](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. +Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), or managing your own [Elasticsearch cluster](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. ## Supported repository types From e572955f15e8efe935435df65983aa00d80746a1 Mon Sep 17 00:00:00 2001 From: kosabogi Date: Thu, 13 Feb 2025 10:44:30 +0100 Subject: [PATCH 10/18] Adds ECK to self-managed --- .../snapshot-and-restore/manage-snapshot-repositories.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 01ecb891d..d7cc8f1a1 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -58,4 +58,8 @@ Other repository types are available through official plugins: * [Hadoop Distributed File System (HDFS)](https://www.elastic.co/guide/en/elasticsearch/plugins/current/repository-hdfs.html) -For more details, refer to the Managing snapshot repositories in [Self managed deployments](/deploy-manage/tools/snapshot-and-restore/self-managed.md) documentation. \ No newline at end of file +#### Elastic Cloud on Kubernetes (ECK) + +ECK is also considered a self-managed deployment method. It supports the same snapshot repositories as self-managed Elasticsearch and has no additional restrictions. + +For more details, refer to the Managing snapshot repositories in [Self managed deployments](/deploy-manage/tools/snapshot-and-restore/self-managed.md) and the [Elastic Cloud on Kubernetes](/deploy-manage/tools/snapshot-and-restore/cloud-on-k8s.md) documentation. \ No newline at end of file From 97ba0458beac5c6f063f059115e183f1843f6967 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 16:30:02 +0100 Subject: [PATCH 11/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index d7cc8f1a1..2454b6a67 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -12,7 +12,7 @@ Snapshot repositories allow you to back up and restore your Elasticsearch data e ### Elastic Cloud Hosted -Elastic Cloud Hosted deployments automatically register the `found-snapshots` repository. Elastic Cloud Hosted deployments use this repository and the `cloud-snapshot-policy` to take periodic snapshots of your {{es}} cluster. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. +{{ech}} deployments automatically register a repository named `found-snapshots` in {{es}} clusters. These repositories are used together with the `cloud-snapshot-policy` SLM policy to take periodic snapshots of your {{es}} clusters. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. The `found-snapshots` repository is specific to each deployment. However, you can restore snapshots from another deployment’s found-snapshots repository if the deployments are under the same account and in the same region. From 87eb23a786eee37c3a1472931dfdc0232120426a Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 16:30:15 +0100 Subject: [PATCH 12/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 2454b6a67..725f3a6c5 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -29,7 +29,7 @@ For more details, refer to [Managing snapshot repositories in Elastic Cloud Host Snapshot repositories are managed at the platform level in Elastic Cloud Enterprise (ECE) and can be associated with deployments as needed. ECE supports the creation and maintenance of multiple repositories, but each deployment can be linked to only one repository for automatic snapshots. -When a platform-level repository is associated with a deployment, the `found-snapshots` repository is added to the {{es}} cluster, and, similar to Elastic Cloud, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis.``` +When a platform-level repository is associated with a deployment, the `found-snapshots` repository is added to the {{es}} cluster, and, similar to Elastic Cloud, a snapshot is taken every 30 minutes by default. The interval can be adjusted on per deployment basis. Elastic Cloud Enterprise installations support the following Elasticsearch snapshot repository types: From 0f2ff481bc15ba5ae6d0b7ce820b92a2a2afe73c Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 16:30:58 +0100 Subject: [PATCH 13/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 725f3a6c5..22e2d4caa 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -60,6 +60,6 @@ Other repository types are available through official plugins: #### Elastic Cloud on Kubernetes (ECK) -ECK is also considered a self-managed deployment method. It supports the same snapshot repositories as self-managed Elasticsearch and has no additional restrictions. +{{es}} clusters deployed through ECK support the same type of deployments as self-managed {{es}} clusters. ECK does not currently provide any automation or functionality to facilitate the integration of snapshot repositores within the {{es}} clusters. For more details, refer to the Managing snapshot repositories in [Self managed deployments](/deploy-manage/tools/snapshot-and-restore/self-managed.md) and the [Elastic Cloud on Kubernetes](/deploy-manage/tools/snapshot-and-restore/cloud-on-k8s.md) documentation. \ No newline at end of file From dbf307be25401618d3b8e230eee43497adff681b Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 16:31:35 +0100 Subject: [PATCH 14/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 22e2d4caa..6d93dee45 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -62,4 +62,4 @@ Other repository types are available through official plugins: {{es}} clusters deployed through ECK support the same type of deployments as self-managed {{es}} clusters. ECK does not currently provide any automation or functionality to facilitate the integration of snapshot repositores within the {{es}} clusters. -For more details, refer to the Managing snapshot repositories in [Self managed deployments](/deploy-manage/tools/snapshot-and-restore/self-managed.md) and the [Elastic Cloud on Kubernetes](/deploy-manage/tools/snapshot-and-restore/cloud-on-k8s.md) documentation. \ No newline at end of file +For more information and examples, refer to [create automated snapshots on ECK](/deploy-manage/tools/snapshot-and-restore/cloud-on-k8s.md). \ No newline at end of file From 977cac041282c9a01da2a15c4ed1be35c2fb0bdb Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Thu, 13 Feb 2025 16:31:52 +0100 Subject: [PATCH 15/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 6d93dee45..7355200ee 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -6,7 +6,7 @@ % Scope notes: Landing page for this containing links for Cloud and ECE -Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), or managing your own [Elasticsearch cluster](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. +Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), [Elastic Cloud on Kubernetes (ECK)](#elastic-cloud-on-kubernetes-eck), or managing your own [Elasticsearch cluster](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. ## Supported repository types From 3e43f962cab08c1ebfd8fd4a1f0a40c7ac931df7 Mon Sep 17 00:00:00 2001 From: kosabogi Date: Thu, 13 Feb 2025 16:58:47 +0100 Subject: [PATCH 16/18] Adds applies-to tag and reorders deployment types --- deploy-manage/tools/snapshot-and-restore.md | 7 ++++ .../manage-snapshot-repositories.md | 42 ++++++++++++------- 2 files changed, 33 insertions(+), 16 deletions(-) diff --git a/deploy-manage/tools/snapshot-and-restore.md b/deploy-manage/tools/snapshot-and-restore.md index 3d6d6bd17..e013098f9 100644 --- a/deploy-manage/tools/snapshot-and-restore.md +++ b/deploy-manage/tools/snapshot-and-restore.md @@ -6,6 +6,13 @@ mapped_urls: - https://www.elastic.co/guide/en/cloud-heroku/current/ech-snapshot-restore.html - https://www.elastic.co/guide/en/cloud-heroku/current/ech-restoring-snapshots.html - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-snapshots.html + +applies: + stack: all + hosted: all + ece: all + eck: all + --- # Snapshot and restore diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 7355200ee..0270b925a 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -1,3 +1,13 @@ +--- + + applies: + stack: all + hosted: all + ece: all + eck: all + +--- + # Manage snapshot repositories % What needs to be done: Write from scratch @@ -10,6 +20,21 @@ Snapshot repositories allow you to back up and restore your Elasticsearch data e ## Supported repository types +### Self-managed + +If you manage your own Elasticsearch cluster, you can use the following built-in snapshot repository types: + +* [Azure](/deploy-manage/tools/snapshot-and-restore/azure-repository.md) +* [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/google-cloud-storage-repository.md) +* [AWS S3](/deploy-manage/tools/snapshot-and-restore/s3-repository.md) +* [Shared file system](/deploy-manage/tools/snapshot-and-restore/shared-file-system-repository.md) +* [Read-only URL](/deploy-manage/tools/snapshot-and-restore/read-only-url-repository.md) +* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) + +Other repository types are available through official plugins: + +* [Hadoop Distributed File System (HDFS)](https://www.elastic.co/guide/en/elasticsearch/plugins/current/repository-hdfs.html) + ### Elastic Cloud Hosted {{ech}} deployments automatically register a repository named `found-snapshots` in {{es}} clusters. These repositories are used together with the `cloud-snapshot-policy` SLM policy to take periodic snapshots of your {{es}} clusters. You can also use the `found-snapshots` repository for your own [SLM policies](/deploy-manage/tools/snapshot-and-restore/create-snapshots.md#automate-snapshots-slm) or to store searchable snapshots. @@ -43,22 +68,7 @@ No repository types other than those listed are supported in the Elastic Cloud E For more details, refer to [Managing snapshot repositories in Elastic Cloud Enterprise](/deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md). -### Self-managed - -If you manage your own Elasticsearch cluster, you can use the following built-in snapshot repository types: - -* [Azure](/deploy-manage/tools/snapshot-and-restore/azure-repository.md) -* [Google Cloud Storage](/deploy-manage/tools/snapshot-and-restore/google-cloud-storage-repository.md) -* [AWS S3](/deploy-manage/tools/snapshot-and-restore/s3-repository.md) -* [Shared file system](/deploy-manage/tools/snapshot-and-restore/shared-file-system-repository.md) -* [Read-only URL](/deploy-manage/tools/snapshot-and-restore/read-only-url-repository.md) -* [Source-only](/deploy-manage/tools/snapshot-and-restore/source-only-repository.md) - -Other repository types are available through official plugins: - -* [Hadoop Distributed File System (HDFS)](https://www.elastic.co/guide/en/elasticsearch/plugins/current/repository-hdfs.html) - -#### Elastic Cloud on Kubernetes (ECK) +### Elastic Cloud on Kubernetes (ECK) {{es}} clusters deployed through ECK support the same type of deployments as self-managed {{es}} clusters. ECK does not currently provide any automation or functionality to facilitate the integration of snapshot repositores within the {{es}} clusters. From 12d11c6951cfe164e57cd41cb3ff3f28cf77495d Mon Sep 17 00:00:00 2001 From: kosabogi Date: Fri, 14 Feb 2025 10:13:05 +0100 Subject: [PATCH 17/18] Fixes applies-to --- .../snapshot-and-restore/manage-snapshot-repositories.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index 0270b925a..e740cc54e 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -1,11 +1,11 @@ --- - applies: +applies: stack: all hosted: all ece: all eck: all - + --- # Manage snapshot repositories From d65f867e31508a24bd703b5349156b751e4865f9 Mon Sep 17 00:00:00 2001 From: kosabogi <105062005+kosabogi@users.noreply.github.com> Date: Mon, 17 Feb 2025 11:49:51 +0100 Subject: [PATCH 18/18] Update deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- .../tools/snapshot-and-restore/manage-snapshot-repositories.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md index e740cc54e..58a3c61f0 100644 --- a/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md +++ b/deploy-manage/tools/snapshot-and-restore/manage-snapshot-repositories.md @@ -16,7 +16,7 @@ applies: % Scope notes: Landing page for this containing links for Cloud and ECE -Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [Elastic Cloud](#elastic-cloud-hosted), [Elastic Cloud Enterprise (ECE)](#elastic-cloud-enterprise-ece), [Elastic Cloud on Kubernetes (ECK)](#elastic-cloud-on-kubernetes-eck), or managing your own [Elasticsearch cluster](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. +Snapshot repositories allow you to back up and restore your Elasticsearch data efficiently. Whether you're using [{{ech}}](#elastic-cloud-hosted), [{{ece}} (ECE)](#elastic-cloud-enterprise-ece), [{{eck}} (ECK)](#elastic-cloud-on-kubernetes-eck), or managing your own [{{es}} cluster](#self-managed), configuring a snapshot repository ensures data security, long-term archiving, and seamless migration across environments. ## Supported repository types