Sauvegarde et restauration

1. Créez une charge de travail pour sauvegarder en exécutant les commandes suivantes:

   $ oc create namespace hello-world

   $ oc new-app -n hello-world --image=docker.io/openshift/hello-openshift

2. Exposez l’itinéraire en exécutant la commande suivante:

   $ oc expose service/hello-openshift -n hello-world

3. Assurez-vous que l’application fonctionne en exécutant la commande suivante:

   $ curl `oc get route/hello-openshift -n hello-world -o jsonpath='{.spec.host}'`

   Exemple de sortie

   Hello OpenShift!

4. Sauvegardez la charge de travail en exécutant la commande suivante:

   $ cat << EOF | oc create -f -
     apiVersion: velero.io/v1
     kind: Backup
     metadata:
       name: hello-world
       namespace: openshift-adp
     spec:
       includedNamespaces:
       - hello-world
       storageLocation: ${CLUSTER_NAME}-dpa-1
       ttl: 720h0m0s
   EOF

5. Attendez que la sauvegarde soit terminée, puis exécutez la commande suivante:

   $ watch "oc -n openshift-adp get backup hello-world -o json | jq .status"

   Exemple de sortie

   {
     "completionTimestamp": "2022-09-07T22:20:44Z",
     "expiration": "2022-10-07T22:20:22Z",
     "formatVersion": "1.1.0",
     "phase": "Completed",
     "progress": {
       "itemsBackedUp": 58,
       "totalItems": 58
     },
     "startTimestamp": "2022-09-07T22:20:22Z",
     "version": 1
   }

6. Effacer la charge de travail de démonstration en exécutant la commande suivante:

   $ oc delete ns hello-world

7. Restaurer la charge de travail à partir de la sauvegarde en exécutant la commande suivante:

   $ cat << EOF | oc create -f -
     apiVersion: velero.io/v1
     kind: Restore
     metadata:
       name: hello-world
       namespace: openshift-adp
     spec:
       backupName: hello-world
   EOF

8. Attendez que la restauration se termine en exécutant la commande suivante:

   $ watch "oc -n openshift-adp get restore hello-world -o json | jq .status"

   Exemple de sortie

   {
     "completionTimestamp": "2022-09-07T22:25:47Z",
     "phase": "Completed",
     "progress": {
       "itemsRestored": 38,
       "totalItems": 38
     },
     "startTimestamp": "2022-09-07T22:25:28Z",
     "warnings": 9
   }

9. Assurez-vous que la charge de travail est restaurée en exécutant la commande suivante:

   $ oc -n hello-world get pods

   Exemple de sortie

   NAME                              READY   STATUS    RESTARTS   AGE
   hello-openshift-9f885f7c6-kdjpj   1/1     Running   0          90s

10. Cochez le JSONPath en exécutant la commande suivante:

    $ curl `oc get route/hello-openshift -n hello-world -o jsonpath='{.spec.host}'`

    Exemple de sortie

    Hello OpenShift!

Procédure

1. Effacer la charge de travail en exécutant la commande suivante:

   $ oc delete ns hello-world

2. Effacer l’application de protection des données (DPA) en exécutant la commande suivante:

   $ oc -n openshift-adp delete dpa ${CLUSTER_NAME}-dpa

3. Effacer le stockage en nuage en exécutant la commande suivante:

   $ oc -n openshift-adp delete cloudstorage ${CLUSTER_NAME}-oadp

   Avertissement

   Dans le cas où cette commande est suspendue, vous devrez peut-être supprimer le finalisateur en exécutant la commande suivante:

   $ oc -n openshift-adp patch cloudstorage ${CLUSTER_NAME}-oadp -p '{"metadata":{"finalizers":null}}' --type=merge

4. Lorsque l’opérateur n’est plus requis, retirez-le en exécutant la commande suivante:

   $ oc -n openshift-adp delete subscription oadp-operator

5. Enlevez l’espace de noms de l’opérateur:

   $ oc delete ns openshift-adp

