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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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, reportez-vous aux sections 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, consultez la section Terraform Documentation sur la langue.
    • Assurez-vous que le bloc fournisseur du Terraform modèle respecte la syntaxe suivante :
      • Syntaxe du bloc de 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 du bloc de fournisseur pour le Amazon Web Services cloud :
        provider "aws" {
          access_key      = "${var.access_key}"
          secret_key      = "${var.secret_key}"
          region          = "${var.region}"
        }
      • Syntaxe du bloc fournisseur pour VMware Cloud:
        provider "vsphere" {
          user                  = "${var.user}"
          password              = "${var.password}"
          vsphere_server        = "${var.vsphere_server}"
        }
        
        Remarque :
        Ne codez pas en dur les informations d’identification dans le Terraform modèle. Utilisez les variables appropriées Terraform pour extraire les informations d’identification à partir du Now Platform.
    • 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 fournisseur.
    • Si vous utilisez Terraform Enterprise ou Terraform Cloud, assurez-vous que le Serveur MID peut se connecter aux comptes du système de contrôle de version (VCS) approvisionnés 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 Microsoft Azure DevOps nom du projet.

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

    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 Tous > Mise en service et gouvernance du cloud > Portail d'administration du cloud.
        Le portail d’administration dans le 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 l’environnement Terraform.
        • Pour utiliser un serveur Windows Terraform Open Source , sélectionnez l’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 du formulaire É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.