Cycle de vie d'un déploiement Marketplace

Ce document explique comment installer, mettre à niveau et désinstaller des packages logiciels Google Distributed Cloud (GDC) Marketplace sous air gap à l'aide de la console GDC. Vous pouvez également installer des packages logiciels à l'aide de la gdcloud marketplace CLI ou de l'API Marketplace.

Ce document est destiné aux audiences du groupe d'opérateurs d'applications qui gèrent le cycle de vie des déploiements Marketplace dans les projets GDC. Pour en savoir plus, consultez la documentation sur les audiences pour GDC sous air gap.

Avant de commencer

Avant de pouvoir installer, mettre à niveau ou désinstaller des packages logiciels Marketplace, vous devez disposer des autorisations nécessaires et préparer votre environnement.

Demander des rôles IAM

Contactez votre administrateur IAM de l'organisation ou votre administrateur IAM de projet pour demander les rôles suivants en fonction des tâches que vous devez effectuer dans votre projet :

• Éditeur Marketplace (marketplace-editor) : installez, mettez à niveau et désinstallez des packages logiciels Marketplace.
• Lecteur de projets (project-viewer) : affichez un projet existant et ses ressources.

L'administrateur IAM de l'organisation peut attribuer ces rôles pour n'importe quel projet de l'organisation. L'administrateur IAM de projet peut attribuer ces rôles dans le champ d'application de son projet spécifique.

Préparer votre environnement

Les tâches de cette page utilisent principalement la console GDC. Si vous prévoyez d'utiliser les alternatives de ligne de commande, procédez comme suit :

• Téléchargez et installez la CLI gdcloud, si ce n'est pas déjà fait.
• Pour utiliser l'API avec kubectl, une configuration supplémentaire est requise :
  • Installez la CLI kubectl.
  • Générez un fichier kubeconfig.

Installer un package logiciel Distributed Cloud Marketplace

Pour installer un package logiciel à partir de Distributed Cloud Marketplace, procédez comme suit :

Console

1. Dans le sélecteur de projet de la console GDC, sélectionnez le projet dans lequel vous souhaitez installer le package logiciel.
2. Dans Distributed Cloud Marketplace, accédez à la page de la fiche du produit que vous souhaitez installer. Sur cette page, vous pouvez consulter les détails du produit et suivre les liens vers sa documentation, ses tarifs et ses conditions d'utilisation.
3. Si vous installez ce produit pour la première fois, cliquez sur Installer. Sinon, accédez à l'onglet "Gestion" et cliquez sur Nouvelle instance.
4. Dans la boîte de dialogue, sélectionnez le cluster d'utilisateur dans lequel vous souhaitez installer le package logiciel. Si vous souhaitez personnaliser sa configuration, cliquez sur Suivant. Si vous souhaitez utiliser la configuration par défaut, cliquez sur Installer.
5. Si vous avez cliqué sur Suivant, vous pouvez maintenant examiner la configuration par défaut. Cliquez sur Configuration personnalisée pour saisir vos propres paramètres, en suivant la documentation du fournisseur. Lorsque vous avez terminé, cliquez sur Installer pour procéder à l'installation. Pour les packages logiciels Kubernetes, les paramètres que vous configurez ici remplacent les valeurs par défaut fournies par le fournisseur dans son fichier de valeurs Helm.

6. Patientez quelques minutes jusqu'à ce que votre nouvelle instance soit marquée comme Prête dans l'onglet Gestion de la page.

   

7. Consultez la documentation du fournisseur de logiciels concerné pour découvrir comment utiliser sa solution une fois qu'elle est installée.

gdcloud

1. Sélectionnez le projet dans lequel vous souhaitez installer le package logiciel :

   gdcloud config set project PROJECT_NAME
   

   Remplacez PROJECT_NAME par le nom du projet dans lequel vous souhaitez installer le package logiciel.

2. Répertoriez les applications Marketplace disponibles :

   gdcloud marketplace services list
   

3. Installez l'application sélectionnée dans la liste, en spécifiant le cluster cible :

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Pour fournir des remplacements de configuration personnalisés lors de l'installation, utilisez l'option --parameters-file :

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Remplacez les éléments suivants :

   • SERVICE_NAME : nom du service Marketplace à installer (par exemple, dataproc)
   • CLUSTER_NAME : nom du cluster d'utilisateur cible dans lequel vous souhaitez installer l'application
   • PATH_TO_PARAMETERS_FILE : chemin d'accès à un fichier YAML contenant des paramètres de remplacement de configuration pour l'instance de service

4. Vérifiez l'installation :

   gdcloud marketplace services list
   

   Vérifiez que l'application nouvellement installée apparaît dans la liste avec l'état READY ou INSTALLED.

API

1. Répertoriez les ressources ServiceVersion disponibles pour trouver le service et la version spécifiques que vous souhaitez installer :

   kubectl get serviceversions -n mkt-system
   

2. Créez un fichier manifeste YAML pour une ressource ServiceInstance (par exemple, service-instance.yaml) :

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Remplacez les éléments suivants :

   • INSTANCE_NAME : nom de votre nouvelle instance d'application
   • CLUSTER_NAME : nom du cluster d'utilisateur cible dans lequel vous souhaitez installer l'application
   • CLUSTER_NAMESPACE : espace de noms du cluster (par exemple, production-cluster)
   • SERVICE_VERSION_NAME : nom de la ServiceVersion à installer (par exemple, dataproc-1.0.0)
   • KEY : nom du paramètre de remplacement de configuration, en suivant le schéma des valeurs Helm du fournisseur
   • VALUE : valeur du paramètre de remplacement de configuration

   Pour en savoir plus et obtenir un exemple de fichier manifeste, consultez la présentation de l'API Marketplace.

