Extension d'une architecture déployable lors de l'intégration

Lorsque vous intégrez une architecture déployable à un catalogue privé, vous pouvez choisir de l'étendre en l'empilant avec d'autres architectures. Lorsque vous ajoutez ces autres architectures, vous spécifiez si elles sont nécessaires pour déployer votre architecture comme prévu ou si elles peuvent être utilisées en option pour étendre le cas d'utilisation. Une fois l’intégration terminée, le résultat est une solution de bout en bout robuste composée de plusieurs architectures déployables qui fonctionnent ensemble.

Les architectures déployables que vous souhaitez empiler sont-elles déjà disponibles dans un catalogue? Si tel est le cas, vous pouvez empiler ces architectures dans un projet et intégrer cette solution en tant qu’entrée de catalogue distincte. Actuellement, lorsque vous empilez des architectures déployables dans un projet, l'inclusion d'architectures facultatives ou interchangeables n'est pas prise en charge. Ainsi, cette approche fonctionne mieux si toutes les architectures que vous souhaitez empiler ensemble sont nécessaires pour déployer la solution de bout en bout.

Pourquoi étendre une architecture déployable?

Vous pouvez étendre une architecture déployable pour différentes raisons. Par exemple, si l’architecture que vous intégrez nécessite une dépendance, vous pouvez l’empiler avec l’architecture dont elle dépend. Si la dépendance est répertoriée comme requise, elle est incluse avec votre architecture déployable lorsqu'un utilisateur la configure et la déploie.

De même, pour encourager la sécurité par défaut pour une architecture déployable que vous intégrez, vous pouvez empiler d’autres architectures avec elle qui répondent aux besoins de sécurité. Si les autres architectures déployables sont incluses comme recommandé, cela permet de garantir que les utilisateurs de votre organisation déploient l'architecture d'une manière spécifique avec ces garde-fous de sécurité en place. Les architectures recommandées sont incluses par défaut, mais les utilisateurs peuvent les supprimer.

Vous pouvez également étendre une architecture déployable pour fournir davantage d’options de personnalisation aux utilisateurs afin qu’ils puissent profiter d’un cas d’utilisation étendu. Peut-être que votre architecture fonctionne bien avec une autre architecture déployable qui n’est pas nécessaire pour répondre à une dépendance ou satisfaire à la conformité. Vous pouvez ajouter l'architecture déployable en option et les utilisateurs peuvent choisir de l'inclure lorsqu'ils ajoutent votre architecture déployable à un projet.

Avant de commencer

Au fur et à mesure que vous terminez les étapes d’ intégration de votre architecture déployable à un catalogue privé, vous êtes invité à configurer les détails de la version. Accédez à Étendez votre architecture pour empiler d’autres architectures déployables avec celle que vous intégrez.

Si vous avez déjà intégré votre architecture déployable, modifiez la version dans votre catalogue privé, puis accédez à Étendez votre architecture.

Vous préférez travailler avec du code? Vous pouvez spécifier des détails sur d’autres architectures déployables que vous souhaitez empiler avec celle que vous intégrez dans le fichier manifeste du catalogue. Réglez le dependency_version_2 propriété à true et utilisez le dependencies tableau pour spécifier les architectures que vous souhaitez inclure avec celle que vous intégrez. Pour plus d'informations sur la façon de structurer le manifeste du catalogue, consultez Modification locale de votre fichier manifeste.

Ajout d'architectures déployables

Lorsque vous intégrez une architecture déployable, vous pouvez l’étendre en l’empilant avec d’autres architectures. Spécifiez une relation lorsque vous ajoutez d'autres architectures, puis définissez des variables que les utilisateurs peuvent configurer sur les architectures que vous empilez ensemble. Procédez comme suit :

Lorsque vous intégrez une architecture déployable à un catalogue, dans la section Étendez votre architecture, cliquez sur Ajouter.
Utilisez le menu Produit pour sélectionner l'architecture déployable que vous souhaitez ajouter. Vous pouvez sélectionner n’importe quelle architecture déployable à laquelle votre compte a accès dans vos catalogues.
Sélectionnez une option de relation pour l’architecture déployable que vous ajoutez. L'architecture est obligatoire et ne peut pas être supprimée. C'est facultatif et les utilisateurs peuvent choisir de l'inclure ou non. Ou bien, il est recommandé et inclus par défaut, bien que les utilisateurs puissent choisir de le supprimer. Pour plus d’informations, consultez Spécification d’une relation.
Facultatif : si vous ajoutez deux ou plusieurs architectures déployables interchangeables selon les préférences de l'utilisateur, sélectionnez-les dans le tableau Étendez votre architecture et cliquez sur Regrouper comme interchangeable. Les utilisateurs peuvent sélectionner l’architecture qu’ils souhaitent utiliser en fonction de leurs besoins.
Une fois que vous avez terminé d’ajouter des architectures déployables, cliquez sur Suivant > Définir des variables pour définir des variables pour vos utilisateurs. À partir de là, vous pouvez connecter les architectures déployables ensemble afin que les utilisateurs puissent configurer les entrées dans une seule interface, au lieu de configurer les architectures une par une. Pour plus d'informations, accédez à Définition de variables pour vos utilisateurs.

