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) air gap Marketplace à l'aide de la console GDC. Vous pouvez également installer des packages logiciels à l'aide de la CLI gdcloud marketplace ou de l'API Marketplace.

Ce document s'adresse aux membres 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 d'organisation IAM ou votre administrateur de projet IAM pour demander les rôles suivants en fonction des tâches que vous devez effectuer dans votre projet :

• Éditeur Marketplace (marketplace-editor) : installe, met à niveau et désinstalle les packages logiciels Marketplace.
• Lecteur de projets (project-viewer) : permet d'afficher un projet existant et ses ressources.

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

Préparer votre environnement

Les tâches décrites sur 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 la place de marché Distributed Cloud, 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 la place de marché Distributed Cloud, 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", puis 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 de l'éditeur de logiciels concerné pour savoir 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 sur lequel vous souhaitez installer l'application.
   • PATH_TO_PARAMETERS_FILE : chemin d'accès à un fichier YAML contenant les paramètres de remplacement de la configuration pour l'instance de service.

4. Vérifiez l'installation :

   gdcloud marketplace services list
   

   Vérifiez que l'application que vous venez d'installer 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 sur lequel vous souhaitez installer l'application.
   • CLUSTER_NAMESPACE : espace de noms du cluster (par exemple, production-cluster)
   • SERVICE_VERSION_NAME : nom du ServiceVersion à installer (par exemple, dataproc-1.0.0)
   • KEY : nom du paramètre de remplacement de la configuration, selon le schéma de valeurs Helm du fournisseur.
   • VALUE : valeur du paramètre de remplacement de la 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 logiciel à l'autre. Nous vous recommandons de lire attentivement la documentation du fournisseur concerné avant de procéder à une reconfiguration. Selon la façon dont le fournisseur a implémenté son processus de reconfiguration, vous pouvez rencontrer des temps d'arrêt dans le service fourni.

Certains packages logiciels de la place de marché Distributed Cloud 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 chart 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 de la place de marché Distributed Cloud, 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 se termine 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 à un 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 façon dont le fournisseur a implémenté son processus de mise à niveau, vous pouvez rencontrer des temps d'arrêt du service fourni ou des problèmes de compatibilité entre les anciennes et les nouvelles versions.

Certains packages logiciels de la place de marché Distributed Cloud peuvent être mis à niveau vers une nouvelle version via la place de marché Google Distributed Cloud une fois que votre opérateur d'infrastructure a mis 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 de la place de marché Distributed Cloud, 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 la procédure pour chacune d'elles. Si nécessaire, utilisez l'API Marketplace pour passer à 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 de la place de marché Distributed Cloud, procédez comme suit :

1. Dans le sélecteur de projet de la console GDC, sélectionnez le projet duquel vous souhaitez désinstaller le package logiciel.
2. Sur la page de la place de marché Distributed Cloud, 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.