Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Cloud Container Engine/ Referência de API/ APIs/ Atualização de cluster/ Atualização de um cluster

Atualizado em 2024-09-10 GMT+08:00

Ver PDF

Atualização de um cluster

Função

Atualização do cluster

A atualização de cluster envolve muitas operações em componentes. Recomendamos que você atualize seu cluster no console do CCE, uma maneira mais interativa e intuitiva de reduzir os riscos operacionais.
Atualmente, as APIs de atualização de cluster estão disponíveis apenas mediante solicitação.

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.
cluster_id	Sim	String	ID do cluster. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.

Parâmetros de solicitação

**Tabela 2** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
metadata	Sim	UpgradeClusterRequestMetadata object	Metadados de atualização.
spec	Sim	UpgradeSpec object	Configurações de atualização.

**Tabela 3** UpgradeClusterRequestMetadata
Parâmetro	Obrigatório	Tipo	Descrição
apiVersion	Sim	String	Versão da API. O padrão é v3.
kind	Sim	String	Tipo de recurso. O padrão é UpgradeTask.

**Tabela 4** UpgradeSpec
Parâmetro	Obrigatório	Tipo	Descrição
clusterUpgradeAction	Não	ClusterUpgradeAction object	Configurações de upgrade do cluster.

**Tabela 5** ClusterUpgradeAction
Parâmetro	Obrigatório	Tipo	Descrição
addons	Não	Array of UpgradeAddonConfig objects	Lista de configuração de complementos.
nodeOrder	Não	Map<String,Array<NodePriority>>	Sequência de atualização de nós no pool de nós. NOTA: key indica o ID do pool de nós. O padrão é DefaultPool.
nodePoolOrder	Não	Map<String,Integer>	Sequência de atualização de um pool de nós, em pares chave-valor. NOTA: key indica o ID do pool de nós. O padrão é DefaultPool. value significa a prioridade de um pool de nós. O padrão é 0, indicando a prioridade mais baixa. Um valor maior indica uma prioridade mais alta.
strategy	Sim	UpgradeStrategy object	Política de atualização.
targetVersion	Sim	String	Versão do cluster de destino, por exemplo, v1.23.

**Tabela 6** UpgradeAddonConfig
Parâmetro	Obrigatório	Tipo	Descrição
addonTemplateName	Sim	String	Nome do complemento.
operation	Sim	String	Ação de execução. Para atualizações atuais, o valor pode ser patch.
version	Sim	String	Versão de complemento alvo.
values	Não	Object	Lista de parâmetros de complemento, em pares chave-valor.

**Tabela 7** NodePriority
Parâmetro	Obrigatório	Tipo	Descrição
nodeSelector	Sim	NodeSelector object	Seletor de rótulo de nó, que seleciona um lote de nós.
priority	Sim	Integer	Prioridade deste lote de nós. O padrão é 0, indicando a prioridade mais baixa. Um valor maior indica uma prioridade mais alta.

**Tabela 8** NodeSelector
Parâmetro	Obrigatório	Tipo	Descrição
key	Sim	String	Chave de rótulo.
value	Não	Array of strings	Lista de valores do rótulo.
operator	Sim	String	Operadores lógicos de rótulos.

**Tabela 9** UpgradeStrategy
Parâmetro	Obrigatório	Tipo	Descrição
type	Sim	String	Tipo de política de atualização. Suporta apenas inPlaceRollingUpdate.
inPlaceRollingUpdate	Não	InPlaceRollingUpdate object	Configurações de atualização no local. Obrigatório quando o tipo de política de atualização in-loco é especificado.

**Tabela 10** InPlaceRollingUpdate
Parâmetro	Obrigatório	Tipo	Descrição
userDefinedStep	Não	Integer	Etapa de atualização do nó, de 1 a 40. Recomendado: 20.

Parâmetros de resposta

Código de status: 200

**Tabela 11** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
metadata	UpgradeCluserResponseMetadata object	Metadados da tarefa de atualização
spec	UpgradeResponseSpec object	Configurações de atualização

**Tabela 12** UpgradeCluserResponseMetadata
Parâmetro	Tipo	Descrição
uid	String	ID da tarefa de atualização. Você pode obter o andamento chamando a API para obter detalhes da tarefa de atualização de cluster.

**Tabela 13** UpgradeResponseSpec
Parâmetro	Tipo	Descrição
clusterUpgradeAction	ClusterUpgradeResponseAction object	Configurações de atualização do cluster

**Tabela 14** ClusterUpgradeResponseAction
Parâmetro	Tipo	Descrição
version	String	Versão atual do cluster
targetVersion	String	Versão do cluster de destino, por exemplo, v1.23.
targetPlatformVersion	String	Versão da plataforma do cluster de destino, que é uma versão interna da versão do cluster e não pode ser especificada.
strategy	UpgradeStrategy object	Políticas de atualização
config	Object	Configuração de cluster especificada durante uma atualização

**Tabela 15** UpgradeStrategy
Parâmetro	Tipo	Descrição
type	String	Tipo de política de atualização. Suporta apenas inPlaceRollingUpdate.
inPlaceRollingUpdate	InPlaceRollingUpdate object	Configurações de atualização no local. Obrigatório quando o tipo de política de atualização in-loco é especificado.

**Tabela 16** InPlaceRollingUpdate
Parâmetro	Tipo	Descrição
userDefinedStep	Integer	Etapa de atualização do nó, de 1 a 40. Recomendado: 20.

Exemplo de solicitações

Atualize o cluster para v1.23 e defina a etapa de atualização do nó como 20.

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/operation/upgrade

{
  "metadata" : {
    "apiVersion" : "v3",
    "kind" : "UpgradeTask"
  },
  "spec" : {
    "clusterUpgradeAction" : {
      "strategy" : {
        "type" : "inPlaceRollingUpdate",
        "inPlaceRollingUpdate" : {
          "userDefinedStep" : 20
        }
      },
      "targetVersion" : "v1.23"
    }
  }
}

Exemplo de respostas

Código de status: 200

Atualização de cluster solicitada.

{
  "metadata" : {
    "uid" : "976a33e2-f545-11ed-87af-0255ac1002c2"
  },
  "spec" : {
    "clusterUpgradeAction" : {
      "version" : "v1.19.16-r20",
      "targetVersion" : "v1.23.8-r0",
      "targetPlatformVersion" : "cce.10",
      "strategy" : {
        "type" : "inPlaceRollingUpdate",
        "inPlaceRollingUpdate" : {
          "userDefinedStep" : 20
        }
      },
      "config" : { }
    }
  }
}