Unités de déploiement de modèles et de packages

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page décrit comment modéliser et empaqueter les unités de déploiement pour une offre SaaS. Dans l'environnement d'exécution SaaS, une unité de déploiement est appelée type d'unité.

Créez un genre d'unité pour chaque composant de l'offre SaaS que vous souhaitez gérer indépendamment. Pour en savoir plus, consultez la section suivante : Déterminer le modèle de l'offre SaaS.

Si vous le souhaitez, vous pouvez créer une offre SaaS à l'aide d'un seul type d'unité pour l'ensemble de l'offre SaaS.

Les types d'unités sont définis par un blueprint, qui est une configuration Terraform empaquetée sous forme d'image OCI. Avant de créer un genre d'unité, vous devez créer un plan pour chaque genre d'unité. Pour en savoir plus sur la création de plans, consultez Créer et importer un plan.

Avant de commencer

1. Assurez-vous d'avoir défini une offre SaaS pour votre application SaaS.
2. Assurez-vous d'avoir créé un dépôt Artifact Registry.
3. Assurez-vous de disposer des comptes de service disposant des autorisations requises. Pour en savoir plus, consultez Comptes de service de l'environnement d'exécution SaaS.
4. Pour chaque type d'unité que vous créez, assurez-vous d'avoir une configuration Terraform et d'avoir préparé le blueprint. Pour en savoir plus, consultez la section suivante : Déterminer le modèle de l'offre SaaS.

Déterminer le modèle de l'offre SaaS

Pour modéliser l'offre SaaS, vous devez déterminer le nombre de genres d'unité à créer et la relation entre ces genres d'unité.

Par exemple, vous pouvez créer deux types d'unités : un pour l'infrastructure, comme une VM, et un pour l'application déployée sur l'infrastructure. Si vous le souhaitez, vous pouvez créer une offre SaaS à l'aide d'un seul genre d'unité pour l'ensemble de l'offre SaaS.

Pour décider comment modéliser l'offre SaaS à l'aide de genres d'unité, tenez compte des éléments suivants :

• Examinez les dépendances entre les composants de l'offre SaaS. Par exemple, si une offre SaaS inclut une application déployée sur un cluster Kubernetes partagé, envisagez d'utiliser un type d'unité pour modéliser ce cluster partagé.
• Tenez compte du cycle de publication et de maintenance des composants de l'offre SaaS. S'il existe des composants gérés ensemble, comme l'infrastructure, envisagez de les modéliser avec un seul type d'unité.

Une fois ce modèle déterminé, vous devez créer un plan pour chaque type d'unité. Pour ce faire, vous devez :

1. Identifiez la configuration Terraform à associer à ce genre d'unité. Pour en savoir plus sur les configurations Terraform requises, consultez Plans dans l'environnement d'exécution SaaS.
2. Assurez-vous que la configuration Terraform est empaquetée sous forme d'image OCI et envoyée vers Artifact Registry, ou qu'elle se trouve dans une archive ZIP ou un dépôt Git. Pour en savoir plus, consultez Créer et importer un blueprint.

Une fois que vous avez un blueprint pour chaque type d'unité, vous pouvez suivre les instructions de cette page pour créer les types d'unité.

Créer un genre d'unité

Vous pouvez créer un type d'unité à l'aide d'une configuration Terraform fournie de l'une des manières suivantes :

• Dans une archive ZIP
• Dans un dépôt Git.
• Empaqueté sous forme d'image OCI.

Créer un genre d'unité à l'aide d'une archive ZIP

Pour créer un type d'unité à l'aide d'une configuration Terraform dans une archive ZIP, suivez les instructions ci-dessous.

Pour en savoir plus sur la préparation d'une archive ZIP, consultez Importer une archive ZIP.

Pour créer un genre d'unité :

1. Dans la console, accédez à SaaS Runtime > Types d'unités.

   Accéder à "Types d'unités"

2. Sélectionnez Créer.

3. Pour Créer un blueprint, sélectionnez Importer pour importer une archive ZIP contenant la configuration Terraform.

   1. Cliquez sur Parcourir et recherchez l'archive ZIP contenant la configuration Terraform qui définit les ressources ou l'application faisant partie de ce type d'unité.

   2. Cliquez sur Suivant : Configurer le plan.

