Gérer les versions d'un connecteur personnalisé

Créer une version personnalisée du connecteur

Pour créer une version de connecteur personnalisée, procédez comme suit :

  1. Dans la console, accédez à la page Integration Connectors > Custom connectors (Connecteurs d'intégration > Connecteurs personnalisés), puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connecteurs personnalisés"

    La liste des connecteurs personnalisés s'affiche.

  2. Cliquez sur le connecteur personnalisé auquel vous souhaitez ajouter une version.

    affiche la page des détails de la connexion.

  3. Cliquez sur Versions.

    La page affiche toutes les versions du connecteur.

  4. Cliquez sur Créer. La page Créer une version contenant la nouvelle version s'affiche. numéro. La procédure de création d'une version est semblable à celle de création d'un connecteur personnalisé. Cela signifie que vous pouvez créer une version avec une connectivité directe ou indirecte.

Gérer une version de connecteur personnalisée

Pour modifier un connecteur personnalisé, procédez comme suit:

  1. Dans la console, accédez à la page Connecteurs d'intégration > Connecteurs personnalisés ; puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connecteurs personnalisés"

    La liste des connecteurs personnalisés s'affiche.

  2. Cliquez sur le connecteur personnalisé dont les versions sont disponibles.

    La page des détails de la connexion s'affiche.

  3. Cliquez sur Versions.

    Les versions du connecteur sélectionné s'affichent.

  4. Cliquez sur  Actions pour sélectionner l'une des options suivantes :
    • Afficher les détails : pour afficher les détails de la version du connecteur personnalisé.
    • Abandonner la version: pour abandonner la version.
    • Supprimer : pour supprimer la version.
    • Exporter: permet de télécharger la version du connecteur sous forme de fichier de spécification JSON. Pour en savoir plus, consultez la section Exporter et importer.

Exporter et importer

Vous pouvez partager le connecteur entre différents projets Google Cloud en exportant et en important la spécification du connecteur. Vous pouvez exporter n'importe quelle version de connexion, puis importer la spécification dans le même projet ou dans différents projets Google Cloud. Il n'est pas possible d'exporter des versions de connecteur obsolètes.

Rôles et autorisations requis

Pour obtenir les autorisations nécessaires pour exporter et importer un connecteur personnalisé, demandez à votre administrateur de vous accorder les rôles IAM suivants :

  • Administrateur des objets Storage (roles/storage.objectAdmin) sur le bucket Cloud Storage
  • Security Admin (roles/iam.securityAdmin) sur le projet dans lequel le secret est présent. Vous pouvez également demander à votre administrateur de vous accorder, à vous ou au compte de service, les autorisations secretmanager.secrets.getIamPolicy et secretmanager.secrets.setIamPolicy sur le projet dans lequel se trouve le secret.

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Exporter un connecteur personnalisé

Pour exporter une version de connecteur, procédez comme suit :

  1. Dans la console, accédez à la page Integration Connectors > Custom connectors (Connecteurs d'intégration > Connecteurs personnalisés), puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connecteurs personnalisés"

  2. Cliquez sur le connecteur personnalisé que vous souhaitez exporter. La page de présentation du connecteur personnalisé s'ouvre.
  3. Cliquez sur Versions. Une liste des versions du connecteur personnalisé s'affiche.
  4. Cliquez sur Autres actions, puis sur Exporter. Un fichier de spécification JSON correspondant au connecteur personnalisé est téléchargé.

Importer un connecteur personnalisé

Pour importer une version de connecteur, procédez comme suit :

  1. Dans la console, accédez à la page Integration Connectors > Custom connectors (Connecteurs d'intégration > Connecteurs personnalisés), puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connecteurs personnalisés"

    2. La page Connecteurs personnalisés s'affiche.
  2. Cliquez sur Import (Importer).
  3. Parcourez et sélectionnez le fichier de spécification JSON du connecteur personnalisé. Si vous importez le connecteur dans un autre projet, le champ Compte de service n'est pas prérempli.

    Selon que le connecteur existe déjà ou non, les scénarios suivants sont possibles :

    • Aucun connecteur du même nom n'existe:la page Créer un connecteur personnalisé s'affiche. La version du connecteur dans le fichier JSON importé est préremplie. Cette version ne peut pas être modifiée.
    • Un connecteur du même nom existe, mais la même version n'existe pas:la page Créer une version s'affiche pour ce connecteur. Les propriétés du connecteur telles que le type, le nom et la description sont préremplies à partir du connecteur existant et ne sont pas remplacées par le fichier JSON importé. Toutefois, les détails de la version du connecteur et son nom sont lus à partir du fichier JSON importé. Vous ne pouvez modifier que le nom de la version.
    • Un connecteur portant le même nom et la même version existe : un message d'avertissement s'affiche, indiquant que la version existe déjà et qu'une nouvelle version sera utilisée lorsque vous importerez la spécification JSON. Si vous cliquez sur Importer, la page Créer une version de ce connecteur s'affiche. Les propriétés du connecteur, telles que le type, le nom et la description, sont préremplies à partir du connecteur existant et ne sont pas écrasées par le fichier JSON importé. Toutefois, les détails de la version sont lus à partir du fichier JSON importé et peuvent être modifiés. Le numéro de la dernière version disponible est utilisé pour le nom de la version.
  4. Renseignez les informations restantes, puis cliquez sur Créer. Le connecteur est créé avec la spécification JSON importée.