Installation de la sauvegarde Portworx

Avant de commencer :

• Assurez-vous que votre cluster répond aux exigences minimales d' Portworx.
• Connectez-vous à votre cluster.
• Mettez à disposition et connectez 320 Gi de stockage par blocs à votre cluster. Voir Setting IBM Cloud Block Storage ou Setting up Block Storage for VPC.

Si vous installez l' Portworx Backup dans un cluster nouvellement provisionné, vous devez vous y connecter au moins une fois avant de commencer l'installation.

1. Ouvrez le service de sauvegarde Portworx à partir du catalogueIBM Cloud.
2. Sélectionnez le même emplacement que celui où se trouve le cluster sur lequel vous souhaitez installer l' Portworx. Vous pouvez trouver l'emplacement de votre cluster dans le tableau de bord Red Hat OpenShift on IBM Cloud.
3. Saisissez le nom de votre service de sauvegarde d' Portworx s dans le champ Nom du service.
4. Sélectionnez le groupe de ressources dans lequel vous souhaitez créer le service de sauvegarde d' Portworx.
5. Dans la zone Etiquette, entrez le nom du cluster dans lequel vous souhaitez installer PX-Backup. Une fois l'installation terminée, vous ne pouvez pas voir le nom du cluster sur lequel vous avez installé PX-Backup. Pour retrouver ce cluster facilement par la suite, assurez-vous d'indiquer le nom du cluster ainsi que toute autre information en tant qu'étiquettes.
6. Entrez votre clé d'API IBM Cloud. Une fois que vous avez entré la clé d'API, la zone Kubernetes or OpenShift cluster name apparaît. Si vous n'avez pas de clé d'API IBM Cloud, voir Création d'une clé d'API pour en créer un.
7. Dans la zone Kubernetes or OpenShift cluster name, sélectionnez le cluster dans lequel vous souhaitez installer PX-Backup.
8. Saisissez le nom du projet d' Red Hat OpenShift, dans lequel vous souhaitez installer les composants du service de sauvegarde d' Portworx. N'utilisez pas l'espace de noms kube-system ou default. Si le projet Red Hat OpenShift que vous entrez n'existe pas déjà dans votre cluster, il est automatiquement créé lors de l'installation.
9. Sélectionnez une classe de stockage existante dans votre cluster pour provisionner des volumes persistants pour le service de sauvegarde d' Portworx. Ce service utilise ce stockage pour stocker les métadonnées de service ; il n'est pas utilisé pour sauvegarder vos applications et données. Vos applications et vos données sont sauvegardées sur une instance de service IBM Cloud Object Storage.
10. Cliquez sur Créer pour lancer l'installation de l' Portworx. L'installation peut prendre quelques minutes.
11. Vérifiez que votre service de sauvegarde Portworx est correctement installé.

Vérification de votre installation de sauvegarde d' Portworx

Vérifiez que la sauvegarde d' Portworx s est correctement installée sur votre cluster.

1. Dans la liste des ressources d' IBM Cloud, recherchez le service de sauvegarde d' Portworx que vous avez créé.
2. Consultez la colonne Statut pour voir si l'installation a réussi ou échoué. La mise à jour du statut peut prendre quelques minutes.
3. Si le statut passe à Actif, vérifiez que les pods, services et tâches de sauvegarde d' Portworx s sont en cours d'exécution dans votre cluster.
   1. Dans la liste des ressources d' IBM Cloud, sélectionnez le cluster sur lequel vous avez installé PX-Backup.
   2. Ouvrez la console Web d'Red Hat OpenShift.
   3. Cliquez sur Projets.
   4. Sélectionnez l'espace de noms où vous avez installé les composants du service de sauvegarde d' Portworx.
   5. Dans la section Inventaire, sélectionnez l'option permettant d'afficher vos pods.
   6. Dans la table Pods, vérifiez que le statut de chaque pod est En cours d'exécution.
   7. Cliquez sur Mise en réseau > Routes.
   8. Recherchez la route px-backup-ui et vérifiez qu'une URL est répertoriée dans la colonne Emplacement.
   9. Cliquez sur Charges de travail > Travaux.
   10. Vérifiez que le travail pxcentral-post-install-hook est terminé.