6. Lorsque les ressources de sauvegarde et de restauration ne sont plus nécessaires, retirez-les du cluster en exécutant la commande suivante:

   $ oc delete backups.velero.io hello-world

7. Afin de supprimer les objets de sauvegarde, de restauration et de télécommande dans AWS S3, exécutez la commande suivante:

   $ velero backup delete hello-world

8. Lorsque vous n’avez plus besoin des Définitions de ressources personnalisées (CRD), supprimez-les du cluster en exécutant la commande suivante:

   $ for CRD in `oc get crds | grep velero | awk '{print $1}'`; do oc delete crd $CRD; done

9. Effacer le seau AWS S3 en exécutant les commandes suivantes:

   $ aws s3 rm s3://${CLUSTER_NAME}-oadp --recursive

   $ aws s3api delete-bucket --bucket ${CLUSTER_NAME}-oadp

10. Détachez la politique du rôle en exécutant la commande suivante:

    $ aws iam detach-role-policy --role-name "${ROLE_NAME}"  --policy-arn "${POLICY_ARN}"

11. Supprimez le rôle en exécutant la commande suivante:

    $ aws iam delete-role --role-name "${ROLE_NAME}"

Procédure

1. Créez une restauration CR comme indiqué dans l’exemple suivant:

   Exemple de restauration CR

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: test-restore 

   1

   
     namespace: openshift-adp
   spec:
     backupName: <backup_name> 

   2

   
     restorePVs: true
     namespaceMapping:
       <application_namespace>: test-restore-application 

   3

   1

   Le nom de la restauration CR.

   2

   Indiquez le nom de la sauvegarde.

   3

   le namespaceMapping mappe l’espace de noms de l’application source à l’espace de noms de l’application cible. Indiquez l’espace de noms de l’application que vous avez sauvegardé. l’application test-restauration est l’espace de noms cible où vous souhaitez restaurer la sauvegarde.

2. Appliquez le CR de restauration en exécutant la commande suivante:

   $ oc apply -f <restore_cr_filename>

La vérification

1. Assurez-vous que la restauration est en phase terminée en exécutant la commande suivante:

   $ oc describe restores.velero.io <restore_name> -n openshift-adp

2. Changer l’application de test-restauration de l’espace de noms restaurée en exécutant la commande suivante:

   $ oc project test-restore-application

3. Contrôlez les ressources restaurées telles que la revendication de volume persistant (pvc), le service (svc), le déploiement, le secret et la carte de configuration en exécutant la commande suivante:

   $ oc get pvc,svc,deployment,secret,configmap

   Exemple de sortie

   NAME                          STATUS   VOLUME
   persistentvolumeclaim/mysql   Bound    pvc-9b3583db-...-14b86
   
   NAME               TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   service/mysql      ClusterIP   172....157     <none>        3306/TCP   2m56s
   service/todolist   ClusterIP   172.....15     <none>        8000/TCP   2m56s
   
   NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/mysql   0/1     1            0           2m55s
   
   NAME                                         TYPE                      DATA   AGE
   secret/builder-dockercfg-6bfmd               kubernetes.io/dockercfg   1      2m57s
   secret/default-dockercfg-hz9kz               kubernetes.io/dockercfg   1      2m57s
   secret/deployer-dockercfg-86cvd              kubernetes.io/dockercfg   1      2m57s
   secret/mysql-persistent-sa-dockercfg-rgp9b   kubernetes.io/dockercfg   1      2m57s
   
   NAME                                 DATA   AGE
   configmap/kube-root-ca.crt           1      2m57s
   configmap/openshift-service-ca.crt   1      2m57s

Procédure

