Usar o Terraform com a Apigee

O Terraform é uma ferramenta de infraestrutura como código (IaC) que pode ser usada para provisionar e configurar o Apigee usando código.

Ao usar o Terraform com o Apigee, você cria arquivos do Terraform que descrevem a configuração desejada para provisionamento ou um recurso. Quando você aplica a configuração, o Terraform cria um plano de execução e realiza as operações necessárias para configurar o Apigee.

Esta página resume a funcionalidade do Terraform disponível para a Apigee. Para informações gerais sobre como usar o Terraform com o Google Cloud, consulte a documentação do Terraform no Google Cloud .

Antes de começar

Para configurar o Terraform no projeto da Apigee:

  1. Prepare seu ambiente de desenvolvimento, seja o Cloud Shell ou um shell local:

    Cloud Shell

    Para usar um terminal on-line com a CLI gcloud e o Terraform já configurados, ative o Cloud Shell.

    Na parte de baixo desta página, uma sessão do Cloud Shell é iniciada e mostra um prompt de linha de comando. A inicialização da sessão pode levar alguns segundos.

    O Cloud Shell já tem o Terraform integrado.

    Shell local

    Para usar um ambiente de desenvolvimento local, siga estas etapas:

    1. Install the Google Cloud CLI.

    2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    3. To initialize the gcloud CLI, run the following command: 

      gcloud init
    4. Instale o Terraform.

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Cloud Resource Manager and Identity, Access Management (IAM) APIs:

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles. 

    gcloud services enable cloudresourcemanager.googleapis.com  iam.googleapis.com
  4. Verifique se o projeto do Google Cloud não tem a restrição de política da organização Google Cloud Platform - Resource Location Restriction adicionada.

Recursos do Terraform para a Apigee

A tabela a seguir resume os recursos e funcionalidades que podem ser gerenciados usando recursos do Terraform para a Apigee. Esta lista pode não estar completa. Encontre todos os recursos do Terraform para a Apigee no repositório do Terraform da Apigee no GitHub. Sempre verifique o repositório do GitHub para conferir a funcionalidade mais recente.

Recurso ou funcionalidade da Apigee Resumo do suporte ao Terraform Mais informações
Provisionar a Apigee Provisionar instâncias do Apigee usando o Terraform. Opções de provisionamento
Provisionar o hub de APIs da Apigee Configure e gerencie o hub de API usando o Terraform. Provisionar o hub da API com o Terraform
Configurar a segurança avançada da API Configurar ações de segurança e alguns aspectos da Avaliação de risco v2. Configurar a segurança avançada da API com o Terraform