Documentação do Oracle Cloud Infrastructure

OpenSearch Upgrades de Software do Cluster

Faça upgrade da versão de software de um cluster com um upgrade de software em linha.

Quando você cria um cluster, por padrão, ele se baseia na versão mais recente suportada do OpenSearch. Para clusters existentes que usam versões mais antigas, você pode fazer upgrade do cluster para usar a funcionalidade disponível na versão mais recente do OpenSearch usando o recurso de upgrade de software em linha.

Observe as seguintes limitações e considerações sobre atualizações em linha:

  • Depois que o processo de upgrade em linha for iniciado, não será possível interromper ou cancelar o processo. Recomendamos que você crie um backup do cluster. Você pode criar um backup usando a API de Snapshot ou usando o processo descrito em Criando um Backup de Cluster OpenSearch.
  • Você só pode fazer upgrade de um cluster para uma versão mais recente do software OpenSearch. Não é possível fazer downgrade para uma versão mais antiga do software OpenSearch.
  • Os nós e os índices OpenSearch são compatíveis com a versão principal anterior.
  • Para passar da pesquisa Elastic 6.8 para 2.x, primeiro atualize para OpenSearch 1.x. Em seguida, recrie seus índices usando a API Reindex. Por fim, atualize para 2.x.

Caminhos de Upgrade Suportados para Upgrade em Linha

Versão do Pré-upgrade Versão de Pós-Upgrade
2.3 2.11
2.11 2.15

Acesse a lista Clusters na Console para verificar se um cluster é elegível para um upgrade de software. Todos os clusters elegíveis para upgrade incluem o texto Upgrade na coluna Versão do software. Para obter instruções sobre como acessar a lista Clusters, consulte Listando Clusters OpenSearch.

    1. Na página de lista Clusters, localize o cluster com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o cluster, consulte Listando Clusters OpenSearch.
    2. No menu Ações do cluster, selecione Fazer Upgrade.
    3. No painel Fazer Upgrade, selecione uma das seguintes opções:
      • Fazer upgrade do cluster atual: Faz upgrade da versão deste cluster. Os upgrades de versão principal podem ter tempo de inatividade.
      • Criar um clone e aplicar upgrade ao clone: Use esse recurso para aplicar o upgrade a um clone para que você possa executar testes.
    4. Selecione a versão do software na lista Versões de software disponíveis. A versão atual é exibida inicialmente.
    5. Selecione Upgrade.

  • Use o comando oci opensearch cluster upgrade e os parâmetros necessários para executar um upgrade em linha (versão de build menor) para um cluster. Configure o parâmetro is-clone como false ou true para especificar se você está fazendo upgrade do cluster atual ou se está criando um clone do cluster e se está aplicando o upgrade ao clone.

    Execute o seguinte comando para fazer upgrade do cluster atual:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type MINOR --is-clone false [OPTIONS]

    Execute o seguinte comando para criar um clone e aplicar o upgrade ao clone:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type MINOR --is-clone true [OPTIONS]

    O parâmetro original_cluster_display_name é necessário para validar se o ID do cluster tem o mesmo nome para exibição.

    O valor do upgrade-type deve ser MINOR.

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação UpgradeOpenSearchCluster para executar um upgrade de software em linha para um cluster. Configure o upgradeType como Secundário.