1. Créez les variables d’environnement suivantes en exécutant les commandes suivantes:

   Important

   Changez le nom du cluster pour correspondre à votre cluster ROSA et assurez-vous d’être connecté au cluster en tant qu’administrateur. Assurez-vous que tous les champs sont affichés correctement avant de continuer.

   $ export CLUSTER_NAME=my-cluster 

   1

   
     export ROSA_CLUSTER_ID=$(rosa describe cluster -c ${CLUSTER_NAME} --output json | jq -r .id)
     export REGION=$(rosa describe cluster -c ${CLUSTER_NAME} --output json | jq -r .region.id)
     export OIDC_ENDPOINT=$(oc get authentication.config.openshift.io cluster -o jsonpath='{.spec.serviceAccountIssuer}' | sed 's|^https://||')
     export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
     export CLUSTER_VERSION=$(rosa describe cluster -c ${CLUSTER_NAME} -o json | jq -r .version.raw_id | cut -f -2 -d '.')
     export ROLE_NAME="${CLUSTER_NAME}-openshift-oadp-aws-cloud-credentials"
     export SCRATCH="/tmp/${CLUSTER_NAME}/oadp"
     mkdir -p ${SCRATCH}
     echo "Cluster ID: ${ROSA_CLUSTER_ID}, Region: ${REGION}, OIDC Endpoint:
     ${OIDC_ENDPOINT}, AWS Account ID: ${AWS_ACCOUNT_ID}"

   1

   Le nom de votre cluster ROSA est remplacé par mon cluster.

2. Dans le compte AWS, créez une politique IAM pour permettre l’accès à AWS S3:

   1. Vérifiez si la stratégie existe en exécutant la commande suivante:

      $ POLICY_ARN=$(aws iam list-policies --query "Policies[?PolicyName=='RosaOadpVer1'].{ARN:Arn}" --output text) 

      1

      1

      Remplacez RosaOadp par le nom de votre politique.

   2. Entrez la commande suivante pour créer le fichier JSON de stratégie, puis créez la stratégie dans ROSA:

      Note

      Lorsque la stratégie ARN n’est pas trouvée, la commande crée la stratégie. Dans le cas où la politique ARN existe déjà, la déclaration si elle saute intentionnellement la création de la politique.

      $ if [[ -z "${POLICY_ARN}" ]]; then
        cat << EOF > ${SCRATCH}/policy.json 

      1

      
        {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "s3:CreateBucket",
              "s3:DeleteBucket",
              "s3:PutBucketTagging",
              "s3:GetBucketTagging",
              "s3:PutEncryptionConfiguration",
              "s3:GetEncryptionConfiguration",
              "s3:PutLifecycleConfiguration",
              "s3:GetLifecycleConfiguration",
              "s3:GetBucketLocation",
              "s3:ListBucket",
              "s3:GetObject",
              "s3:PutObject",
              "s3:DeleteObject",
              "s3:ListBucketMultipartUploads",
              "s3:AbortMultipartUpload",
              "s3:ListMultipartUploadParts",
              "ec2:DescribeSnapshots",
              "ec2:DescribeVolumes",
              "ec2:DescribeVolumeAttribute",
              "ec2:DescribeVolumesModifications",
              "ec2:DescribeVolumeStatus",
              "ec2:CreateTags",
              "ec2:CreateVolume",
              "ec2:CreateSnapshot",
              "ec2:DeleteSnapshot"
            ],
            "Resource": "*"
          }
        ]}
      EOF
      
        POLICY_ARN=$(aws iam create-policy --policy-name "RosaOadpVer1" \
        --policy-document file:///${SCRATCH}/policy.json --query Policy.Arn \
        --tags Key=rosa_openshift_version,Value=${CLUSTER_VERSION} Key=rosa_role_prefix,Value=ManagedOpenShift Key=operator_namespace,Value=openshift-oadp Key=operator_name,Value=openshift-oadp \
        --output text)
        fi

      1

      Le SCRATCH est un nom pour un répertoire temporaire créé pour les variables d’environnement.

   3. Consultez la stratégie ARN en exécutant la commande suivante:

      $ echo ${POLICY_ARN}

