Gérer les packages

Cette page explique comment gérer les packages avec Config Sync depuis la console Google Cloud .

Un package est un ensemble de fichiers manifestes d'objets de ressources Kubernetes qui sont gérés dans une source de vérité et synchronisés avec un cluster par Config Sync. Chaque définition de package est contenue dans un objet RootSync ou RepoSync sur le cluster. Pour en savoir plus sur les objets RootSync et RepoSync, consultez la section Architecture de Config Sync.

Avant de commencer

Déployer un package

Une fois que vous avez enregistré vos clusters dans un parc et installé Config Sync, vous pouvez configurer Config Sync pour déployer un package sur un cluster à partir d'une source fiable. Vous pouvez déployer le même package sur plusieurs clusters ou différents packages sur différents clusters. Vous pouvez modifier un package après l'avoir déployé, à l'exception de certains paramètres tels que le nom du package et le type de synchronisation. Pour en savoir plus, consultez la section Gérer les packages.

Pour déployer un package, procédez comme suit :

  1. Dans la console Google Cloud , accédez au tableau de bord Config Sync.

    Accéder au tableau de bord Config Sync

  2. Cliquez sur Déployer le package.

  3. Dans le tableau Sélectionner des clusters pour le déploiement de packages, sélectionnez le cluster sur lequel vous souhaitez déployer un package, puis cliquez sur Continuer.

  4. Sélectionnez Package hosted on Git (Package hébergé sur Git) ou Package hosted on OCI (Package hébergé sur OCI) comme type de source, puis cliquez sur Continue (Continuer).

  5. Dans la section Détails du package, saisissez un nom de package, qui identifie l'objet RootSync ou RepoSync.

  6. Dans le champ Type de synchronisation, sélectionnez Synchronisation de portée cluster ou Synchronisation de portée espace de noms comme type de synchronisation.

    La synchronisation à l'échelle du cluster crée un objet RootSync, tandis que la synchronisation à l'échelle de l'espace de noms crée un objet RepoSync. Pour en savoir plus sur ces objets, consultez la section Architecture de Config Sync.

  7. Dans la section Source, configurez les éléments suivants :

    • Pour les sources hébergées dans un dépôt Git, renseignez les champs suivants :

      1. Dans le champ URL du dépôt, saisissez l'URL du dépôt Git que vous utilisez comme source de vérité.
      2. Facultatif : Mettez à jour le champ Révision pour vérifier si vous n'utilisez pas la valeur par défaut HEAD.
      3. Facultatif : Mettez à jour le champ Chemin d'accès si vous ne souhaitez pas synchroniser à partir du dépôt racine.
      4. Facultatif : mettez à jour le champ Branche si vous n'utilisez pas la branche main par défaut.

    • Pour les sources hébergées dans une image OCI, saisissez les champs suivants :

      1. Saisissez l'URL de l'image OCI que vous utilisez comme source fiable en tant qu'image.
      2. Saisissez le chemin du répertoire à synchroniser, associé au répertoire racine, dans le champ Répertoire.

  8. Facultatif : Développez la section Paramètres avancés pour effectuer les opérations suivantes :

    1. Sélectionnez un type d'authentification. Config Sync a besoin d'un accès en lecture seule à votre source fiable pour lire les fichiers de configuration de la source et les appliquer à vos clusters. À moins que votre source ne nécessite aucune authentification, telle qu'un dépôt public, veillez à accorder à Config Sync un accès en lecture seule à votre dépôt Git, Image OCI ougraphique Helm (gcloud CLI uniquement). Choisissez le même type d'authentification que celui configuré lors de l'installation de Config Sync :

      • Aucune : n'utilisez aucune authentification
      • SSH : authentifiez-vous à l'aide d'une paire de clés SSH.
      • Cookiefile : authentifiez-vous à l'aide d'un fichier cookiefile.
      • Jeton : authentifiez-vous à l'aide d'un jeton d'accès ou d'un mot de passe.
      • Google Cloud Repository : utilisez un compte de service Google pour accéder à Cloud Source Repositories. Ne sélectionnez cette option que si Workload Identity Federation for GKE n'est pas activé dans votre cluster.
      • Workload Identity : utilisez un compte de service Google pour accéder à un dépôt Cloud Source Repositories.

    2. Saisissez un nombre en secondes pour définir le temps d'attente de la synchronisation, qui détermine la durée pendant laquelle Config Sync attend entre les tentatives d'extraction à partir de la source fiable.

    3. Saisissez une URL de proxy Git pour le proxy HTTPS à utiliser lors de la communication avec la source de vérité.

    4. Choisissez Hiérarchie pour modifier le format source.

      La valeur par défaut Non structuré est recommandée dans la plupart des cas, car elle vous permet d'organiser votre source de vérité comme vous le souhaitez.

  9. Cliquez sur Déployer le package.

    Vous êtes redirigé vers la page Packages de Config Sync. Après quelques minutes, Synchronisé doit s'afficher dans la colonne État de synchronisation du cluster que vous avez configuré.

Modifier un package

Pour modifier un package que vous avez déjà déployé, procédez comme suit :

  1. Dans la console Google Cloud , accédez à l'onglet Packages Config Sync.

    Accéder à "Packages"

  2. Facultatif : Développez le menu Filtres rapides, puis sélectionnez un filtre pour trouver le package que vous souhaitez modifier.

  3. Développez le nom du package que vous souhaitez modifier, puis, sur la ligne contenant le nom du cluster, cliquez sur le menu contextuel puis sur Modifier le package.

  4. Vérifiez et mettez à jour les paramètres du package que vous souhaitez modifier.

  5. Cliquez sur Enregistrer.

Désinstaller un package

Pour désinstaller un package de la console Google Cloud , procédez comme suit:

  1. Dans la console Google Cloud , accédez à l'onglet Packages Config Sync.

    Accéder à "Packages"

  2. Facultatif : Développez le menu Filtres rapides, puis sélectionnez un filtre pour trouver le package que vous souhaitez désinstaller.

  3. Développez le nom du package que vous souhaitez modifier, puis, sur la ligne contenant le nom du cluster, cliquez sur le menu contextuel puis sur Désinstaller le package.

  4. Dans la boîte de dialogue de confirmation, indiquez si vous souhaitez désinstaller uniquement l'objet RootSync ou RepoSync, ou désinstaller RootSync ou RepoSync et toutes les ressources gérées par RootSync ou RepoSync.

  5. Saisissez le message de confirmation, puis cliquez sur Désinstaller.

Étapes suivantes