Modificare le risorse durante il ripristino (non più supportato)

Questa pagina descrive come apportare modifiche alle risorse Kubernetes durante il processo di ripristino.

Panoramica

Esistono diversi motivi per cui potresti voler modificare le risorse Kubernetes nell'ambito del processo di ripristino. Ad esempio:

  • Ti consigliamo di eseguire il provisioning dei PVC utilizzando un provisioning storage diverso (ad esempio, passare dal driver in-tree di Kubernetes al driver CSI).

  • Potresti voler ripristinare uno spazio dei nomi con un nome diverso.

  • Potresti voler modificare il numero di repliche in un deployment o in un StatefulSet.

Backup per GKE fornisce un meccanismo per farlo chiamato regole di sostituzione, che puoi facoltativamente definire all'interno di un RestorePlan.

Una regola di sostituzione è un insieme di criteri di corrispondenza specificati insieme a un valore del campo di sostituzione. Puoi utilizzare le regole di sostituzione nella procedura di ripristino come segue:

  1. Innanzitutto, Backup per GKE calcola l'insieme di risorse da ripristinare in base ai parametri di ambito nella configurazione del ripristino (ad esempio, spazi dei nomi, gruppi/tipi e così via).

  2. Backup per GKE valuta ogni risorsa selezionata per il ripristino in base all'elenco ordinato delle regole di sostituzione. Se una regola corrisponde alla risorsa, la risorsa viene aggiornata con il valore del campo sostituito. Tutte le risorse vengono confrontate con tutte le regole e alla stessa risorsa potrebbero essere applicate più sostituzioni.

  3. Dopo aver valutato tutte le regole, Backup per GKE crea il insieme risultante di risorse nel cluster di destinazione.

Parametri delle regole di sostituzione

Per definire una regola di sostituzione, fornisci i seguenti parametri:

Parametro Obbligatorio Descrizione
targetNamespaces facoltativo Questo è un elenco di spazi dei nomi. Affinché una risorsa corrisponda a questa regola, deve essere una risorsa con spazio dei nomi e avere uno degli spazi dei nomi specificati:
  • Se non viene fornito nulla per questo parametro, verranno corrisposte tutte le risorse (tutte le risorse con spazio dei nomi e con ambito cluster).
  • Se viene fornita una stringa vuota (""), verrà trovata una corrispondenza solo per le risorse basate su cluster. Nella console Google Cloud , puoi selezionare Escludi risorse con nome nello spazio dei nomi per impostare l'elenco su una singola stringa vuota.
targetGroupKinds facoltativo Questo è un elenco di tuple di gruppi/tipi di risorse Kubernetes:
  • Se non viene fornito nulla per questo parametro, tutte le risorse corrisponderanno (nessuna limitazione in base a gruppo/tipo).
  • Se vengono forniti uno o più gruppi/tipi, le risorse devono corrispondere a uno di questi per soddisfare la regola.
targetJsonPath di provisioning. Si tratta di un'espressione JSONPath che viene associata alle risorse. Tieni presente che questa regola non corrisponde solo alla risorsa, ma anche a un attributo specifico al suo interno.
originalValuePattern facoltativo Si tratta di un'espressione regolare che viene confrontata con il valore corrente dell'attributo. Se non viene fornito, l'attributo corrisponderà sempre.
newValue di provisioning. Si tratta del nuovo valore da utilizzare per il valore dell'attributo corrispondente.

Per scoprire di più sulla definizione delle regole di sostituzione nella console Google Cloud , consulta Pianificare un insieme di ripristini.

Per definire le regole di sostituzione utilizzando la gcloud CLI, crea un file contenente un array YAML di regole di sostituzione e includi il parametro --substitution-rules-file= nel comando gcloud beta container backup-restore restore-plans create.

Esempi di regole di sostituzione

I seguenti esempi sono forniti nel formato YAML utilizzato dalla gcloud CLI.

Modificare StorageClass

In questo esempio, modifichiamo la classe di archiviazione in tutte le risorse PersistentVolumeClaim ripristinate da standard a premium-rwo:

substitutionRules:
- targetGroupKinds:
  - resourceGroup: ''
    resourceKind: PersistentVolumeClaim
  targetJsonPath: "{..storageClassName}"
  originalValuePattern: standard
  newValue: premium-rwo

Clona spazio dei nomi

In questo esempio, cloniamo uno spazio dei nomi da alpha a beta, creando un nuovo spazio dei nomi "beta" e ripristinando tutte le risorse da "alpha" nel nuovo spazio dei nomi "beta". Tieni presente che questi esempi richiedono due regole di sostituzione: una per lo spazio dei nomi stesso e una per le risorse all'interno dello spazio dei nomi.

substitutionRules:
- targetNamespaces:
  - ''
  targetGroupKinds:
  - resourceGroup: ''
    resourceKind: Namespace
  targetJsonPath: "{.metadata.name}"
  originalValuePattern: alpha
  newValue: beta
- targetNamespaces:
  - alpha
  targetJsonPath: "{.metadata.namespace}"
  originalValuePattern: alpha
  newValue: beta

Modificare StorageClass e il numero di repliche in uno spazio dei nomi clonato

In questo esempio, cloniamo uno spazio dei nomi e poi applichiamo un insieme di modifiche alle risorse nel nuovo spazio dei nomi:

  • Modifica StorageClass sui PVC da standard a premium-rwo

  • Modifica il numero di repliche nei deployment da 7 a 3

substitutionRules:
- targetNamespaces:
  - ''
  targetGroupKinds:
  - resourceGroup: ''
    resourceKind: Namespace
  targetJsonPath: "{.metadata.name}"
  originalValuePattern: alpha
  newValue: beta
- targetNamespaces:
  - alpha
  targetJsonPath: "{.metadata.namespace}"
  originalValuePattern: alpha
  newValue: beta
- targetNamespaces:
  - beta
  targetGroupKinds:
  - resourceGroup: ''
    resourceKind: PersistentVolumeClaim
  targetJsonPath: "{..storageClassName}"
  originalValuePattern: standard
  newValue: premium-rwo
- targetNamespaces:
  - beta
  targetGroupKinds:
  - resourceGroup: apps
    resourceKind: Deployment
  targetJsonPath: "{$.spec.replicas}"
  originalValuePattern: '7'
  newValue: '3'