Depuis l'interface de ligne de commande :

1. Dans la liste des ressources IBM Cloud, recherchez le service de sauvegarde Portworx que vous avez créé.
2. Consultez la colonne Statut pour voir si l'installation a réussi ou échoué. La mise à jour du statut peut prendre quelques minutes.
3. Si le statut passe à Actif, vérifiez que les pods de sauvegarde d' Portworx s sont en cours d'exécution dans votre cluster.
   1. Accédez à votre cluster Red Hat OpenShift.
   2. Exécutez la commande permettant de vérifier que l'installation est terminée.

      oc get po -n <px_backup_namespace> -ljob-name=pxcentral-post-install-hook  -o wide | awk '{print $1   $3}' | grep -iv error
      

      Exemple de sortie

      NAMESTATUS
      pxcentral-post-install-hook-5b86qCompleted
      

Connexion à la console de sauvegarde Portworx

Accédez à la console de sauvegarde Portworx via l' URL fournie dans le tableau de bord Red Hat OpenShift on IBM Cloud du cluster sur lequel vous avez installé le service.

Pour les clusters VPC

1. Dans la liste des ressources d' IBM Cloud, sélectionnez le cluster sur lequel vous avez installé PX-Backup.
2. Ouvrez la console Web d'Red Hat OpenShift.
3. Cliquez sur Réseau > Routes.
4. Trouvez l'itinéraire px-backup-ui et cliquez sur l' URL e qui figure dans la colonne Emplacement pour ouvrir la console de sauvegarde Portworx.
5. Connectez-vous à la console de sauvegarde Portworx. Si vous êtes le premier utilisateur à accéder à la console, vous devez vous connecter avec le nom d'utilisateur admin et le mot de passe admin. Vous êtes redirigé vers une page d'enregistrement pour définir un nom d'utilisateur et un mot de passe uniques. Les utilisateurs suivants doivent enregistrer un nouveau compte pour pouvoir accéder à la console.

Pour les clusters classiques publics

1. Dans la liste des ressources d' IBM Cloud, sélectionnez le cluster sur lequel vous avez installé PX-Backup.
2. Ouvrez la console Web d'Red Hat OpenShift.
3. Cliquez sur Réseau > Routes.
4. Recherchez la route px-backup-ui et notez l'adresse IP et le port de noeud répertoriés dans la colonne Emplacements.
5. Copiez et collez l'adresse IP et le port du nœud dans votre navigateur Web pour ouvrir la console de sauvegarde Portworx.
6. Connectez-vous à la console de sauvegarde Portworx. Si vous êtes le premier utilisateur à accéder à la console, vous devez vous connecter avec le nom d'utilisateur admin et le mot de passe admin. Vous êtes redirigé vers une page d'enregistrement pour définir un nom d'utilisateur et un mot de passe uniques. Les utilisateurs suivants doivent enregistrer un nouveau compte pour pouvoir accéder à la console.

Pour les clusters privés classiques, exposez le service px-backup-ui sur votre cluster privé pour accéder à la console de sauvegarde Portworx.

Ajout d'un emplacement de sauvegarde à votre service de sauvegarde d' Portworx

Créez une instance et un compartiment d' IBM Cloud Object Storage, et ajoutez-les en tant qu'emplacement de sauvegarde à votre service de sauvegarde Portworx.

Avant de commencer, connectez-vous à la Portworx. Notez que si vous êtes le premier utilisateur à accéder à la console, vous devez vous connecter avec le nom d'utilisateur admin et le mot de passe admin. Vous êtes redirigé vers une page d'enregistrement pour définir un nom d'utilisateur et un mot de passe uniques. Les utilisateurs suivants doivent enregistrer un nouveau compte pour pouvoir accéder à la console.

