Skip to main content
NetApp Automation
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Cloud Volumes ONTAP pour Google Cloud - en rafale vers le cloud

Contributeurs netapp-aoife dmp-netapp
PDF

Cet article présente la solution d'automatisation NetApp Cloud Volumes ONTAP pour Google Cloud, disponible auprès des clients NetApp dans le catalogue d'automatisation BlueXP .

La solution d'automatisation Cloud Volumes ONTAP pour Google Cloud automatise le déploiement conteneurisé d'Cloud Volumes ONTAP pour Google Cloud, ce qui vous permet de déployer rapidement Cloud Volumes ONTAP pour Google Cloud sans aucune intervention manuelle.

Avant de commencer

  • Vous devez télécharger la "Cloud Volumes ONTAP pour Google Cloud - en rafale vers le cloud"solution d'automatisation via l'interface utilisateur Web de BlueXP . La solution est fournie en tant que cvo_gcp_flexcache.zip.

  • Vous devez installer une machine virtuelle Linux sur le même réseau que Cloud Volumes ONTAP.

  • Après avoir installé la machine virtuelle Linux, vous devez suivre les étapes de cette solution pour installer les dépendances requises.

Étape 1 : installez Docker et Docker compose

Installez Docker

Les étapes suivantes utilisent le logiciel de distribution Ubuntu 20.04 Debian Linux comme exemple. Les commandes que vous exécutez dépendent du logiciel de distribution Linux que vous utilisez. Reportez-vous à la documentation spécifique du logiciel de distribution Linux pour votre configuration.

Étapes

  1. Installez Docker en exécutant les commandes suivantes :

    sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

  2. Vérifiez l'installation :

    docker –version

  3. Vérifiez qu'un groupe nommé « docker » a été créé sur votre système Linux. Si nécessaire, créez le groupe :

    sudo groupadd docker

  4. Ajoutez l'utilisateur qui doit accéder à Docker au groupe :

    sudo usermod -aG docker $(whoami)

  5. Vos modifications sont appliquées une fois que vous vous êtes déconnecter et que vous vous êtes de nouveau connecté au terminal. Vous pouvez également appliquer les modifications immédiatement :

    newgrp docker

Installez Docker compose

Étapes

  1. Installez Docker compose en exécutant les commandes suivantes sudo :

    sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

  2. Vérifiez l'installation :

    docker-compose –version

Étape 2 : préparez l'image Docker

Étapes

  1. Copiez le cvo_gcp_flexcache.zip dossier sur la machine virtuelle Linux que vous souhaitez utiliser pour déployer Cloud Volumes ONTAP :

    scp -i ~/private-key.pem -r cvo_gcp_flexcache.zip gcpuser@IP_ADDRESS_OF_VM:LOCATION_TO_BE_COPIED

    • private-key.pem est votre fichier de clé privée pour la connexion sans mot de passe.

    • gcpuser Est le nom d'utilisateur de la machine virtuelle.

    • IP_ADDRESS_OF_VM Est l'adresse IP de la machine virtuelle.

    • LOCATION_TO_BE_COPIED est l'emplacement où le dossier sera copié.

  2. Extraire le cvo_gcp_flexcache.zip dossier. Vous pouvez extraire le dossier dans le répertoire actuel ou dans un emplacement personnalisé.

    Pour extraire le dossier dans le répertoire actuel, exécutez :

    unzip cvo_gcp_flexcache.zip

    Pour extraire le dossier dans un emplacement personnalisé, exécutez :

    unzip cvo_gcp_flexcache.zip -d ~/<your_folder_name>

  3. Une fois le contenu extrait, exécutez la commande suivante pour afficher les fichiers :

     ls -la

    Vous devriez voir une liste de fichiers, similaire à l'exemple suivant :

        total 32
    drwxr-xr-x   8 user  staff   256 Mar 23 12:26 .
    drwxr-xr-x   6 user  staff   192 Mar 22 08:04 ..
    -rw-r--r--   1 user  staff   324 Apr 12 21:37 .env
    -rw-r--r--   1 user  staff  1449 Mar 23 13:19 Dockerfile
    drwxr-xr-x  15 user  staff   480 Mar 23 13:19 cvo_gcp_source_code
    drwxr-xr-x   4 user  staff   128 Apr 27 13:43 cvo_gcp_variables
    -rw-r--r--   1 user  staff   996 Mar 24 04:06 docker-compose-deploy.yml
    -rw-r--r--   1 user  staff  1041 Mar 24 04:06 docker-compose-destroy.yml

  4. Localisez le cvo_gcp_flexcache_ubuntu_image.tar fichier. Ce document contient l'image Docker requise pour déployer Cloud Volumes ONTAP pour Google Cloud.

  5. Décompressez le fichier :

    docker load -i cvo_gcp_flexcache_ubuntu_image.tar

  6. Attendez quelques minutes que l'image Docker se charge, puis vérifiez que l'image Docker a bien été chargée :

    docker images

    Vous devez voir une image Docker nommée cvo_gcp_flexcache_ubuntu_image avec la latest balise, comme dans l'exemple suivant :

    REPOSITORY                            TAG        IMAGE ID       CREATED      SIZE
    cvo_gcp_flexcache_ubuntu_image     latest    18db15a4d59c   2 weeks ago   1.14GB
    Remarque Vous pouvez modifier le nom de l'image Docker si nécessaire. Si vous modifiez le nom de l'image Docker, veillez à mettre à jour le nom de l'image Docker dans les docker-compose-deploy fichiers et docker-compose-destroy.