4. Sur la page Plan du magasin :

   1. Pour Sélectionner un dépôt dans Artifact Registry, cliquez sur Parcourir, puis sélectionnez le dépôt que vous avez créé.

   2. Dans le champ Nom de l'image d'artefact, saisissez le nom de l'image OCI.

   3. Pour la version Terraform d'Infrastructure Manager, sélectionnez la version de Terraform à utiliser pour les déploiements. Pour obtenir la liste des versions de Terraform compatibles, consultez Versions de Terraform compatibles.

   4. Pour le compte de service Cloud Build, sélectionnez le compte de service autorisé à créer l'image. Pour en savoir plus, consultez Compte de service de création d'artefacts.

   5. Cliquez sur Suivant : Détails du genre d'unité.

5. Sur la page Configurer les propriétés du genre d'unité, procédez comme suit :

   1. Dans le champ Nom du type d'unité, saisissez le nom du type d'unité. Le nom ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union.

   2. Pour Offre SaaS, sélectionnez l'offre SaaS que vous souhaitez associer à ce genre d'unité.

   3. Pour les dépendances :

      • Si c'est la première ou la seule unité que vous créez pour l'offre SaaS, n'ajoutez pas de dépendance.

      • Si vous avez créé d'autres types d'unités qui dépendent de ce type d'unité, sélectionnez Ajouter une dépendance.

        1. Pour Unit kind (Genre d'unité), sélectionnez le genre d'unité existant qui dépend du genre d'unité que vous créez.

        2. Dans le champ Alias, saisissez un nom que vous pourrez utiliser pour le mappage des variables d'entrée.

        3. Cliquez sur OK.

        4. Si vous souhaitez définir le mappage des variables, procédez comme suit. Pour en savoir plus sur le mappage des variables, consultez Mappage des variables.

           1. Sélectionnez Définir les mappages des variables d'entrée et de sortie.

           2. Pour Mappages de variables d'entrée :

              1. Sélectionnez Ajouter un mappage de variables d'entrée.
              2. Pour Variable, saisissez le nom de la variable d'entrée.
              3. Pour Type de mappage, sélectionnez :
                 • De : permet de mapper à partir de l'autre type d'unité.
                 • Pour mapper à l'autre type d'unité.
              4. Pour Dépendance, sélectionnez le type d'unité existant auquel vous mappez les variables.
              5. Dans le champ Variable de sortie, saisissez le nom de la variable de sortie.
              6. Sélectionnez OK.

           3. Pour ajouter une autre variable d'entrée, sélectionnez Ajouter un mappage de variables d'entrée et répétez les étapes.

           4. Pour ajouter des mappages de variables de sortie :

              1. Sélectionnez l'onglet Mappages de variables de sortie.
              2. Sélectionnez Ajouter un mappage de variables de sortie, puis répétez les étapes que vous avez suivies pour le mappage des variables d'entrée.

6. Cliquez sur Suivant : Configuration de la version.

7. Dans le champ Nom de la version, saisissez le nom de la version.

8. Facultatif : Ajoutez un libellé aux ressources que vous déployez. Pour en savoir plus sur les libellés, consultez la présentation des libellés.

   Pour ajouter un libellé :

   1. Sous Libellés, sélectionnez Ajouter des libellés.

   2. Pour Clé 1 et Valeur 1, saisissez la paire clé-valeur souhaitée.

   3. Répétez ces étapes pour chaque libellé que vous souhaitez ajouter.

9. Cliquez sur Créer.

Vous venez de créer un genre d'unité. Pour créer un autre type d'unité, répétez les mêmes étapes et utilisez l'archive ZIP contenant la configuration Terraform pour ce prochain type d'unité.

Si vous avez créé tous les types d'unités nécessaires pour l'offre SaaS, vous pouvez déployer une instance d'unité.

Créer un genre d'unité à l'aide d'un dépôt Git

Pour créer un type d'unité à l'aide d'une configuration Terraform qui se trouve dans un dépôt Git, suivez les instructions ci-dessous.

Pour en savoir plus sur l'utilisation d'un dépôt Git pour les fichiers Terraform, consultez Se connecter à un dépôt Git.

1. Dans la console, accédez à SaaS Runtime > Types d'unités.

   Accéder à "Types d'unités"

2. Sélectionnez Créer.

3. Pour Créer un plan, sélectionnez Associer un dépôt externe.

4. Pour Dépôt, sélectionnez le dépôt Git contenant la configuration Terraform :

   1. Si le dépôt Git est associé, sélectionnez-le dans la liste.

   2. Si le dépôt n'est pas associé, cliquez sur Associer un dépôt pour utiliser Developer Connect et associer le dépôt.

      1. Sélectionnez Créer une connexion.

      2. Pour Région, sélectionnez une région pour la connexion Developer Connect. Nous vous recommandons d'utiliser la même région que celle utilisée pour le dépôt Artifact Registry.

      3. Facultatif : Pour Clé KMS, vous pouvez spécifier une clé KMS pour le chiffrement.

      4. Pour Branche, spécifiez la branche Git contenant la configuration Terraform que vous souhaitez associer à ce type d'unité.

5. Sur la page Plan du magasin :

   1. Pour Sélectionner un dépôt dans Artifact Registry, cliquez sur Parcourir et sélectionnez le dépôt Artifact Registry que vous utilisez pour l'offre SaaS.

   2. Dans le champ Nom de l'image d'artefact, saisissez le nom de l'image OCI.

   3. Pour la version Terraform d'Infrastructure Manager, sélectionnez la version de Terraform à utiliser pour les déploiements. Pour obtenir la liste des versions de Terraform compatibles, consultez Versions de Terraform compatibles.

   4. Pour le compte de service Cloud Build, sélectionnez le compte de service autorisé à créer l'image. Pour en savoir plus, consultez Compte de service de création d'artefacts.

   5. Cliquez sur Suivant : Détails du genre d'unité.

6. Sur la page Configurer les propriétés du genre d'unité, procédez comme suit :

   1. Dans le champ Nom du type d'unité, saisissez le nom du type d'unité. Le nom ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union.

   2. Pour Offre SaaS, sélectionnez l'offre SaaS que vous souhaitez associer à ce genre d'unité.

   3. Pour les dépendances :

      • Si c'est la première ou la seule unité que vous créez pour l'offre SaaS, n'ajoutez pas de dépendance.

      • Si vous avez créé d'autres types d'unités qui dépendent de ce type d'unité, sélectionnez Ajouter une dépendance.

        1. Pour Unit kind (Genre d'unité), sélectionnez le genre d'unité existant qui dépend du genre d'unité que vous créez.

        2. Dans le champ Alias, saisissez un nom que vous pourrez utiliser pour le mappage des variables d'entrée.

        3. Cliquez sur OK.

        4. Si vous souhaitez définir le mappage des variables, procédez comme suit. Pour en savoir plus sur le mappage des variables, consultez Mappage des variables.

           1. Sélectionnez Définir les mappages des variables d'entrée et de sortie.

           2. Pour Mappages de variables d'entrée :

              1. Sélectionnez Ajouter un mappage de variables d'entrée.
              2. Pour Variable, saisissez le nom de la variable d'entrée.
              3. Pour Type de mappage, sélectionnez :
                 • De : permet de mapper à partir de l'autre type d'unité.
                 • Pour mapper à l'autre type d'unité.
              4. Pour Dépendance, sélectionnez le type d'unité existant auquel vous mappez les variables.
              5. Dans le champ Variable de sortie, saisissez le nom de la variable de sortie.
              6. Sélectionnez OK.

           3. Pour ajouter une autre variable d'entrée, sélectionnez Ajouter un mappage de variables d'entrée et répétez les étapes.

           4. Pour ajouter des mappages de variables de sortie :

              1. Sélectionnez l'onglet Mappages de variables de sortie.
              2. Sélectionnez Ajouter un mappage de variables de sortie, puis répétez les étapes que vous avez suivies pour le mappage des variables d'entrée.

7. Cliquez sur Suivant : Configuration de la version.

8. Dans le champ Nom de la version, saisissez le nom de la version.

9. Facultatif : Ajoutez un libellé aux ressources que vous déployez. Pour en savoir plus sur les libellés, consultez la présentation des libellés.

   Pour ajouter un libellé :

   1. Sous Libellés, sélectionnez Ajouter des libellés.

   2. Pour Clé 1 et Valeur 1, saisissez la paire clé-valeur souhaitée.

   3. Répétez ces étapes pour chaque libellé que vous souhaitez ajouter.

10. Cliquez sur Créer.

Vous venez de créer un genre d'unité. Pour créer un autre type d'unité, répétez les mêmes étapes et utilisez le dépôt Git contenant la configuration Terraform pour ce prochain type d'unité.

Si vous avez créé tous les types d'unités nécessaires pour l'offre SaaS, vous pouvez déployer une instance d'unité.

Créer un genre d'unité à l'aide d'une image existante

Pour créer un type d'unité à l'aide d'un blueprint existant, qui est une image OCI, suivez les instructions ci-dessous.

Pour en savoir plus sur la création d'une image OCI, consultez les ressources suivantes :

• Créer et transférer une image manuellement
• Automatiser la création de plans

1. Dans la console, accédez à SaaS Runtime > Types d'unités.

   Accéder à "Types d'unités"

2. Sélectionnez Créer.

3. Pour Créer un plan, sélectionnez Sélectionner une image existante dans Artifact Registry.

4. Cliquez sur Suivant : Configurer le plan.

5. Sur la page Plan du magasin :

   1. Pour Sélectionner ou saisir un plan existant dans Artifact Registry :

      1. Cliquez sur Parcourir.

      2. Accédez à l'image contenant la configuration Terraform.

      3. Cliquez sur Sélectionner.

   2. Cliquez sur Suivant : Détails du genre d'unité.

6. Sur la page Configurer les propriétés du genre d'unité, procédez comme suit :

   1. Dans le champ Nom du type d'unité, saisissez le nom du type d'unité. Le nom ne doit contenir que des lettres minuscules, des chiffres ou des traits d'union.

   2. Pour Offre SaaS, sélectionnez l'offre SaaS que vous souhaitez associer à ce genre d'unité.

   3. Pour les dépendances :

      • Si c'est la première ou la seule unité que vous créez pour l'offre SaaS, n'ajoutez pas de dépendance.

      • Si vous avez créé d'autres types d'unités qui dépendent de ce type d'unité, sélectionnez Ajouter une dépendance.

        1. Pour Unit kind (Genre d'unité), sélectionnez le genre d'unité existant qui dépend du genre d'unité que vous créez.

        2. Dans le champ Alias, saisissez un nom que vous pourrez utiliser pour le mappage des variables d'entrée.

        3. Cliquez sur OK.

        4. Si vous souhaitez définir le mappage des variables, procédez comme suit. Pour en savoir plus sur le mappage des variables, consultez Mappage des variables.

           1. Sélectionnez Définir les mappages des variables d'entrée et de sortie.

           2. Pour Mappages de variables d'entrée :

              1. Sélectionnez Ajouter un mappage de variables d'entrée.
              2. Pour Variable, saisissez le nom de la variable d'entrée.
              3. Pour Type de mappage, sélectionnez :
                 • De : permet de mapper à partir de l'autre type d'unité.
                 • Pour mapper à l'autre type d'unité.
              4. Pour Dépendance, sélectionnez le type d'unité existant auquel vous mappez les variables.
              5. Dans le champ Variable de sortie, saisissez le nom de la variable de sortie.
              6. Sélectionnez OK.

           3. Pour ajouter une autre variable d'entrée, sélectionnez Ajouter un mappage de variables d'entrée et répétez les étapes.

           4. Pour ajouter des mappages de variables de sortie :

              1. Sélectionnez l'onglet Mappages de variables de sortie.
              2. Sélectionnez Ajouter un mappage de variables de sortie, puis répétez les étapes que vous avez suivies pour le mappage des variables d'entrée.

7. Cliquez sur Suivant : Configuration de la version.

8. Dans le champ Nom de la version, saisissez le nom de la version.

9. Facultatif : Ajoutez un libellé aux ressources que vous déployez. Pour en savoir plus sur les libellés, consultez la présentation des libellés.

   Pour ajouter un libellé :

   1. Sous Libellés, sélectionnez Ajouter des libellés.

   2. Pour Clé 1 et Valeur 1, saisissez la paire clé-valeur souhaitée.

   3. Répétez ces étapes pour chaque libellé que vous souhaitez ajouter.

10. Cliquez sur Créer.

Vous venez de créer un genre d'unité. Pour créer un autre type d'unité, répétez les mêmes étapes et utilisez l'image OCI contenant la configuration Terraform pour ce prochain type d'unité.

Si vous avez créé tous les types d'unités nécessaires pour l'offre SaaS, vous pouvez déployer une instance d'unité.

Étapes suivantes

• Une fois l'offre SaaS modélisée, vous pouvez déployer une instance d'unité.
• Pour en savoir plus sur l'environnement d'exécution SaaS, consultez la présentation de l'environnement d'exécution SaaS.
• Pour en savoir plus sur les comptes de service nécessaires lorsque vous utilisez SaaS Runtime, consultez Comptes de service.