3. Créer une politique de confiance du rôle de l’IAM pour le cluster:

   1. Créez le fichier de stratégie de confiance en exécutant la commande suivante:

      $ cat <<EOF > ${SCRATCH}/trust-policy.json
        {
            "Version": "2012-10-17",
            "Statement": [{
              "Effect": "Allow",
              "Principal": {
                "Federated": "arn:aws:iam::${AWS_ACCOUNT_ID}:oidc-provider/${OIDC_ENDPOINT}"
              },
              "Action": "sts:AssumeRoleWithWebIdentity",
              "Condition": {
                "StringEquals": {
                  "${OIDC_ENDPOINT}:sub": [
                    "system:serviceaccount:openshift-adp:openshift-adp-controller-manager",
                    "system:serviceaccount:openshift-adp:velero"]
                }
              }
            }]
        }
      EOF

   2. Créez le rôle en exécutant la commande suivante:

      $ ROLE_ARN=$(aws iam create-role --role-name \
        "${ROLE_NAME}" \
        --assume-role-policy-document file://${SCRATCH}/trust-policy.json \
        --tags Key=rosa_cluster_id,Value=${ROSA_CLUSTER_ID} \
               Key=rosa_openshift_version,Value=${CLUSTER_VERSION} \
               Key=rosa_role_prefix,Value=ManagedOpenShift \
               Key=operator_namespace,Value=openshift-adp \
               Key=operator_name,Value=openshift-oadp \
        --query Role.Arn --output text)

   3. Afficher le rôle ARN en exécutant la commande suivante:

      $ echo ${ROLE_ARN}

4. Joindre la politique de l’IAM au rôle de l’IAM en exécutant la commande suivante:

   $ aws iam attach-role-policy --role-name "${ROLE_NAME}" \
     --policy-arn ${POLICY_ARN}

Procédure

1. Créez un service Red Hat OpenShift sur AWS secret à partir de votre fichier jeton AWS en entrant les commandes suivantes:

   1. Créer le fichier d’identification:

      $ cat <<EOF > ${SCRATCH}/credentials
        [default]
        role_arn = ${ROLE_ARN}
        web_identity_token_file = /var/run/secrets/openshift/serviceaccount/token
        region = <aws_region> 

      1

      
      EOF

      1

      <aws_region> par la région AWS à utiliser pour le point d’extrémité STS.

   2. Créer un espace de noms pour OADP:

      $ oc create namespace openshift-adp

   3. Créez le service Red Hat OpenShift sur AWS secret:

      $ oc -n openshift-adp create secret generic cloud-credentials \
        --from-file=${SCRATCH}/credentials

      Note

      Dans Red Hat OpenShift Service sur AWS version 4.15 et ultérieure, l’opérateur OADP prend en charge un nouveau flux de travail STS standardisé via le gestionnaire de cycle de vie de l’opérateur (OLM) et Cloud Credentials Operator (CCO). Dans ce flux de travail, vous n’avez pas besoin de créer le secret ci-dessus, vous n’avez besoin que de fournir le rôle ARN lors de l’installation d’opérateurs gérés par OLM en utilisant le service OpenShift Red Hat sur la console Web AWS, pour plus d’informations voir Installation depuis OperatorHub à l’aide de la console Web.

      Le secret précédent est créé automatiquement par CCO.

2. Installez l’opérateur OADP:

   1. Dans le Red Hat OpenShift Service sur la console web AWS, accédez aux opérateurs → OperatorHub.
   2. Cherchez l’opérateur OADP.
   3. Dans le champ role_ARN, collez le rôle_arn que vous avez créé précédemment et cliquez sur Installer.

3. Créez un stockage cloud AWS à l’aide de vos identifiants AWS en entrant la commande suivante:

   $ cat << EOF | oc create -f -
     apiVersion: oadp.openshift.io/v1alpha1
     kind: CloudStorage
     metadata:
       name: ${CLUSTER_NAME}-oadp
       namespace: openshift-adp
     spec:
       creationSecret:
         key: credentials
         name: cloud-credentials
       enableSharedConfig: true
       name: ${CLUSTER_NAME}-oadp
       provider: aws
       region: $REGION
   EOF

