Importando um Cluster OpenSearch Externo

Você pode trazer clusters existentes de suas instalações externas do OpenSearch para o Oracle Cloud Infrastructure. Isso permite que você aproveite os recursos de serviço gerenciado fornecidos pela Pesquisa com o OpenSearch.

Este tópico descreve o processo para trazer seus clusters OpenSearch existentes para o Oracle Cloud Infrastructure e inclui as seguintes tarefas:

Faça um snapshot do cluster.
Fazer upload do snapshot para o Object Storage.
Crie o cluster de destino em Pesquisar com OpenSearch.
Configure uma política dinâmica com as permissões necessárias.
Registre o repositório.
Restaurar o snapshot.

Pré-requisitos

Antes de continuar com as etapas descritas neste tópico, você precisa de uma tenancy na qual possa trabalhar. A conta de usuário que você usa para fazer log-in na tenancy requer acesso suficiente para configurar permissões de serviço e usuário para serviços e recursos do Oracle Cloud Infrastructure. Se você precisar de mais informações sobre como começar a usar o Oracle Cloud Infrastructure, consulte os seguintes recursos:

Para concluir esses procedimentos, você precisa de acesso para criar um bucket do serviço Object Storage e fazer upload de um arquivo para o bucket. Se você precisar configurar essas permissões para um usuário específico, consulte exemplos de políticas em Permitir que os administradores do serviço Object Storage gerenciem buckets e objetos e Permitir que os usuários gravem objetos em buckets do serviço Object Storage.

Você também precisa configurar o serviço e as permissões de usuário necessárias para criar clusters OpenSearch.

O exemplo de política a seguir inclui as permissões necessárias:

Allow service opensearch to manage vnics in compartment <YOUR_COMPARTMENT>
Allow service opensearch to manage vcns in compartment <YOUR_COMPARTMENT>
Allow service opensearch to use subnets in compartment <YOUR_COMPARTMENT>
Allow service opensearch to use network-security-groups in compartment <YOUR_COMPARTMENT>
Allow <YOUR_USER> to manage opensearch-family in compartment <YOUR_COMPARTMENT>

As permissões de serviço incluídas neste exemplo são necessárias conforme especificado. Você pode configurar as permissões do usuário, especificadas na última linha deste exemplo, com mais granularidade, encontrar exemplos de instrução de política demonstrando isso em Políticas de Amostra.

Efetuar um Snapshot do Cluster

Gere um snapshot do seu cluster com base na sua instalação externa do OpenSearch. Consulte OpenSearch - Tirar e restaurar snapshots para obter uma visão geral de snapshots de cluster e como gerá-los.

Fazer Upload do Snapshot para o Bucket do Object Storage

Depois que o snapshot for gerado, faça upload do arquivo de snapshot para um bucket do serviço Object Storage em sua tenancy. Para obter um tutorial que o orienta sobre como criar um bucket e fazer upload de arquivos para o bucket, consulte Colocando Dados no Serviço Object Storage.

Anote as informações a seguir do bucket para o qual você fez upload do snapshot. Você pode encontrar essas informações na página Detalhes do Bucket na Console.

Namespace
Nome do compartimento
Nome do bucket
Nome do repositório
Nome do arquivo de snapshot

Anote também o OCID do compartimento.

Para obter o OCID do compartimento:

Na página Detalhes do Bucket, clique no link para Compartimento em Informações do Cluster.
Clique em Copiar para OCID em Informações do Compartimento.

Criar Cluster de Destino

Para que o snapshot da sua instalação externa do OpenSearch possa ser importado para o Oracle Cloud Infrastructure, crie um cluster do OpenSearch em Pesquisar com OpenSearch. Este cluster será o cluster de destino para o qual o snapshot foi importado.

Consulte Criando um Cluster OpenSearch para obter um procedimento passo a passo que descreve como criar o cluster, incluindo os pré-requisitos necessários.

Importante

Ao criar o cluster, certifique-se de configurar o cluster com a mesma configuração de nó do cluster de origem para o qual você está importando o snapshot.

Anote as seguintes informações para o cluster:

OCID
Nome do compartimento

Você pode encontrar essas informações na Console na página Detalhes do Cluster. Consulte Obtendo Detalhes de um Cluster OpenSearch. Anote também o OCID do compartimento.

Para obter o OCID do compartimento:

Na página Detalhes do Cluster, clique no link para Compartimento em Informações do Cluster>.
Clique em Copiar para OCID em Informações do Compartimento.

Política do Serviço IAM

Você precisa configurar permissões para fornecer ao cluster OpenSearch acesso ao bucket do Object Storage em sua tenancy.

O exemplo de política a seguir inclui as permissões necessárias:

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>'}

<OpenSearch_Tenancy_ID> é o OCID da Pesquisa do OCI com a tenancy OpenSearch. Você pode encontrar esse valor na página Detalhes do cluster do seu cluster no campo OCID da Tenancy dopensearch na seção Informações Adicionais.

<customer_tenancy_OCID> é o OCID da sua tenancy em que você criou o cluster OpenSearch.

<customer_compartment_OCID> é o OCID do compartimento no qual o cluster OpenSearch está localizado.

Registrar o Repositório

Registre o repositório, conforme mostrado no seguinte exemplo:

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
   }
}

A tabela a seguir descreve os parâmetros a serem especificados quando você registra o repositório.


Parâmetro	Descrição
nome do repositório	O nome que você atribui ao repositório para o snapshot.
ponto final	O ponto final do bucket do Object Storage. Por exemplo, o ponto final do Object Storage da região Leste dos EUA (Ashburn) é https://objectstorage.us-ashburn-1.oraclecloud.com.
espaço de nome	O namespace do serviço Object Storage para o bucket.
authType	Especifique para usar o controlador de recursos que permite que a Pesquisa com OpenSearch funcione em seu nome.
bucket_compartment_id	O OCID do compartimento no qual o bucket está localizado.
forceBucketCreation	Especifica a criação do bucket do Object Storage se ele ainda não existir. O padrão é falso.

Restaurar Snapshot

Antes de restaurar um snapshot, você pode recuperar todos os snapshots existentes de um cluster. Primeiro, recupere todos os repositórios registrados no cluster, conforme mostrado no seguinte exemplo:

GET _snapshot/_all?pretty

Em seguida, recupere todos os instantâneos no repositório, conforme mostrado no exemplo a seguir:

GET _snapshot/<repository_name>?pretty

Agora, restaure o instantâneo, conforme mostrado no seguinte exemplo:

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
}

Você pode especificar um ou mais índices para incluir, <index_name_to_include> e um ou mais índices para excluir, -<index_name_to_exclude>.

Para obter mais informações sobre essa operação de API, consulte Restaurar snapshots.

Documentação do Oracle Cloud Infrastructure