Criar um item do catálogo a partir do modelo Terraform

Crie um item do catálogo a partir do modelo Terraform para solicitar o provisionamento de recursos de nuvem. Os itens do catálogo ativados aparecem no portal do usuário da nuvem.

Antes de Iniciar

• Certifique-se de que um provedor de configuração Terraform apropriado esteja disponível. Para obter mais informações sobre como criar o provedor de configuração, consulte Criar um provedor de configuração Terraform Open Source e Criar um provedor de configuração Terraform Enterprise ou Terraform Cloud.
• Certifique-se de que o modelo Terraform esteja funcionando (ou seja, você pode usar diretamente o modelo com o sistema Terraform para provisionar os recursos de nuvem especificados). Para obter mais informações sobre os modelos Terraform, consulte Terraform documentação do idioma.
• Certifique-se de que o bloco do provedor do modelo Terraform esteja em conformidade com a seguinte sintaxe:
  • Sintaxe de bloco do provedor para a nuvem Microsoft Azure :

    provider "azurerm" {
    
      subscription_id = "${var.subscriptionId}"
      client_id       = "${var.clientId}"
      client_secret   = "${var.clientSecret}"
      tenant_id       = "${var.tenantId}"
    }

  • Sintaxe de bloco do provedor para a nuvem Amazon Web Services :

    provider "aws" {
      access_key      = "${var.access_key}"
      secret_key      = "${var.secret_key}"
      region          = "${var.region}"
    }

  • Sintaxe de bloco do provedor para 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
    }

  • Sintaxe de bloco do provedor para VMware Cloud:

    provider "vsphere" {
      user                  = "${var.user}"
      password              = "${var.password}"
      vsphere_server        = "${var.vsphere_server}"
    }
    

    Nota:

    Não codifique nenhuma credencial no modelo Terraform. Use variáveis Terraform apropriadas para buscar as credenciais do Now Platform.
• Certifique-se de que o arquivo de definição de variável (variable.tf, .tfvarsou .tfvars.json) contenha a definição das variáveis usadas no bloco do provedor.
• Se você estiver usando Terraform Enterprise ou Terraform Cloud, certifique-se de que MID Server possa se conectar com contas do Sistema de controle de versão (VCS) provisionadas na organização Terraform.
  Para verificar a conectividade com as contas do VCS provisionadas na organização Terraform, execute o comando de curva apropriado na MID Server.

  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"

  Onde,

  • organization é o nome da organização Microsoft Azure DevOps.
  • project é o nome do projeto Microsoft Azure DevOps.

  Para obter mais informações sobre as credenciais de API, consulte Cloud Provisioning and Governance: Terraform Connector Referência do formulário de credenciais de chave de API.

Função necessária: sn_cmp.cloud_service_designer

Por Que e Quando Desempenhar Esta Tarefa

O app Cloud Provisioning and Governance: Terraform Connector é compatível com os seguintes tipos de dados Terraform :

• Cadeia de caracteres
• número
• bool
• lista
• tupla
• mapa
• objeto

Procedimento

1. Crie um item do catálogo na nuvem.
   1. Navegar até Todos > Cloud Provisioning and Governance > Portal de administração de nuvem.
      O Portal de administração em nuvem é aberto em uma nova guia do navegador.
   2. Navegar até Design > Itens do catálogo na nuvem.
   3. Selecione Novo.
   4. No formulário, preencha os campos.

      Tabela 1. Formulário Item do catálogo na nuvem

      Campo	Descrição
      Nome	Nome exclusivo e descritivo do item do catálogo.
      Fonte	Origem do item do catálogo. Selecione Modelo de gestão de configuração na lista suspensa.
      Tipo de provedor	Terraform Tipo de provedor de configuração que você deseja usar. Para usar Terraform Enterprise ou Terraform Cloud, selecione Terraform Enterprise. Para usar um servidor baseado em Linux Terraform Open Source, selecione Ambiente Terraform. Para usar um servidor baseado no Windows Terraform Open Source, selecione Ambiente do Terraform para Windows.
      Provedor	Nome do provedor de configuração Terraform que você deseja usar.

   5. Salve o formulário Item do catálogo na nuvem.
2. Associe um modelo Terraform ao item do catálogo.
   1. Na lista relacionada Modelos para nuvem, selecione Novo.
   2. Na lista suspensa Configuração instalável, selecione o modelo Terraform que você deseja usar.
   3. Salve o formulário ServiceNow Versões de modelos para nuvem.
      Nota:

      Um item do catálogo pode incluir várias versões do modelo para nuvem, mas somente uma versão pode estar ativa.
   4. Selecione Ativar para ativar o modelo de nuvem.
3. Opcional: Para adicionar ou remover campos de formulário de item do catálogo, edite os conjuntos de variáveis associados ao item do catálogo.
4. Marque a caixa de seleção Ativo para ativar o item do catálogo.
5. Selecione Atualizar.

O que Fazer Depois

Verifique se o item do catálogo aparece no Portal de usuário da nuvem.