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
| 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
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| metadata | Sim | Metadados de atualização. | |
| spec | Sim | UpgradeSpec object | Configurações de atualização. |
| 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. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| clusterUpgradeAction | Não | ClusterUpgradeAction object | Configurações de upgrade do cluster. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| metadata | Metadados da tarefa de atualização | |
| spec | UpgradeResponseSpec object | Configurações de atualização |
| 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. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| clusterUpgradeAction | ClusterUpgradeResponseAction object | Configurações de atualização do cluster |
| 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 |
| 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. |
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" : { }
}
}
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | Atualização de cluster solicitada. |
Códigos de erro
Consulte Códigos de erro.
