Documentação do Oracle Cloud Infrastructure

Criando um Cluster OpenSearch

Crie um cluster OpenSearch para estabelecer o conjunto de instâncias do serviço Compute que fornecem a funcionalidade OpenSearch.

Quando você cria um cluster OpenSearch, Pesquisar com OpenSearch cria o conjunto de instâncias do serviço Compute que fornecem a funcionalidade OpenSearch. Cada cluster é composto por um ou mais nós de dados, nós de líderes e nós do Painel de Controle OpenSearch, com base nas opções que você especifica ao criar o cluster.

  • Na página da lista Clusters, selecione Criar cluster de carga. Se precisar de ajuda para localizar a página de lista, consulte Listando Clusters.

    A criação de um cluster OpenSearch consiste nas seguintes páginas:

    • 1. Configurar cluster
    • 2. Configurar a segurança
    • 3. Configurar nós
    • 4. Configurar rede
    • 5. Etapa de avaliação

    Execute cada um dos seguintes workflows pela ordem. Você pode retornar a uma página anterior, selecionando Anterior.

    1. Configurar cluster

    A página Configurar cluster é onde você fornece as informações básicas de configuração do cluster.

    Digite as seguintes informações:

    • Nome: Aceite o nome padrão ou informe um nome amigável para o cluster.
    • Criar no compartimento: Selecione na lista o compartimento no qual o cluster reside.
    • Versão do software: Selecione a versão do software na lista.
    • Namespace de tag: (Opcional) Informe informações de tag. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar as tags posteriormente.

    Contato

    O contato especificado recebe notificações operacionais e anúncios relativos ao cluster.

    • E-mail de contato: Informe o endereço do e-mail do contato.

    Marcação com Tags

    Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar as tags posteriormente.

    Selecione Próximo.

    2. Configurar a segurança

    A página Configurar segurança é onde você informa as credenciais de acesso da conta principal do cluster.

    Você usa essa conta para estabelecer conexão com o cluster e o Painel de Controle OpenSearch do cluster. Em seguida, você pode configurar outros usuários e atribuições para o cluster. Para obter mais informações, consulte Controle de Acesso Baseado na Atribuição na Pesquisa com OpenSearch.

    • Nome do Usuário: Informe o nome do usuário.
    • Senha: Informe a sua senha.
    • Confirmar senha: Informe novamente sua senha. Ela deve corresponder à senha informada anteriormente.

    Selecione Próximo.

    3. Configurar nós

    A página Configurar nós é onde você seleciona a opção de otimização de nó apropriada para seu cenário.

    Perfis de otimização de nó

    Selecione um dos seguintes tipos de nó. Revise suas descrições na Console para decidir qual tipo de nó é melhor para suas necessidades:

    • Desenvolvimento:
    • Pesquisa do Aplicativo:
    • Log Analytics:

    Depois de selecionar o tipo de nó, configure o nó. A pesquisa com OpenSearch aplica definições padrão, dependendo do tipo de nó selecionado. Mas você pode atualizar qualquer configuração conforme necessário.

    Configuração do nó líder

    Digite as seguintes informações:

    • Forma: Selecione na lista a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.
    • Nós de líderes dedicados: Informe o número de nós de líderes dedicados. O valor deve estar entre 1 e 3.
    • Contagem de OCPUs do nó do líder: Informe o número de OCPUs do nó do líder. O valor deve estar entre 1 e 32.
    • Memória do nó do líder (GB): Informe a quantidade de memória dos nós do líder em gigabytes. O valor deve estar entre 20 e 1024.

    Configuração do nó de dados

    Digite as seguintes informações:

    • Forma: Selecione na lista a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.
    • Nós de dados dedicados: Informe o número de nós de dados dedicados. O valor deve estar entre 1 e 10.
    • Contagem de OCPUs do nó de dados: Informe o número de OCPUs do nó de dados. O valor deve estar entre 1 e 32.
    • Memória do nó de dados (GB): Informe a quantidade de memória dos nós de dados em gigabytes. O valor deve estar entre 20 e 1024.
    • Armazenamento de nós de dados (GB): Informe o volume de armazenamento dos nós de dados em gigabytes. O valor deve estar entre 50 e 314572.

    Configurar Painéis de Controle OpenSearch

    Digite as seguintes informações:

    • Forma: Selecione na lista a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.
    • OpenSearch Nós do painel: Informe o número de nós do painel. O valor deve estar entre 1 e 3.
    • OpenSearch Contagem de OCPUs do nó do painel de controle: Informe o número de OCPUs do nó do Painel de Controle. O valor deve estar entre 1 e 32.
    • OpenSearch Memória do nó do painel (GB): Informe o volume de memória dos nós do Painel em gigabytes. O valor deve estar entre 8 e 1024.

    Selecione Próximo.

    4. Configurando a Rede

    A página Configurar rede é onde se especifica a VCN (rede virtual na nuvem) e a sub-rede para o cluster. Decida se deseja usar uma VCN e sub-rede existentes, criar uma nova VCN ou sub-rede ou especificar o OCID para uma sub-rede existente.

    Rede

    Selecione uma das seguintes opções de rede e, em seguida, conclua suas configurações:

    • Selecionar rede virtual na nuvem existente. Digite as seguintes informações:
      • Rede virtual na nuvem no <compartment>: Selecione uma das VCNs na lista no compartimento especificado.
    • Criar rede virtual na nuvem. Digite as seguintes informações:
      • Criar rede virtual na nuvem: Aceite o nome padrão ou digite um nome amigável para a VCN que você está criando.
      • Criar no compartimento: Selecione na lista o compartimento no qual a VCN reside.
        Observação

        Se você decidir criar uma nova VCN, também deverá criar uma nova sub-rede para ela. Você não pode designar uma sub-rede existente a uma VCN recém-criada.

    Sub-rede

    Uma sub-rede dentro da rede na nuvem para a qual a instância está anexada. As sub-redES são públicas ou privadas. Privado significa que as instâncias nessa sub-rede não podem ter endereços IP públicos. Para obter mais informações, consulte Acesso à Internet.

    As sub-redes também podem ser específicas do domínio de disponibilidade ou regionais. Os regionais têm "regional" após o nome. Recomendamos o uso de sub-redes regionais. Para obter mais informações, consulte Sobre Sub-redes Regionais.

    Selecione uma das seguintes opções de sub-rede e conclua suas configurações:

    • Selecionar sub-rede existente. Digite as seguintes informações:
      • Sub-rede no <compartment>: Selecione uma das sub-redes da lista no compartimento especificado.
        Observação

        Você não pode designar uma sub-rede existente a uma VCN recém-criada. Você deve criar uma nova sub-rede para ela.
    • Criar sub-rede pública. Digite as seguintes informações:
      • Novo nome de sub-rede: Aceite o nome padrão ou informe um nome amigável para a sub-rede que você está criando.
      • Criar no compartimento: Selecione na lista o compartimento no qual a sub-rede reside.
      • CIDR: Informe um único bloco CIDR contíguo para a sub-rede (por exemplo, 172.16.0.0/24). Certifique-se de que ela esteja dentro do bloco CIDR da rede na nuvem e não se sobreponha a outras sub-redes. Você não pode alterar esse valor posteriormente. Consulte Tamanho e Faixas de Endereço da VCN Permitidos e esta calculadora CIDR.

    Selecione Próximo.

    5. Etapa de revisão

    Verifique o conteúdo da página Etapa de revisão. Selecione Anterior para retornar às telas anteriores para adicionar ou alterar informações. Quando as definições forem totalmente verificadas, selecione Criar cluster.

    O cluster OpenSearch criado aparece na página de lista Clusters.

  • Use o comando oci opensearch cluster create e os parâmetros necessários para criar um cluster:

    oci opensearch cluster create --compartment-id compartment_ocid --data-node-host-shape data_node_host_shape --data-node-count data_node_count 