4. Consultez la classe de stockage par défaut de votre application en entrant la commande suivante:

   $ oc get pvc -n <namespace>

   Exemple de sortie

   NAME     STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   AGE
   applog   Bound    pvc-351791ae-b6ab-4e8b-88a4-30f73caf5ef8   1Gi        RWO            gp3-csi        4d19h
   mysql    Bound    pvc-16b8e009-a20a-4379-accc-bc81fedd0621   1Gi        RWO            gp3-csi        4d19h

5. Bénéficiez de la classe de stockage en exécutant la commande suivante:

   $ oc get storageclass

   Exemple de sortie

   NAME                PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
   gp2                 kubernetes.io/aws-ebs   Delete          WaitForFirstConsumer   true                   4d21h
   gp2-csi             ebs.csi.aws.com         Delete          WaitForFirstConsumer   true                   4d21h
   gp3                 ebs.csi.aws.com         Delete          WaitForFirstConsumer   true                   4d21h
   gp3-csi (default)   ebs.csi.aws.com         Delete          WaitForFirstConsumer   true                   4d21h

   Note

   Les classes de stockage suivantes fonctionneront:

   • gp3-csi
   • gp2-csi
   • Gp3
   • Gp2

   Lorsque l’application ou les applications en cours de sauvegarde sont toutes utilisant des volumes persistants (PV) avec Container Storage Interface (CSI), il est conseillé d’inclure le plugin CSI dans la configuration OADP DPA.

6. Créez la ressource DataProtectionApplication pour configurer la connexion au stockage où les sauvegardes et les instantanés de volume sont stockés:

   1. Lorsque vous utilisez uniquement des volumes CSI, déployez une application de protection des données en entrant la commande suivante:

      $ cat << EOF | oc create -f -
        apiVersion: oadp.openshift.io/v1alpha1
        kind: DataProtectionApplication
        metadata:
          name: ${CLUSTER_NAME}-dpa
          namespace: openshift-adp
        spec:
          backupImages: true 

      1

      
          features:
            dataMover:
              enable: false
          backupLocations:
          - bucket:
              cloudStorageRef:
                name: ${CLUSTER_NAME}-oadp
              credential:
                key: credentials
                name: cloud-credentials
              prefix: velero
              default: true
              config:
                region: ${REGION}
          configuration:
            velero:
              defaultPlugins:
              - openshift
              - aws
              - csi
            nodeAgent:  

      2

      
              enable: false
              uploaderType: kopia 

      3

      
      EOF

      1

      La ROSA prend en charge la sauvegarde interne d’image. Définissez ce champ sur false si vous ne voulez pas utiliser la sauvegarde d’image.

      2

      Consultez la note importante concernant l’attribut nodeAgent.

      3

      Le type de téléchargeur. Les valeurs possibles sont restiques ou kopia. Le Mover de données intégré utilise Kopia comme mécanisme de téléchargement par défaut, quelle que soit la valeur du champ uploaderType.

1. Lorsque vous utilisez des volumes CSI ou non CSI, déployez une application de protection des données en entrant la commande suivante:

   $ cat << EOF | oc create -f -
     apiVersion: oadp.openshift.io/v1alpha1
     kind: DataProtectionApplication
     metadata:
       name: ${CLUSTER_NAME}-dpa
       namespace: openshift-adp
     spec:
       backupImages: true 

   1

   
       backupLocations:
       - bucket:
           cloudStorageRef:
             name: ${CLUSTER_NAME}-oadp
           credential:
             key: credentials
             name: cloud-credentials
           prefix: velero
           default: true
           config:
             region: ${REGION}
       configuration:
         velero:
           defaultPlugins:
           - openshift
           - aws
         nodeAgent: 

   2

   
           enable: false
           uploaderType: restic
       snapshotLocations:
         - velero:
             config:
               credentialsFile: /tmp/credentials/openshift-adp/cloud-credentials-credentials 

   3

   
               enableSharedConfig: "true" 

   4

   
               profile: default 

   5

   
               region: ${REGION} 

   6

   
             provider: aws
   EOF

   1

   La ROSA prend en charge la sauvegarde interne d’image. Définissez ce champ sur false si vous ne voulez pas utiliser la sauvegarde d’image.

   2

   Consultez la note importante concernant l’attribut nodeAgent.

   3

   Le champ CredentialsFile est l’emplacement monté de l’identifiant du seau sur le pod.

   4

   Le champ enableSharedConfig permet aux snapshotLocations de partager ou de réutiliser l’identifiant défini pour le seau.

   5

   Utilisez le nom de profil défini dans le fichier d’identification AWS.

   6

   Indiquez la région en tant que région AWS. Cela doit être le même que la région des clusters.

   Désormais, vous êtes prêt à sauvegarder et restaurer Red Hat OpenShift Service sur les applications AWS, comme décrit dans les applications de sauvegarde.

