Documentação do Oracle Cloud Infrastructure

Criando um Cluster do Cache do OCI

Crie um cluster standalone, um cluster secundário para replicação entre regiões ou um cluster com base em um backup existente.

Cada cluster não fragmentado inclui um nó principal e, opcionalmente, um ou mais nós de dados, com base nas opções que você especifica ao criar o cluster.
Observação

Para fins de confiabilidade, recomendamos usar um cluster com pelo menos três nós. Clusters com um ou dois nós não são confiáveis.
Cada cluster com sharding consiste em pelo menos três shards, com cada shard contendo um nó principal e, opcionalmente, um a quatro nós de dados, dependendo da sua configuração. O número máximo de nós por cluster com sharding é 100. Para obter mais informações, consulte Clusters Fragmentados de Cache do OCI.

Um cluster secundário replica dados de um cluster principal em outra região da OCI. O cluster secundário aceita operações de leitura, mas não aceita operações de gravação enquanto participa de um relacionamento de replicação entre regiões. Para obter mais informações, consulte Replicação entre Regiões do Cache do OCI.

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

    A criação de um cluster do OCI Cache envolve as seguintes páginas:

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

    1. Tipo de criação

    Na página Tipo de criação, selecione como criar o cluster do OCI Cache de uma das seguintes maneiras:

    • Cluster de Cache do OCI: Crie um cluster standalone.
    • Cluster do OCI Cache com base em backup: Cria um cluster com base em um backup existente ou em um snapshot importado.
    • Cluster secundário: Crie um cluster que replique dados de um cluster principal em outra região.

    Para criar um cluster stand-alone, selecione Cluster de Cache do OCI e, em seguida, selecione Próximo.

    Para criar um cluster secundário, selecione Cluster secundário e especifique as seguintes informações:

    • Selecione a região que contém o cluster principal.
    • Selecione o compartimento que contém o cluster principal.
    • Na lista de clusters, selecione o cluster para replicação.

    O cluster principal deve estar no estado Ativo, não deve ter um cluster secundário e não deve ter outra operação em andamento.

    Observação

    Para criar um cluster secundário, você precisa de permissões para gerenciar o novo cluster secundário e executar operações de replicação no cluster principal selecionado. Para obter detalhes, consulte Políticas de IAM do Cache do OCI.

    Selecione Próximo.

    Para criar um cluster com base em um backup existente, consulte Restaurando um Cluster de Cache do OCI com Base em um Backup. Para criar um cluster importando um snapshot do serviço Object Storage, consulte Importando Backups.

    2. Configurar cluster

    Na página Configurar cluster, forneça as informações básicas do cluster:

    • Nome: Aceite o nome pré-preenchido ou informe um nome descritivo para o cluster.

      O nome do cluster pode incluir apenas letras, números, traços, pontos e sublinhados.

    • Create in compartment: Selecione o compartimento para o cluster.
    • Versão do mecanismo do OCI Cache: Selecione uma versão do mecanismo disponível.
      Observação

      Para um cluster secundário, a versão do mecanismo corresponde ao cluster principal e não pode ser alterada.
    • Selecionar configuração: Selecione uma configuração personalizada ou padrão para a versão do mecanismo selecionada. Se você não selecionar uma configuração, o OCI Cache aplicará a configuração padrão mais recente para a versão do mecanismo.

      Para um cluster secundário, selecione uma configuração personalizada que atenda aos requisitos de replicação entre regiões. Os conjuntos de configuração primária e secundária devem usar os mesmos valores para os parâmetros reserved-memory-percentage e maxmemory-policy. Se você definir databases como um valor diferente do padrão de 16, deverá usar o mesmo valor em ambos os conjuntos de configuração.

      Observação

      As configurações e os usuários da ACL não são copiados do cluster principal. Mantenha a configuração do cluster consistente entre os clusters principal e secundário.

      Como prática recomendada, use os mesmos usuários da ACL e mantenha permissões de ACL consistentes em ambos os clusters, quando possível. Isso simplifica o gerenciamento e ajuda a evitar problemas de autorização após uma alteração de função de cluster. Você pode usar diferentes usuários de ACL no cluster secundário, se exigido pelo seu aplicativo.

    Marcação com Tags

    (Opcional) Na seção Tags, adicione uma ou mais tags ao cluster. 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 tags posteriormente.

    Segurança de Roteamento de Pacotes de Confiança Zero

    (Opcional) Se sua tenancy e seu ambiente tiverem as permissões de Roteamento de Pacote de Confiança Zero para criar atributos de segurança para um cluster, você também poderá ter permissões para aplicar esses atributos a esse cluster. Para aplicar um atributo de segurança, você deve ter permissões para usar o namespace do atributo de segurança. Para obter mais informações sobre atributos de segurança e namespaces de atributo de segurança, consulte Roteamento de Pacote de Confiança Zero. Se você não tiver certeza se deseja aplicar atributos de segurança, ignore essa opção ou pergunte a um administrador. Você pode aplicar atributos de segurança posteriormente.

    Para aplicar atributos de segurança a um cluster, selecione Mostrar atributos de segurança e, em seguida, Adicionar atributo de segurança.

    Digite as seguintes informações:
    • Namespace de atributo de segurança: Selecione um namespace de atributo de segurança na lista. Esta lista contém esses namespaces de atributo de segurança já configurados. Consulte Criando um Namespace de Atributo de Segurança para obter mais informações.
    • Chave do atributo de segurança: Selecione uma chave na lista.
    • Valor do atributo de segurança: Selecione um valor para a chave correspondente na lista.

    Selecione o botão Adicionar atributo de segurança para adicionar outro atributo (no máximo três).

    Selecione Próximo.

    3. Configurar nós

    Na página Configurar nós, selecione o modo de cluster (sem sharding ou sharding) e configure as definições do nó do cluster.

    • Modo de cluster: Selecione um dos seguintes modos:
      • Não particionado: Um único nó principal e até quatro nós de réplica para desempenho confiável e suporte de backup manual ou sob demanda.
        Observação

        Para obter alta disponibilidade ideal, configure um cluster não fragmentado com um nó principal e dois nós de réplica.
      • Compartilhado: Distribua dados entre vários shards para aumentar a capacidade e acelerar o processamento. Os clusters fragmentados são ideais para conjuntos de dados grandes ou de alto tráfego.
      Observação

      Para um cluster secundário, o modo de cluster é definido como Não com sharding e não pode ser alterado.
    • Contagem de nós (Somente não particionado): Informe um valor de 1 a 5.
      Observação

      Você pode configurar outra contagem de nós para o cluster secundário.
    • Contagem de shards (somente no modo sharding): Informe um número ímpar entre 3 e 99.
    • Nós por shard (somente no modo sharded): Informe um valor de 1 a 5.
    • Memória (GB) por nó: Informe um valor de 2 a 500.
      Observação

      Para um cluster secundário, a memória por nó é definida para corresponder ao cluster principal e não pode ser alterada.

      Para replicação entre regiões, verifique se a memória por nó tem pelo menos 8 GB para os clusters principal e secundário.

    Uma contagem em execução na parte inferior da página exibe a contagem total de nós, a memória total (em gigabytes) e a largura de banda (em gigabits por segundo por nó). Esses números são atualizados à medida que você altera as configurações na página.

    Selecione Próximo.

    4. Configurar rede

    Na página Configurar rede, configure os recursos de rede para o cluster.

    Observação

    O OCI Cache gerencia a conectividade entre regiões privada para replicação. Não é necessário criar uma conexão de pareamento remoto.

    Você pode criar um cluster do OCI Cache em uma VCN e sub-rede que suportam IPv6. Para obter informações sobre como usar clusters do OCI Cache em IPv6, incluindo conectividade do cliente, comportamento do DNS do ponto final e requisitos de segurança de rede, consulte Suporte ao IPv6 para o OCI Cache.

    Nenhum parâmetro de solicitação do OCI Cache seleciona conectividade somente IPv4, somente IPv6 ou de pilha dupla. A disponibilidade de sub-rede e recurso selecionados determinam a conectividade suportada.

    VCN

    Selecione uma das seguintes opções para a VCN:

    • Selecionar rede virtual na nuvem existente: Selecione uma VCN no compartimento atual.
    • Novo nome de rede virtual na nuvem: Especifique as seguintes informações:
      • Novo nome de rede virtual na nuvem: Aceite o nome padrão ou informe um nome amigável para a nova VCN.
      • Create in compartment: Selecione o compartimento para a nova VCN.
    • Informar OCID da sub-rede: Digite o OCID da sub-rede desejada. A VCN é determinada automaticamente com base na sub-rede selecionada.

    Sub-rede

    As definições de sub-rede dependem da opção de VCN selecionada. Você não pode alterar a sub-rede do cluster após criar o cluster.

    Antes de criar o cluster, certifique-se de que a sub-rede selecionada tenha endereços IP livres suficientes disponíveis.

    • Para clusters não fragmentados, você precisa pelo menos da contagem de nós mais dois endereços adicionais (para o ponto final principal e o ponto final de leitura).
    • Para clusters com sharding, você precisa pelo menos da contagem de nós mais um endereço adicional (para o ponto final de descoberta).

    Selecione uma das seguintes opções de sub-rede:

    • Selecionar sub-rede existente: Selecione uma sub-rede no compartimento atual.
    • Criar nova sub-rede pública: Especifique as seguintes informações:
      • Criar nova sub-rede pública: Aceite o nome padrão ou informe um nome amigável para a sub-rede.
      • Criar no compartimento: Selecione o compartimento da sub-rede.
      • Bloco CIDR: Informe os endereços IP do bloco CIDR, por exemplo, 10.0.0.0/16, 209.128.0.0/10
    • Informar OCID da sub-rede: Informe o OCID da sub-rede que você deseja usar.

    Grupo de segurança de rede

    (Opcional) Adicione um ou mais grupos de segurança de rede (NSGs) disponíveis para a VCN selecionada. O NSG deve conter uma regra que permita o tráfego para a VNIC do cluster usando os protocolos e portas necessários. Para obter mais informações, consulte Regra de Segurança para Conexão com Clusters.

    Selecione Adicionar grupo de segurança de rede e selecione um NSG disponível no compartimento atual na lista.

    Selecione Próximo.

    5. Revisar e criar

    Na página Revisar e criar, revise suas configurações. Edite ou retorne às páginas anteriores para fazer alterações. Quando as definições estiverem corretas, selecione Criar cluster.

    O novo cluster aparece na página de lista Clusters.

    Se você selecionou Cluster secundário, a atribuição Secundário será atribuída ao novo cluster e a atribuição Principal será atribuída ao cluster de origem selecionado. A sincronização inicial começa. O cluster secundário é somente leitura e aceita apenas operações de leitura.

    Para verificar o cluster secundário, na página de detalhes do cluster, confirme se a atribuição do cluster é secundária, o cluster de origem é mostrado como o cluster principal associado e o cluster está no estado Ativo. A sincronização inicial é iniciada após a criação do cluster.

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

    oci redis redis-cluster redis-cluster create --compartment-id <compartment_OCID> --display-name <text> --node-count <node_count> --node-memory-in-gbs <memory in gigabytes> --software-version <text> --subnet-id <subnet_OCID> [OPTIONS]

    Para criar um cluster secundário:

    1. Crie uma configuração personalizada do OCI Cache que atenda aos requisitos de replicação entre regiões. Para obter mais informações, consulte Criando uma Configuração de Cache do OCI.
    2. Use o comando oci redis-cluster redis-cluster create. Especifique o cluster principal e a configuração personalizada a serem associados ao cluster secundário. 
    oci redis redis-cluster redis-cluster create \
  --compartment-id <compartment_OCID> \
  --display-name <text> \
  --oci-cache-config-set-id <config_set_OCID> \
  --primary-cluster-id <primary_cluster_OCID> \
  --cluster-mode NONSHARDED \
  --node-count <node_count> \
  --node-memory-in-gbs <memory_in_gigabytes> \
  --software-version <text> \
  --subnet-id <subnet_OCID> \
  [OPTIONS]
    Para obter informações sobre como usar a CLI, consulte Interface de Linha de Comando (CLI). Para obter uma lista completa de flags e opções disponíveis para comandos de CLI, consulte Referência de Comando de CLI
  • Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.

    Execute a operação CreateRedisCluster para criar um cluster.

    Para criar um cluster secundário:

    1. Crie um conjunto de configurações personalizado do OCI Cache que inclua os valores de replicação entre regiões necessários.
    2. Execute a operação CreateRedisCluster. Especifique o cluster principal e o conjunto de configurações personalizadas a serem associados ao cluster secundário.

  • Para criar um cluster como secundário:

    1. Crie uma configuração personalizada do OCI Cache que atenda aos requisitos de replicação entre regiões. Para obter mais informações, consulte Criando uma Configuração de Cache do OCI.
    2. Na configuração do recurso oci_redis_redis_cluster, especifique os parâmetros primary_cluster_id e oci_cache_config_set_id.

    Configuração de Amostra do Terraform

    resource "oci_redis_redis_cluster" "secondary_cluster" {
  # Required
  compartment_id     = var.compartment_id
  display_name       = var.redis_cluster_display_name
  node_count         = var.redis_cluster_node_count
  node_memory_in_gbs = var.redis_cluster_node_memory_in_gbs
  software_version   = var.redis_cluster_software_version
  subnet_id          = oci_core_subnet.test_subnet.id

  # Required for a secondary cluster
  primary_cluster_id      = var.primary_cluster_id
  oci_cache_config_set_id = var.oci_cache_config_set_id
}

    A configuração personalizada associada ao cluster secundário deve atender aos requisitos de replicação entre regiões e ter valores compatíveis com a configuração associada ao cluster principal. Para obter mais informações, consulte Considerações sobre Replicação entre Regiões.