3. Appliquez le fichier manifeste au projet :

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Remplacez PROJECT_NAME par le nom du projet dans lequel vous souhaitez installer le package logiciel.

4. Vérifiez l'installation en inspectant l'état de l'objet ServiceInstance :

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Vérifiez que status.conditions contient une condition de type Ready avec l'état "True" et que status.installedVersion affiche la version installée.

Remarque : Si vous avez besoin de savoir quelle image de conteneur est disponible dans GDC, consultez la liste des images Marketplace incluses dans votre version de GDC. Les images incluses dans les versions précédentes de GDC restent disponibles, même après une mise à niveau de GDC.

Reconfigurer une instance d'un package logiciel Distributed Cloud Marketplace

**Avertissement** : Bien que vous puissiez reconfigurer une instance en cours d'exécution d'un package logiciel Distributed Cloud Marketplace, le processus de reconfiguration est mis en œuvre par le fournisseur qui a publié le produit. Le processus de reconfiguration varie donc d'un package logiciel à l'autre. Nous vous recommandons de lire attentivement la documentation du fournisseur concerné avant de procéder à une reconfiguration. Selon la manière dont le fournisseur a mis en œuvre son processus de reconfiguration, vous pouvez rencontrer des temps d'arrêt dans le service fourni.

Certains packages logiciels Distributed Cloud Marketplace peuvent être reconfigurés lorsqu'ils sont déjà en cours d'exécution. Pour les services basés sur Kubernetes, cela équivaut à appliquer de nouvelles valeurs au graphique Helm du fournisseur.

Pour reconfigurer une instance en cours d'exécution d'un package logiciel Distributed Cloud Marketplace, procédez comme suit :

1. Dans le sélecteur de projet de la console GDC, sélectionnez le projet dans lequel vous souhaitez mettre à niveau le package logiciel.
2. Sur la page Distributed Cloud Marketplace, accédez à la page de la fiche du produit que vous souhaitez mettre à niveau.
3. Cliquez sur l'onglet Gestion.
4. Cliquez sur Fichier de configuration pour l'instance que vous souhaitez reconfigurer.
5. Dans le panneau qui s'ouvre, saisissez vos paramètres personnalisés, en suivant la documentation du fournisseur.
6. Cliquez sur Enregistrer pour appliquer les nouveaux paramètres. La reconfiguration s'effectue en quelques minutes.

Mettre à niveau un package logiciel Distributed Cloud Marketplace

Avertissement : Bien que vous puissiez déclencher la mise à niveau d'un package logiciel à l'aide de Distributed Cloud Marketplace, le processus de mise à niveau est mis en œuvre par le fournisseur qui a publié le produit. Le processus de mise à niveau varie donc d'un package logiciel à l'autre. Nous vous recommandons de lire attentivement les notes de version et la documentation de mise à niveau du fournisseur concerné avant de procéder à une mise à niveau. Selon la manière dont le fournisseur a mis en œuvre son processus de mise à niveau, vous pouvez rencontrer des temps d'arrêt dans le service fourni ou des problèmes de compatibilité entre les versions anciennes et les plus récentes.

Certains packages logiciels Distributed Cloud Marketplace peuvent être mis à niveau vers une nouvelle version via Google Distributed Cloud Marketplace une fois que votre opérateur d'infrastructure met ces nouvelles versions à votre disposition.

Pour mettre à niveau un package logiciel Distributed Cloud Marketplace, procédez comme suit :

1. Dans le sélecteur de projet de la console GDC, sélectionnez le projet dans lequel vous souhaitez mettre à niveau le package logiciel.
2. Sur la page Distributed Cloud Marketplace, accédez à la page de la fiche du produit que vous souhaitez mettre à niveau.
3. Cliquez sur l'onglet Gestion.
4. Cliquez sur Mettre à niveau sur l'instance que vous souhaitez mettre à niveau. La mise à niveau s'effectue en quelques minutes.

Remarque : La mise à niveau d'un package logiciel via la console Distributed Cloud entraîne l'installation de la prochaine version disponible du logiciel. Si plusieurs nouvelles versions du logiciel sont disponibles, vous devez répéter le processus pour chacune d'elles. Si nécessaire, utilisez l'API Marketplace pour effectuer une mise à niveau vers une version spécifique.

Désinstaller un package logiciel Distributed Cloud Marketplace

Avertissement : La désinstallation d'un package logiciel Distributed Cloud Marketplace est une action destructrice qui peut entraîner une perte de données ou un temps d'arrêt des systèmes dépendant de ce logiciel. Avant de continuer, assurez-vous d'avoir sauvegardé toutes les données importantes et qu'aucun système important ne dépend du logiciel que vous souhaitez désinstaller. Consultez la documentation du fournisseur concerné pour savoir comment sauvegarder les données gérées par son logiciel.

Pour désinstaller un package logiciel Distributed Cloud Marketplace, procédez comme suit :

1. Dans le sélecteur de projet de la console GDC, sélectionnez le projet à partir duquel vous souhaitez désinstaller le package logiciel.
2. Sur la page Distributed Cloud Marketplace, accédez à la page de la fiche du produit que vous souhaitez désinstaller.
3. Cliquez sur l'onglet Gestion.
4. Cliquez sur Désinstaller pour l'instance que vous souhaitez désinstaller. Le package logiciel est désinstallé en quelques minutes.