Procédure

1. Afin de vérifier que l’abonnement OADP a le mauvais jeu de variable d’environnement ARN rôle IAM, exécutez la commande suivante:

   $ oc get sub -o yaml redhat-oadp-operator

   Exemple d’abonnement

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     annotations:
     creationTimestamp: "2025-01-15T07:18:31Z"
     generation: 1
     labels:
       operators.coreos.com/redhat-oadp-operator.openshift-adp: ""
     name: redhat-oadp-operator
     namespace: openshift-adp
     resourceVersion: "77363"
     uid: 5ba00906-5ad2-4476-ae7b-ffa90986283d
   spec:
     channel: stable-1.4
     config:
       env:
       - name: ROLEARN
         value: arn:aws:iam::11111111:role/wrong-role-arn 

   1

   
     installPlanApproval: Manual
     name: redhat-oadp-operator
     source: prestage-operators
     sourceNamespace: openshift-marketplace
     startingCSV: oadp-operator.v1.4.2

   1

   Vérifiez la valeur de ROLEARN que vous souhaitez mettre à jour.

2. Actualisez le champ ROLEARN de l’abonnement avec le rôle correct ARN en exécutant la commande suivante:

   $ oc patch subscription redhat-oadp-operator -p '{"spec": {"config": {"env": [{"name": "ROLEARN", "value": "<role_arn>"}]}}}' --type='merge'

   là où:

   <role_arn>

   Indique le rôle IAM ARN à mettre à jour. Arn:aws:iam::160….6956:role/oadprosa…..8wlf.

3. Assurez-vous que l’objet secret est mis à jour avec la valeur ARN du rôle correct en exécutant la commande suivante:

   $ oc get secret cloud-credentials -o jsonpath='{.data.credentials}' | base64 -d

   Exemple de sortie

   [default]
   sts_regional_endpoints = regional
   role_arn = arn:aws:iam::160.....6956:role/oadprosa.....8wlf
   web_identity_token_file = /var/run/secrets/openshift/serviceaccount/token

4. Configurez le fichier de manifestation DataProtectionApplication (CR) comme indiqué dans l’exemple suivant:

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   metadata:
     name: test-rosa-dpa
     namespace: openshift-adp
   spec:
     backupLocations:
     - bucket:
         config:
           region: us-east-1
         cloudStorageRef:
           name: <cloud_storage> 

   1

   
         credential:
           name: cloud-credentials
           key: credentials
         prefix: velero
         default: true
     configuration:
       velero:
         defaultPlugins:
         - aws
         - openshift

   1

   Indiquez le CloudStorage CR.

5. Créez la DataProtectionApplication CR en exécutant la commande suivante:

   $ oc create -f <dpa_manifest_file>

6. Assurez-vous que le DataProtectionApplication CR est réconcilié et que l’état est défini sur "True" en exécutant la commande suivante:

   $  oc get dpa -n openshift-adp -o yaml

   Exemple d’application de DataProtectionApplication

   apiVersion: oadp.openshift.io/v1alpha1
   kind: DataProtectionApplication
   ...
   status:
       conditions:
       - lastTransitionTime: "2023-07-31T04:48:12Z"
         message: Reconcile complete
         reason: Complete
         status: "True"
         type: Reconciled

