Installation de la sauvegarde Portworx

Avant de commencer :

• Assurez-vous que votre cluster répond aux exigences minimales de Portworx en matière de calcul, de mémoire et de stockage pris en charge.
• 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 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 l'emplacement où se trouve le cluster sur lequel vous souhaitez installer la solution de sauvegarde « 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 « Portworx » dans le champ « Nom du service ».
4. Sélectionnez le groupe de ressources dans lequel vous souhaitez créer le service de sauvegarde « 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 « Red Hat OpenShift » dans lequel vous souhaitez installer les composants du service de sauvegarde « 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 afin de provisionner des volumes persistants pour le service de sauvegarde « 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 la sauvegarde « Portworx ». L'installation pourrait prendre quelques minutes.
11. Vérifiez que votre service de sauvegarde Portworx est correctement installé.

Vérification de l'installation de votre solution de sauvegarde « Portworx »

Vérifiez que la solution de sauvegarde « Portworx » est correctement installée sur votre cluster.

1. Dans la liste des ressources de l' 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, services et tâches de sauvegarde d' Portworx sont en cours d'exécution dans votre cluster.
   1. Dans la liste des ressources « 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 dans lequel vous avez installé les composants du service de sauvegarde « 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 « 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 « Workloads » > « Jobs ».
   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 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
       ```sh {: screen}
       NAMESTATUS
       pxcentral-post-install-hook-5b86qCompleted
       ```
   
   

Connexion à la console de sauvegarde Portworx

Accédez à la console de sauvegarde d' Portworx via l'URL 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 « 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 cliquez sur l' URL, qui figure dans la colonne « Emplacement », pour ouvrir la console de sauvegarde d' 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 « 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-collez l'adresse IP et le port du nœud dans votre navigateur Web pour ouvrir la console de sauvegarde d' 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 classiques privés, exposez le service px-backup-ui sur votre cluster privé afin de pouvoir accéder à la console de sauvegarde d' Portworx.

Ajouter un emplacement de sauvegarde à votre service de sauvegarde « Portworx »

Créez une instance et un compartiment d' IBM Cloud Object Storage, puis 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 que access_key_id et le secret_access_key dans la 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 solution de sauvegarde « Portworx » sur un cluster classique privé, notez le point de terminaison privé.
   • Si vous avez installé la sauvegarde « Portworx » 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é précédemment.
   4. Saisissez le secret_access_key que vous avez récupéré 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 IBM Cloud Object Storage comme emplacement de sauvegarde pour votre service de sauvegarde Portworx.
    1. Entrez un nom pour votre emplacement de sauvegarde.
    2. Sélectionnez le compte cloud que vous avez créé précédemment.
    3. Dans la zone Chemin/Compartiment, entrez le nom de votre compartiment.
    4. Dans la zone Région, entrez l'emplacement de votre compartiment que vous avez extrait précédemment.
    5. Dans la zone Noeud final, entrez le noeud final de votre compartiment que vous avez extrait précédemment.
    6. 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, regroupée dans des clusters avec Portworx, expire au bout de 24 heures. Pour éviter que le fichier kubeconfig de votre cluster n'expire, définissez le contexte de votre cluster à l'aide de 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 en ligne de commande (CLI), récupérez le contenu du fichier « kubeconfig » correspondant à votre cluster. Assurez-vous d'avoir défini le contexte de votre cluster à l'aide de l'option « --admin » afin d'éviter que l' kubeconfig n'expire.

   oc config view --flatten --minify
   

5. Copiez l'intégralité de la sortie de la ligne de commande (CLI) de « kubeconfig » et collez-la dans le Kubeconfig champ de la console de sauvegarde d’ Portworx.
6. Sélectionnez Autres comme Service Kubernetes.
7. Si le cluster que vous souhaitez ajouter au service de sauvegarde d' Portworx ne dispose pas d' Portworx, vous devez installer Stork sur ce 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 « Portworx ».

Installation de Stork sur un cluster autre que Portworx

Si un cluster que vous souhaitez sauvegarder à l'aide de la solution de sauvegarde « Portworx » ne dispose pas d' Portworx Enterprise, vous devez installer Stork sur ce cluster avant de l'ajouter à votre service de sauvegarde « Portworx ».

1. À partir de la page « Ajouter un cluster » de la console de sauvegarde d' Portworx, copiez la commande permettant d'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é, repérez le champ « image » et remplacez openstorage/stork:<version_number> par icr.io/ext/portworx/stork:<version_number>. Utilisez le même numéro de version de Stork dans la référence de l'image de remplacement. Pour connaître la dernière version disponible de Stork, consultez la page des 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 « données ».

   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 les restaurer sur celui-ci, consultez le guide « Portworx Documentation relative à la sauvegarde ».

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 stockées dans des volumes persistants, vous devez disposer d'une classe de stockage de snapshots CSI dans votre cluster. Portworx La fonction de sauvegarde utilise cette classe de stockage pour créer d'abord un instantané de vos données, puis envoyer ces données vers votre emplacement de sauvegarde 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 complet, vos applications ou vos données sur 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 vers un autre. Pour plus d'informations, voir la documentationPortworx Backup.