Étape 3 : mettez à jour le fichier JSON

À ce stade, vous devez mettre à jour cxo-automation-gcp.json le fichier avec une clé de compte de service pour authentifier le fournisseur Google Cloud.

  1. Créez un compte de service avec les autorisations de déploiement de Cloud Volumes ONTAP et de BlueXP  Connector. "En savoir plus sur la création de comptes de service."

  2. Téléchargez le fichier de clé pour le compte et mettez à jour le cxo-automation-gcp.json fichier avec les informations du fichier de clé. Le cxo-automation-gcp.json fichier se trouve dans le cvo_gcp_variables dossier.

    Exemple
    {
  "type": "service_account",
  "project_id": "",
  "private_key_id": "",
  "private_key": "",
  "client_email": "",
  "client_id": "",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "",
  "universe_domain": "googleapis.com"
}

    Le format de fichier doit être exactement comme indiqué ci-dessus.

Étape 4 : abonnez-vous à BlueXP 

Vous pouvez vous abonner à NetApp BlueXP  sur Google Cloud Marketplace.

Étapes

  1. Accédez à "Console Google Cloud"et sélectionnez s'abonner à NetApp BlueXP .

  2. Configurez le portail BlueXP  pour importer l'abonnement SaaS vers BlueXP .

    Vous pouvez le configurer directement à partir de Google Cloud Platform. Vous serez redirigé vers le portail BlueXP  pour confirmer la configuration.

  3. Confirmez la configuration dans le portail BlueXP  en sélectionnant Enregistrer.

Pour plus d'informations, voir "Gérez les identifiants Google Cloud et les abonnements pour BlueXP".

Étape 5 : activation des API Google Cloud requises

Dans votre projet, vous devez activer les API Google Cloud suivantes pour déployer Cloud Volumes ONTAP et le connecteur.

  • API Cloud Deployment Manager V2

  • API de journalisation cloud

  • API Cloud Resource Manager

  • API du moteur de calcul

  • API de gestion des identités et des accès

"En savoir plus sur l'activation des API"

Étape 6 : créer un volume externe

Vous devez créer un volume externe pour conserver les fichiers d'état Terraform et d'autres fichiers importants persistants. Vous devez vous assurer que les fichiers sont disponibles pour Terraform pour exécuter le workflow et les déploiements.