7. Assurez-vous que BackupStorageLocation CR est dans un état disponible en exécutant la commande suivante:

   $ oc get backupstoragelocations.velero.io -n openshift-adp

   Exemple de BackupStorageLocation

   NAME       PHASE       LAST VALIDATED   AGE   DEFAULT
   ts-dpa-1   Available   3s               6s    true

Procédure

1. Afin de prévisualiser les ressources incluses dans la sauvegarde avant d’exécuter la sauvegarde réelle, exécutez la commande suivante:

   $ velero backup create <backup-name> --snapshot-volumes false 

   1

   1

   Indiquez la valeur du paramètre --snapshot-volumes comme false.

2. Afin de connaître plus de détails sur les ressources de sauvegarde, exécutez la commande suivante:

   $ velero describe backup <backup_name> --details 

   1

   1

   Indiquez le nom de la sauvegarde.

3. Afin de prévisualiser les ressources incluses dans la restauration avant d’exécuter la restauration réelle, exécutez la commande suivante:

   $ velero restore create --from-backup <backup-name> 

   1

   1

   Indiquez le nom de la sauvegarde créée pour examiner les ressources de sauvegarde.

   Important

   La commande de création de la restauration velero crée des ressources de restauration dans le cluster. Après avoir examiné les ressources, vous devez supprimer les ressources créées dans le cadre de la restauration.

4. Afin de connaître plus de détails sur les ressources de restauration, exécutez la commande suivante:

   $ velero describe restore <restore_name> --details 

   1

   1

   Indiquez le nom de la restauration.

Procédure

1. Créer un fichier manifeste DeleteBackupRequest CR:

   apiVersion: velero.io/v1
   kind: DeleteBackupRequest
   metadata:
     name: deletebackuprequest
     namespace: openshift-adp
   spec:
     backupName: <backup_name> 

   1

   1

   Indiquez le nom de la sauvegarde.

2. Appliquez le DeleteBackupRequest CR pour supprimer la sauvegarde:

   $ oc apply -f <deletebackuprequest_cr_filename>

Procédure

1. Afin d’obtenir le nom du référentiel de sauvegarde CR pour une sauvegarde, exécutez la commande suivante:

   $ oc get backuprepositories.velero.io -n openshift-adp

2. Afin de supprimer le référentiel de sauvegarde CR, exécutez la commande suivante:

   $ oc delete backuprepository <backup_repository_name> -n openshift-adp 

   1

   1

   Indiquez le nom du référentiel de sauvegarde de l’étape précédente.

Procédure

1. Afin de prévisualiser les ressources incluses dans la sauvegarde avant d’exécuter la sauvegarde réelle, exécutez la commande suivante:

   $ velero backup create <backup-name> --snapshot-volumes false 

   1

   1

   Indiquez la valeur du paramètre --snapshot-volumes comme false.

2. Afin de connaître plus de détails sur les ressources de sauvegarde, exécutez la commande suivante:

   $ velero describe backup <backup_name> --details 

   1

   1

   Indiquez le nom de la sauvegarde.

3. Afin de prévisualiser les ressources incluses dans la restauration avant d’exécuter la restauration réelle, exécutez la commande suivante:

   $ velero restore create --from-backup <backup-name> 

   1

   1

   Indiquez le nom de la sauvegarde créée pour examiner les ressources de sauvegarde.

   Important

   La commande de création de la restauration velero crée des ressources de restauration dans le cluster. Après avoir examiné les ressources, vous devez supprimer les ressources créées dans le cadre de la restauration.

4. Afin de connaître plus de détails sur les ressources de restauration, exécutez la commande suivante:

   $ velero describe restore <restore_name> --details 

   1

   1

   Indiquez le nom de la restauration.

Procédure

