Cette procédure montre comment configurer l'intégration de GitLab dans Cloud Assembly afin d'utiliser des modèles de cloud dans le référentiel et de télécharger automatiquement les modèles enregistrés qui sont associés aux projets désignés. Pour utiliser des modèles de cloud avec GitLab, vous devez créer une connexion à une instance GitLab appropriée, puis enregistrer les modèles souhaités dans cette instance.

Lorsque l'intégration de GitLab est configurée avec un référentiel existant, tous les modèles de cloud associés aux projets sélectionnés deviennent disponibles pour les utilisateurs qualifiés. Vous pouvez utiliser ces modèles avec un déploiement existant ou comme base d'un nouveau déploiement. Lorsque vous ajoutez un projet, vous devez sélectionner certaines propriétés définissant son emplacement et la façon dont il est stocké dans GitLab.

Note : Vous ne pouvez pas transférer de nouveaux modèles de cloud ou des modèles mis à jour vers le référentiel Git à partir de Cloud Assembly. Par ailleurs, vous ne pouvez pas transférer de nouveaux modèles vers le référentiel à partir de Cloud Assembly. Pour ajouter des modèles de cloud à un référentiel, les développeurs doivent utiliser l'interface Git.

Si vous mettez à jour le brouillon d'un modèle de cloud importé à partir de Git et que son contenu diffère de celui de la version supérieure, le brouillon n'est pas mis à jour lors des synchronisations suivantes et une nouvelle version est créée. Si vous souhaitez mettre à jour un modèle de cloud et autoriser également une synchronisation avancée à partir de Git, vous devez créer une version après avoir apporté les modifications finales.

Après avoir configuré les modèles de cloud à utiliser avec GitLab et collecté les informations requises, vous devez configurer l'intégration avec votre instance de GitLab. Vous pouvez ensuite importer les modèles de cloud désignés dans GitLab. Vous pouvez afficher une démonstration vidéo de cette procédure à l'adresse https://www.youtube.com/watch?v=h0vqo63Sdgg.

Conditions préalables

  • Extrayez une clé API pour le référentiel applicable. Dans votre compte GitLab, cliquez sur votre nom de connexion dans le coin supérieur droit de l'écran pour accéder au menu Paramètres. Sélectionnez Jetons d'accès, puis nommez votre jeton et définissez une date d'expiration. Sélectionnez ensuite une API et créez le jeton. Copiez la valeur résultat et enregistrez-la.
Vous devez disposer d'un référentiel Git local approprié, configuré avec un accès pour tous les utilisateurs désignés, à des fins de configuration de l'intégration de Git à Cloud Assembly. De plus, vous devez créer et enregistrer vos modèles de cloud dans une structure spécifique afin qu'ils soient détectés par GitLab.

Procédure

  1. Configurez l'intégration avec votre environnement GitLab dans Cloud Assembly.
    1. Sélectionnez Infrastructure > Intégrations > Ajouter une intégration et choisissez GitLab.
    2. Entrez l'URL de votre instance de GitLab. En général, l'URL d'une instance de GitLab SaaS (software-as-a-service) est gitlab.com.
    3. Entrez le jeton (également appelé « clé API ») correspondant à l'instance GitLab spécifiée. Reportez-vous aux conditions préalables ci-dessus pour obtenir des informations sur l'extraction du jeton à partir de l'instance GitLab.
    4. Ajoutez un nom et une description appropriés.
    5. Cliquez sur Valider pour vérifier la connexion.
    6. Ajoutez des balises de capacité si vous le souhaitez. Pour plus d'informations, reportez-vous à la section Utilisation de balises de capacité dans Cloud Assembly.
    7. Cliquez sur Ajouter.
  2. Configurez la connexion GitLab pour accepter des modèles de cloud dans un référentiel approprié.
    1. Sélectionnez Infrastructure > Intégrations et choisissez l'intégration de GitLab appropriée.
    2. Sélectionnez Projets.
    3. Sélectionnez Nouveau projet et créez un nom pour le projet.
    4. Entrez le chemin du référentiel dans GitLab. En général, il s'agit du nom d'utilisateur du compte principal ajouté au nom du référentiel.
    5. Entrez la branche de GitLab que vous souhaitez utiliser.
    6. Le cas échéant, entrez un nom de dossier. Si ce champ est laissé vide, tous les dossiers sont disponibles.
    7. Entrez un type approprié. Le cas échéant, entrez un nom de dossier. Si ce champ est laissé vide, tous les dossiers sont disponibles.
    8. Cliquez sur Suivant pour terminer l'ajout du référentiel.
      Lorsque vous cliquez sur Suivant, une tâche de synchronisation automatisée qui importe les modèles de cloud dans la plate-forme est lancée.
      Lorsque les tâches de synchronisation sont terminées, un message indique que les modèles de cloud ont été importés.

Résultats

Vous pouvez maintenant récupérer des modèles de cloud de GitLab.