Créer un élément de catalogue à partir du Terraform modèle

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture
  • Créez un élément de catalogue à partir du modèle pour demander la mise en service des ressources dans le Terraform cloud. Les éléments de catalogue activés apparaissent dans le portail de l’utilisateur dans le cloud.

    Avant de commencer

    • Assurez-vous qu’un fournisseur de configuration approprié Terraform est disponible. Pour plus d’informations sur la création du fournisseur de configuration, consultez Créer un fournisseur de Terraform Open Source configuration et Créer un fournisseur de Terraform Enterprise configuration OU Terraform Cloud.
    • Assurez-vous que le Terraform modèle fonctionne (c’est-à-dire que vous pouvez l’utiliser directement avec le Terraform système pour mettre en service les ressources cloud spécifiées). Pour plus d’informations sur Terraform les modèles, reportez-vous à la section Terraform Documentation sur la langue.
    • Assurez-vous que le bloc fournisseur du modèle respecte la Terraform syntaxe suivante :
      • Syntaxe de bloc fournisseur pour le Microsoft Azure cloud :
        provider "azurerm" {
        
          subscription_id = "${var.subscriptionId}"
          client_id       = "${var.clientId}"
          client_secret   = "${var.clientSecret}"
          tenant_id       = "${var.tenantId}"
        }
      • Syntaxe de bloc fournisseur pour le Amazon Web Services cloud :
        provider "aws" {
          access_key      = "${var.access_key}"
          secret_key      = "${var.secret_key}"
          region          = "${var.region}"
        }
      • Syntaxe de bloc de fournisseur pour Google Cloud Platform
        terraform {
          required_providers {
            google = {
              source  = "hashicorp/google"
              version = "5.10.0"
            }
          }
        }
         
        provider "google" {
          credentials = var.credentials
          project     = var.project
          region      = var.region
        }
      • Syntaxe de bloc de fournisseur pour VMware Cloud:
        provider "vsphere" {
          user                  = "${var.user}"
          password              = "${var.password}"
          vsphere_server        = "${var.vsphere_server}"
        }
        
        Remarque :
        Ne codez pas en dur des informations d’identification dans le Terraform modèle. Utilisez des variables appropriées Terraform pour extraire les informations d’identification à partir du Now Platformfichier .
    • Assurez-vous que le fichier de définition de variable (variable.tf, .tfvars ou .tfvars.json) contient la définition des variables utilisées dans le bloc de fournisseurs.
    • Si vous utilisez Terraform Enterprise ou Terraform Cloud, assurez-vous que le Serveur MID peut se connecter aux comptes VCS (Système de contrôle de version) mis en service dans l’organisation Terraform .
      Pour vérifier la connectivité avec les comptes VCS provisionnés dans l’organisation Terraform , exécutez la commande curl appropriée sur le Serveur MID.
      GitHub
      curl -H "Authorization: <API credential> https://<github-api-host>/user/repos?per_page=100&page=1"
      GitLab
      curl -H "Authorization: <API credential>" https://<gitlab-api-host>/api/v4/projects?visibility=private&per_page=100&page=1
      Microsoft Azure DevOps
      curl -H "Authorization: <API credential> https://<azure-devops-api-host>/<organization>/<project>/_apis/git/repositories?api-version=6.0"
      • organization est le nom de l’organisation Microsoft Azure DevOps .
      • project est le nom du Microsoft Azure DevOps projet.

      Pour en savoir plus sur les informations d’identification de l’API, reportez-vous à la section Cloud Provisioning and Governance: Terraform Connector Référence de formulaire Informations d’identification de clé API.

    Rôle requis : sn_cmp.cloud_service_designer

    Pourquoi et quand exécuter cette tâche

    L’application Cloud Provisioning and Governance: Terraform Connector prend en charge les types de données suivants Terraform :
    • chaîne
    • number
    • Bool
    • list
    • tuple
    • carte
    • objet

    Procédure

    1. Créez un élément de catalogue dans le cloud.
      1. Accédez à la Tout > Mise en service et gouvernance du cloud > Portail d'administration du cloud.
        Le portail d’administration du cloud s’ouvre dans un nouvel onglet de navigateur.
      2. Accédez à la Conception > Éléments de Catalogue dans le cloud.
      3. Sélectionnez Nouveau.
      4. Renseignez les champs du formulaire.
        Tableau 1. Formulaire Élément de catalogue dans le cloud
        Champ Description
        Nom Nom unique et descriptif de l’élément de catalogue.
        Source Source de l’élément de catalogue.

        Sélectionnez Modèle de gestion des configurations dans la liste déroulante.

        Type de fournisseur Terraform Type de fournisseur de configuration que vous souhaitez utiliser.
        • Pour utiliser Terraform Enterprise ou Terraform Cloud, sélectionnez Terraform Enterprise.
        • Pour utiliser un serveur Linux Terraform Open Source , sélectionnez Terraform Environment.
        • Pour utiliser un serveur Windows Terraform Open Source , sélectionnez Environnement Windows Terraform.
        Fournisseur Nom du fournisseur de Terraform configuration que vous souhaitez utiliser.
      5. Enregistrez le formulaire Élément de catalogue dans le cloud.
    2. Associez un Terraform modèle à l’élément de catalogue.
      1. Dans la liste connexe Modèles dans le cloud, sélectionnez Nouveau.
      2. Dans la liste déroulante Configuration installable, sélectionnez le Terraform modèle que vous souhaitez utiliser.
      3. Enregistrez le formulaire Versions des modèles dans le ServiceNow cloud.
        Remarque :
        Un élément de catalogue peut inclure plusieurs versions du modèle dans le cloud, mais une seule version peut être active.
      4. Sélectionnez Activer pour activer le modèle dans le cloud.
    3. Facultatif : Pour ajouter ou supprimer des champs de formulaire d’élément de catalogue, modifiez les jeux de variables associés à l’élément de catalogue.
    4. Cochez la case Actif pour activer l’élément de catalogue.
    5. Sélectionnez Mettre à jour.

    Que faire ensuite

    Vérifiez que l’élément de catalogue apparaît dans le portail de l’utilisateur dans le cloud.