1. Créer un CR Restaurer, comme dans l’exemple suivant:

   apiVersion: velero.io/v1
   kind: Restore
   metadata:
     name: <restore>
     namespace: openshift-adp
   spec:
     backupName: <backup> 

   1

   
     includedResources: [] 

   2

   
     excludedResources:
     - nodes
     - events
     - events.events.k8s.io
     - backups.velero.io
     - restores.velero.io
     - resticrepositories.velero.io
     restorePVs: true 

   3

   1

   Le nom du Backup CR.

   2

   Facultatif : Spécifiez un éventail de ressources à inclure dans le processus de restauration. Les ressources peuvent être des raccourcis (par exemple, po pour les pods) ou entièrement qualifiés. En cas d’absence de précision, toutes les ressources sont incluses.

   3

   Facultatif: Le paramètre de restaurationPVs peut être défini sur false pour désactiver la restauration de PersistentVolumes à partir de VolumeSnapshot of Container Storage Interface (CSI) instantanés ou à partir de snapshots natifs lorsque VolumeSnapshotLocation est configuré.

2. Assurez-vous que l’état de la Restauration CR est complété en entrant la commande suivante:

   $ oc get restores.velero.io -n openshift-adp <restore> -o jsonpath='{.status.phase}'

3. Assurez-vous que les ressources de sauvegarde ont été restaurées en entrant la commande suivante:

   $ oc get all -n <namespace> 

   1

   1

   Espace de noms que vous avez sauvegardé.

4. Lorsque vous rétablissez DeploymentConfig avec des volumes ou si vous utilisez des crochets post-restauration, exécutez le script de nettoyage dc-post-restore.sh en entrant la commande suivante:

   $ bash dc-restic-post-restore.sh -> dc-post-restore.sh

   Note

   Au cours du processus de restauration, les plug-ins OADP Velero réduisent les objets DeploymentConfig et restaurent les pods en tant que gousses autonomes. Ceci est fait pour empêcher le cluster de supprimer les pods restaurés DeploymentConfig immédiatement sur la restauration et pour permettre aux crochets de restauration et de post-restauration de compléter leurs actions sur les gousses restaurées. Le script de nettoyage ci-dessous supprime ces pods déconnectés et met à l’échelle tous les objets DeploymentConfig vers le nombre approprié de répliques.

   Exemple 1.1. DC-restic-post-restore.sh → script de nettoyage dc-post-restore.sh

   #!/bin/bash
   set -e
   
   # if sha256sum exists, use it to check the integrity of the file
   if command -v sha256sum >/dev/null 2>&1; then
     CHECKSUM_CMD="sha256sum"
   else
     CHECKSUM_CMD="shasum -a 256"
   fi
   
   label_name () {
       if [ "${#1}" -le "63" ]; then
   	echo $1
   	return
       fi
       sha=$(echo -n $1|$CHECKSUM_CMD)
       echo "${1:0:57}${sha:0:6}"
   }
   
   if [[ $# -ne 1 ]]; then
       echo "usage: ${BASH_SOURCE} restore-name"
       exit 1
   fi
   
   echo "restore: $1"
   
   label=$(label_name $1)
   echo "label:   $label"
   
   echo Deleting disconnected restore pods
   oc delete pods --all-namespaces -l oadp.openshift.io/disconnected-from-dc=$label
   
   for dc in $(oc get dc --all-namespaces -l oadp.openshift.io/replicas-modified=$label -o jsonpath='{range .items[*]}{.metadata.namespace}{","}{.metadata.name}{","}{.metadata.annotations.oadp\.openshift\.io/original-replicas}{","}{.metadata.annotations.oadp\.openshift\.io/original-paused}{"\n"}')
   do
       IFS=',' read -ra dc_arr <<< "$dc"
       if [ ${#dc_arr[0]} -gt 0 ]; then
   	echo Found deployment ${dc_arr[0]}/${dc_arr[1]}, setting replicas: ${dc_arr[2]}, paused: ${dc_arr[3]}
   	cat <<EOF | oc patch dc  -n ${dc_arr[0]} ${dc_arr[1]} --patch-file /dev/stdin
   spec:
     replicas: ${dc_arr[2]}
     paused: ${dc_arr[3]}
   EOF
       fi
   done