Spécifier une relation

Lorsque vous empilez des architectures déployables avec celle que vous intégrez, il vous est demandé de spécifier une relation. Quelle est la relation entre l’architecture déployable que vous ajoutez et la solution globale que vous intégrez à votre catalogue privé? Vous pouvez choisir parmi trois options : Obligatoire, Facultatif et Recommandé. Le tableau suivant décrit et explique comment chaque option impacte la personnalisation de la solution de bout en bout lorsqu'un utilisateur ajoute l'architecture à un projet à partir du catalogue privé :

Options de relation expliquées
Option	Description
Obligatoire	Inclus lorsqu'un utilisateur ajoute votre architecture à un projet. L'utilisateur n'est pas en mesure de supprimer les architectures requises car elles sont nécessaires au fonctionnement de votre solution globale comme prévu.
Facultatif	Non inclus par défaut. Les utilisateurs peuvent choisir d’inclure des architectures facultatives s’ils souhaitent profiter d’un cas d’utilisation étendu.
Recommandé	Inclus par défaut, mais les utilisateurs peuvent le supprimer s'ils le souhaitent. Par exemple, vous souhaitez peut-être encourager les déploiements sécurisés en ajoutant IBM Cloud Secrets Manager comme recommandé à votre architecture déployable. Secrets Manager est ensuite inclus par défaut lorsqu'un utilisateur ajoute votre architecture déployable à un projet. Cependant, s'ils disposent d'un autre outil pour gérer les secrets, ou s'ils n'ont pas besoin de Secrets Manager, l'utilisateur peut choisir de l'exclure.

Définir des variables pour vos utilisateurs

Après avoir étendu votre architecture déployable en empilant d’autres architectures avec elle, vous devez définir des variables pour vos utilisateurs. L’objectif final est de lier les architectures déployables entre elles afin que les utilisateurs puissent configurer les entrées dans une seule interface, au lieu de configurer les architectures une par une. Prenez en compte les points suivants :

Quelles entrées au sein des architectures déployables les utilisateurs doivent-ils configurer? Ces entrées doivent être ajoutées à votre produit afin que les utilisateurs puissent les configurer sans modifier les architectures individuelles une par une. Sélectionnez Ajouter au produit pour ce faire.
Quelles architectures déployables doivent être liées entre elles avec des références aux entrées ou aux sorties? Par exemple, si une entrée dans une architecture dépend de la sortie d’une autre, ajoutez une référence dans l’entrée pour la connecter à la sortie. Sélectionnez Référencer une variable pour ce faire.

Seules les entrées que vous ajoutez à votre produit peuvent référencer une sortie. Si vous avez ajouté une architecture et que l’une de ses entrées doit référencer une sortie d’une autre architecture, sélectionnez Ajouter au produit pour cette entrée. Ensuite, sélectionnez Référencer une variable pour l’entrée que vous avez ajoutée. À partir de là, vous pouvez sélectionner l’architecture qui contient la sortie. Sélectionnez Sortie comme type de variable, puis sélectionnez le nom de la sortie à laquelle vous souhaitez que l’entrée fasse référence.
Toutes les entrées requises sont-elles résolues pour les utilisateurs? Pour les entrées requises qui ne sont pas ajoutées au produit, fournissez une valeur fixe ou une référence pour résoudre ces entrées. Cela permet de connecter les architectures au sein de cette solution de bout en bout et de faciliter sa configuration et son déploiement pour les utilisateurs.

Les valeurs par défaut ne peuvent pas être fournies dans la console. Utilisez le default_value propriété dans le configuration tableau dans le fichier manifeste du catalogue pour spécifier les valeurs par défaut. Pour plus d'informations, consultez Modification locale de votre fichier manifeste.
Les utilisateurs ont-ils besoin d’informations supplémentaires sur une variable pour les aider à la configurer? Lorsque vous ajoutez une variable d’entrée à votre produit, vous pouvez modifier la manière dont l’entrée apparaît aux utilisateurs. Souvent, il peut être utile de fournir un nouveau nom pour une variable ou une description, en particulier si deux variables similaires sont incluses. Par exemple, si l’architecture que vous intégrez contient un region entrée, et vous ajoutez un region l'entrée d'une architecture d'infrastructure également, pensez à nommer l'entrée region-infrastructure lorsque vous l'ajoutez à votre produit. Un nom significatif permet d’identifier où l’entrée est utilisée et facilite sa configuration.

Toutes les entrées que vous avez ajoutées à votre produit sont incluses dans le tableau des variables d’entrée. Si vous devez supprimer une variable que vous avez ajoutée, sélectionnez-la et cliquez sur Supprimer.

Etapes suivantes

Une fois les variables définies pour vos utilisateurs, continuez l’intégration de votre architecture déployable. Une fois que vous avez terminé, les utilisateurs qui ont accès à votre catalogue privé peuvent ajouter votre architecture déployable à un projet. Lorsqu’ils le font, ils peuvent le personnaliser en sélectionnant les architectures qu’ils souhaitent inclure en fonction de ce que vous avez spécifié lors du processus d’intégration.