Étapes

  1. Créer un volume externe en dehors de Docker compose :

    docker volume create <volume_name>

    Exemple :

    docker volume create cvo_gcp_volume_dst

  2. Utilisez l'une des options suivantes :

    1. Ajoutez un chemin de volume externe au .env fichier d'environnement.

      Vous devez suivre le format exact indiqué ci-dessous.

      Format :

      PERSISTENT_VOL=path/to/external/volume:/cvo_gcp

      Exemple :
      PERSISTENT_VOL=cvo_gcp_volume_dst:/cvo_gcp

    2. Ajoutez des partages NFS comme volume externe.

      Assurez-vous que le conteneur Docker peut communiquer avec les partages NFS et que les autorisations appropriées, telles que lecture/écriture, sont configurées.

      1. Ajoutez le chemin des partages NFS comme chemin d'accès au volume externe dans le fichier Docker compose, comme illustré ci-dessous : format :

        PERSISTENT_VOL=path/to/nfs/volume:/cvo_gcp

    Exemple :
    PERSISTENT_VOL=nfs/mnt/document:/cvo_gcp

  3. Accédez au cvo_gcp_variables dossier.

    Le dossier doit contenir les fichiers suivants :

    • terraform.tfvars

    • variables.tf

  4. Modifiez les valeurs à l'intérieur du terraform.tfvars fichier en fonction de vos besoins.

    Vous devez lire la documentation spécifique lors de la modification de l'une des valeurs de variable du terraform.tfvars fichier. Ces valeurs peuvent varier en fonction de la région, des zones de disponibilité et d'autres facteurs pris en charge par Cloud Volumes ONTAP pour Google Cloud. Notamment les licences, la taille des disques et la taille des machines virtuelles pour les nœuds uniques et les paires haute disponibilité.

    Toutes les variables de support pour les modules Connector et Cloud Volumes ONTAP Terraform sont déjà définies dans le variables.tf fichier. Vous devez vous référer aux noms de variable dans le variables.tf fichier avant de l'ajouter au terraform.tfvars fichier.

  5. Selon vos besoins, vous pouvez activer ou désactiver FlexCache et FlexClone en définissant les options suivantes sur true ou false.

    Les exemples suivants activent FlexCache et FlexClone :

    • is_flexcache_required = true

    • is_flexclone_required = true

Étape 7 : déploiement de Cloud Volumes ONTAP pour Google Cloud

Procédez comme suit pour déployer Cloud Volumes ONTAP pour Google Cloud.

Étapes

  1. Depuis le dossier racine, exécutez la commande suivante pour déclencher le déploiement :

    docker-compose -f docker-compose-deploy.yml up -d

    Deux conteneurs sont déclenchés, le premier conteneur déploie Cloud Volumes ONTAP et le second envoie des données de télémétrie à AutoSupport.

    Le deuxième conteneur attend jusqu'à ce que le premier conteneur termine toutes les étapes avec succès.

  2. Surveiller la progression du processus de déploiement à l'aide des fichiers journaux :

    docker-compose -f docker-compose-deploy.yml logs -f

    Cette commande fournit des résultats en temps réel et capture les données dans les fichiers journaux suivants :
    deployment.log

    telemetry_asup.log

    Vous pouvez modifier le nom de ces fichiers journaux en modifiant le .env fichier à l'aide des variables d'environnement suivantes :

    DEPLOYMENT_LOGS

    TELEMETRY_ASUP_LOGS

    Les exemples suivants montrent comment modifier les noms des fichiers journaux :

    DEPLOYMENT_LOGS=<your_deployment_log_filename>.log

    TELEMETRY_ASUP_LOGS=<your_telemetry_asup_log_filename>.log

Une fois que vous avez terminé

Vous pouvez utiliser les étapes suivantes pour supprimer l'environnement temporaire et nettoyer les éléments créés pendant le processus de déploiement.

Étapes

  1. Si vous avez déployé FlexCache, définissez l'option suivante dans le terraform.tfvars fichier, cela nettoie les volumes FlexCache et supprime l'environnement temporaire créé précédemment.

    flexcache_operation = "destroy"

    Remarque Les options possibles sont deploy et destroy.

  2. Si vous avez déployé FlexClone, définissez l'option suivante dans le terraform.tfvars fichier, cela nettoie les volumes FlexClone et supprime l'environnement temporaire créé précédemment.

    flexclone_operation = "destroy"

    Remarque Les options possibles sont deploy et destroy.