1. Créez votre instance de service IBM Cloud Object Storage.
2. Créez votre instance de service IBM Cloud Object Storage. Veillez à activer l'authentification HMAC en cliquant sur Options avancées dans la boîte de dialogue Créer des données d'identification et en basculant le paramètre Inclure les données d'authentification HMAC sur Activé.
3. Développez vos données d'identification dans la table des données d'identification de service. Notez le access_key_id et le secret_access_key dans la section cos_hmac_keys section.
4. Créez un compartiment de stockage dans votre instance IBM Cloud Object Storage.
5. Cliquez sur votre seau et notez son emplacement.
6. Ouvrez la page de configuration du compartiment et notez le noeud final à utiliser pour vous connecter à votre instance IBM Cloud Object Storage.
   • Si vous avez installé la sauvegarde d' Portworx s sur un cluster classique privé, notez le point de terminaison privé.
   • Si vous avez installé l' Portworx Backup sur un cluster VPC privé, notez le point de terminaison direct.
   • Pour tous les autres types de cluster, notez le noeud final public.
7. Dans la console de sauvegarde Portworx, cliquez sur Sauvegardes.
8. Cliquez sur Paramètres > Paramètres du cloud.
9. Créez un compte cloud pour spécifier votre instance IBM Cloud Object Storage comme emplacement de sauvegarde de vos données et applications.
   1. Pour le fournisseur de cloud, sélectionnez AWS / S3 Compliant Object Store.
   2. Entrez un nom pour votre compte cloud.
   3. Saisissez le access_key_id que vous avez récupérée précédemment.
   4. Saisissez le secret_access_key que vous avez récupérée précédemment.
   5. Cliquez sur Ajouter et retournez à la page Paramètres de cloud.
10. Dans la section Emplacements de sauvegarde, ajoutez votre compartiment d' IBM Cloud Object Storage s comme emplacement de sauvegarde pour votre service de sauvegarde d' Portworx.
11. Entrez un nom pour votre emplacement de sauvegarde.
12. Sélectionnez le compte cloud que vous avez créé précédemment.
13. Dans la zone Chemin/Compartiment, entrez le nom de votre compartiment.
14. Dans la zone Région, entrez l'emplacement de votre compartiment que vous avez extrait précédemment.
15. Dans la zone Noeud final, entrez le noeud final de votre compartiment que vous avez extrait précédemment.
16. Cliquez sur Ajouter pour créer l'emplacement de sauvegarde.

Ajout de clusters Red Hat OpenShift on IBM Cloud à votre service de sauvegarde Portworx

Ajoutez le cluster Red Hat OpenShift on IBM Cloud que vous souhaitez sauvegarder avec PX-Backup. Vous pouvez sélectionner tout cluster dans votre compte, y compris celui dans lequel vous avez installé PX-Backup.

Avant de commencer :

• Connectez-vous à la console de sauvegarde Portworx.
• Connectez-vous à votre compte. Le cas échéant, ciblez le groupe de ressources approprié. Définissez le contexte de votre cluster.

L' kubeconfig, en grappes avec l' Portworx, expire après 24 heures. Pour éviter que le fichier d' kubeconfig s de votre cluster n'expire, définissez le contexte avec votre cluster en utilisant l'option --admin.

ibmcloud oc cluster config --cluster <cluster_name> --admin --endpoint private

Ajout d'un cluster :

1. Dans la console de sauvegarde Portworx, cliquez sur Sauvegardes.
2. Cliquez sur Ajouter un cluster.
3. Entrez le nom du cluster à sauvegarder.
4. Dans l'interface de ligne de commande, récupérez le fichier de sortie d' kubeconfig s de votre cluster. Assurez-vous d'avoir défini le contexte de votre cluster avec l'option " --admin " pour éviter que le " kubeconfig " n'expire.

   oc config view --flatten --minify
   