--data-node-host-memory-gb data_node_host_memory_gb --data-node-host-ocpu-count data_node_host_ocpu_count --data-node-host-type BM|FLEX
--data-node-storage-gb data_node_storage_gb--display-name display_name --master-node-host-shape master_node_host_shape --master-node-count master_node_count 
--master-node-host-memory-gb master_node_host_memory_gb --master-node-host-ocpu-count master_node_host_ocpu_count --master-node-host-type BM|FLEX 
--opendashboard-node-host-shape opendashboard_node_host_shape --opendashboard-node-count opendashboard_node_count --opendashboard-node-host-memory-gb opendashboard_node_host_memory_gb 
--opendashboard-node-host-ocpu-count opendashboard_node_host_ocpu_count --search-node-host-shape search_node_host_shape --search-node-count search_node_count
--search-node-host-ocpu-count search_node_host_ocpu_count --search-node-host-memory-gb search_node_host_memory_gb --search-node-host-type FLEX 
--search-node-storage-gb search_node_storage_gb --software-version software_version --subnet-compartment-id subnet_compartment_ocid 
--subnet-id subnet_ocid --vcn-compartment-id vcn_compartment_ocid --vcn-id vcn_ocid [OPTIONS]

    em que as seguintes variáveis são:

    display_name: Informe um nome amigável para o cluster.

    compartment_ocid: Informe o OCID do compartimento no qual o cluster reside.

    software_version: Informe a versão do software do cluster.

    data_node_host_shape: Informe a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.

    data_node_count: Informe o número de nós de dados dedicados. O valor deve estar entre 1 e 10.

    data_node_host_ocpu_count: Informe o número de OCPUs do nó de dados. O valor deve estar entre 1 e 32.

    data_node_host_memory_gb: Informe o volume de memória dos nós de dados em gigabytes. O valor deve estar entre 20 e 1024.

    data_node_host_type: Informe o tipo de host do nó de dados. Os valores aceitos são: BM ou FLEX.

    data_node_storage_gb: Informe o volume de armazenamento dos nós de dados em gigabytes. O valor deve estar entre 50 e 314572.

    master_node_host_shape: Informe a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.

    master_node_count: Informe o número de nós principais dedicados. O valor deve estar entre 1 e 3.

    master_node_host_ocpu_count: Informe o número de OCPUs do nó mestre. O valor deve estar entre 1 e 32.

    master-node-host-type: Informe o tipo de host do nó mestre. Os valores aceitos são: BM ou FLEX.

    master_node_host_memory_gb: Informe a quantidade de memória dos nós principais em gigabytes. O valor deve estar entre 20 e 1024.

    opendashboard_node_host_shape: Informe a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.

    opendashboard_node_count: Informe o número de nós do Painel de Controle. O valor deve estar entre 1 e 3.

    opendashboard_node_host_ocpu_count: Informe o número de OCPUs do nó do Painel de Controle. O valor deve estar entre 1 e 32.

    opendashboard_node_host_memory_gb: Informe a quantidade de memória dos nós do Painel de Controle em gigabytes. O valor deve estar entre 8 e 1024.

    search_node_host_shape: Informe a forma de Computação desejada. As formas disponíveis para você podem variar dependendo da sua região e domínio.

    search_node_count: Informe o número de nós de pesquisa dedicados. Recomendamos especificar 20% a 40% dos seus nós de dados como nós de pesquisa.

    search_node_host_ocpu_count: Informe o número de OCPUs do nó de pesquisa. O valor deve estar entre 1 e 126.

    search_node_host_memory_gb: Informe a quantidade de memória para os nós de pesquisa em gigabytes. O valor deve estar entre 20 e 1024.

    search_node_storage_gb: Informe o volume de armazenamento dos nós de pesquisa em gigabytes. O valor deve estar entre 50 e 32768.

    vcn_ocid: Informe o OCID da VCN do cluster.

    vcn_compartment_ocid: Informe o OCID do compartimento no qual reside a VCN do cluster.

    subnet_compartment_ocid: Informe o OCID do compartimento no qual reside a sub-rede do cluster.

    subnet_ocid: Informe o OCID da sub-rede do cluster.

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

    Gerando uma Hash de Senha

    Se você estiver incluindo o parâmetro security-master-user-password-hash opcional a ser usado com o parâmetro security-master-user-name opcional, será necessário gerar o hash de senha:

    1. Faça download do seguinte arquivo: oci-crypto-common-1.0.0-SNAPSHOT.jar
    2. Abra um prompt de comando e execute o seguinte comando: java -jar oci-crypto-common-1.0.0-SNAPSHOT.jar pbkdf2_stretch_1000 <password-in-plain-text>

      em que <password-in-plain-text> é uma senha de sua escolha.

      É necessário ter o Java instalado no computador antes de executar esse comando.

    3. Registre o hash de senha gerado.
    4. Inclua o hash de senha gerado como o valor do parâmetro security-master-user-password-hash. Use aspas simples ao redor da senha. Por exemplo:
      oci opensearch cluster create ... --security-master-user-name MyUser --security-master-user-password-hash 'pbkdf2_...MNUT5No='

  • Execute a operação CreateOpensearchCluster para criar um cluster.