OpenSearch Copias de seguridad de cluster mediante la API de instantánea

Creación de un cubo de Object Storage para almacenar archivos de instantánea 🔗

El repositorio para instantáneas es un cubo de Object Storage de su arrendamiento. Si no tiene un cubo para registrar como repositorio, debe crear un cubo. Para ver un tutorial que le guía por cómo crear un cubo, consulte Colocación de datos en Object Storage.

Tome nota de la siguiente información para el cubo que registrará como repositorio. Puede encontrar esta información en Detalles de cubo.

• Espacio de nombres
• Nombre del cubo
• OCID de compartimento

Para obtener el OCID de compartimento:

1. En la página Detalles del cubo, haga clic en el enlace del compartimento.
2. Haga clic en Copiar para OCID en Información de compartimento.

forceBucketCreation: true

Política de IAM 🔗

Debe configurar permisos para proporcionar al cluster OpenSearch acceso al cubo de su arrendamiento para almacenar los archivos de instantánea.

El siguiente ejemplo de política incluye los permisos necesarios:

DEFINE tenancy opensearch-tenancy as <OpenSearch_Tenancy_ID>
ADMIT resource opensearch opensearchsnapshots of tenancy opensearch-tenancy to manage object-family in compartment <snapshot_bucket_compartment> where ALL {request.principal.clusterid='<cluster_OCID>', request.principal.ownertenant='<customer_tenancy_OCID>', request.principal.ownercompartment='<customer_compartment_OCID>', target.bucket.name='<snapshot_bucket_name>'}

La política anterior solo permite registrar el cubo especificado como repositorio de instantáneas.

<OpenSearch_Tenancy_ID> es el OCID de OCI Search con el arrendamiento OpenSearch. Puede encontrar este valor en la página Detalles de cluster para el cluster en el campo OCID de arrendamiento de Opensearch en la sección Información adicional.

<customer_tenancy_OCID> es el OCID de su arrendamiento en el que ha creado el cluster OpenSearch.

<customer_compartment_OCID> es el OCID del compartimento donde se encuentra el cluster OpenSearch.

Si especifica forceBucketCreation : true en la operación de registro, debe asegurarse de que la política especificada incluye acceso de creación de cubo en su arrendamiento; de lo contrario, la operación para registrar el repositorio fallará.

Registro del Repositorio 🔗

Para poder tomar la instantánea, debe registrar el repositorio, como se muestra en el siguiente ejemplo:

PUT _snapshot/<repository_name>
{
  "type": "oci",
  "settings": {
    "client": "default",
    "endpoint": "<objectstorage_endpoint>",
    "bucket": "<bucket_name>",
    "namespace": "<namespace>",
    "authType": "RESOURCE_PRINCIPAL",
    "bucket_compartment_id": "<bucket_compartment_OCID>",
    "forceBucketCreation": true
  }
}

En la siguiente tabla se describen los parámetros que se deben especificar al registrar el repositorio.

Realizar instantánea 🔗

Una vez registrado el repositorio, puede realizar una instantánea, como se muestra en el siguiente ejemplo:

POST _snapshot/<repository_name>/<snapshot_name>?wait_for_completion=true

El ejemplo anterior incluye todos los índices y el estado del cluster. En el siguiente ejemplo se muestra cómo incluir índices específicos y otros valores:

POST _snapshot/<repository_name>/<snapshot_name>?wait_for_completion=true
{
"indices": "<index_name>,-<index_name>",
  "ignore_unavailable": true,
  "include_global_state": false
}

Puede especificar uno o más índices para incluir, <index_name_to_include> y uno o más índices para excluir, -<index_name_to_exclude>.

Para obtener más información sobre esta operación de API, consulte Realización de instantáneas.

Restaurar instantánea 🔗

Antes de restaurar una instantánea, puede recuperar todas las instantáneas existentes para un cluster. En primer lugar, recupere todos los repositorios registrados con el cluster, como se muestra en el siguiente ejemplo:

GET _snapshot/_all?pretty

A continuación, recupere todas las instantáneas del repositorio, como se muestra en el siguiente ejemplo:

GET _snapshot/<repository_name>?pretty

Ahora, restaure la instantánea, como se muestra en el siguiente ejemplo:

POST _snapshot/<repository_name>/<snapshot_name>/_restore
{
     "indices": "<index_name_to_include>,-<index_name_to_exclude>",
     "ignore_unavailable": true,
     "include_global_state": false,
     "rename_pattern": "(.+)",
     "rename_replacement": "restored_$1",
     "include_aliases": true
}

Puede especificar uno o más índices para incluir, <index_name_to_include> y uno o más índices para excluir, -<index_name_to_exclude>.

Para obtener más información sobre esta operación de API, consulte Restauración de instantáneas.