5. Copiez l'intégralité de la sortie CLI d' kubeconfig et collez-la dans le Kubeconfig champ de la console de sauvegarde Portworx.
6. Sélectionnez Autres comme Service Kubernetes.
7. Si le cluster que vous souhaitez ajouter au service de sauvegarde d' Portworx s n'a pas installé d' Portworx, vous devez installer Stork sur le cluster. Si vous avez installé Portworx Enterprise dans votre cluster, Stork est installé par défaut.
8. Cliquez sur Submit. Si votre cluster a été correctement ajouté, vous êtes redirigé vers la page Sauvegardes. Vérifiez que votre cluster est répertorié.
9. Sauvegardez les données de votre cluster.
10. Répétez ces étapes pour ajouter d'autres clusters à votre service de sauvegarde d' Portworx.

Installation de Stork sur un cluster autre que Portworx

Si un cluster que vous souhaitez sauvegarder avec l'outil de sauvegard Portworx n'a pas installé l'outil Stork ( Portworx Enterprise ), vous devez installer Stork sur le cluster avant de l'ajouter à votre service de sauvegardes Portworx.

1. Depuis la page Ajouter un cluster de la console de sauvegarde d' Portworx, copiez la commande pour installer Stork sur un cluster non-PX.

2. Ouvrez un éditeur de texte et collez la commande.

3. Copiez l'URL dans la commande et entrez-la dans votre navigateur Web pour ouvrir le fichier YAML de l'installation de Stork.

4. Copiez et collez l'intégralité du fichier YAML dans un nouveau fichier dans votre éditeur de texte.

5. Si le cluster que vous souhaitez ajouter est un cluster privé, recherchez la zone Image et remplacez openstorage/stork:<version_number> par icr.io/ext/portworx/stork:<version_numer>. Pour trouver la dernière version disponible de Stork, consultez les versions de Stork.

   - --health-monitor-interval=120
   - --webhook-controller=false
   image: openstore/stork:2.6.2
   imagePullPolicy:Always
   resources:
     requests:
        cpu: '0.1'
     name: stork
   serviceAccountName: stork-account  
   

6. Sauvegardez le fichier et exécutez la commande pour appliquer le fichier à votre cluster et installer Stork.

   oc apply -f <file_name>.yaml
   

7. Vérifiez que Stork a été installé sur votre cluster et que tous les pods fonctionnent.

   oc get deployment -n kube-system | grep stork
   

   Exemple de sortie

   stork                3/3   3      3      7d20h
   

Création d'une sauvegarde à l'aide de la commande kmpd

1. Installez Portworx Backup dans votre cluster.
2. Editez l'objet kdmp-config ConfigMap dans l'espace de nom kube-system de votre cluster.

   kubectl edit cm kdmp-config -n kube-system
   

3. Ajoutez le paramètre suivant à la section data.

   BACKUP_TYPE: "Generic"
   

4. Suivez les instructions de la documentationPortworx Backup pour créer une sauvegarde.

Sauvegarde et restauration de données de cluster avec PX-Backup

Pour sauvegarder les données de votre cluster ou pour restaurer les données sur votre cluster, reportez-vous à la documentation de sauvegarde d' Portworx.

Sauvegarde des applications et des données de votre cluster vers IBM Cloud Object Storage : Vous pouvez sauvegarder un espace de nom de cluster complet, des applications uniques et les données stockées dans vos volumes persistants vers l'instance de service IBM Cloud Object Storage que vous avez configuré comme emplacement de sauvegarde. Notez que pour sauvegarder des données dans des volumes persistants, vous devez disposer d'une classe de stockage de snapshots CSI dans votre cluster. Portworx La sauvegarde utilise cette classe de stockage pour prendre d'abord un instantané de vos données, puis envoyer ces données à votre emplacement de sauvegarde d' IBM Cloud Object Storage. Pour plus d'informations, voir la documentationPortworx Backup.

Restaurez toute sauvegarde que vous avez créée sur un autre cluster : Vous pouvez restaurer un espace de noms entier, vos applications ou vos données vers n'importe quel cluster que vous avez ajouté au service de sauvegarde d' Portworx. Utilisez cette fonctionnalité de sauvegarde d' Portworx s si vous souhaitez migrer des applications et des données d'un cluster à un autre. Pour plus d'informations, voir la documentationPortworx Backup.