Usa Terraform con Apigee

HashiCorp Terraform es una herramienta de infraestructura como código (IaC) que puedes usar para aprovisionar y configurar Apigee con código.

Cuando usas Terraform con Apigee, creas Terraform archivos que describen la configuración deseada para el aprovisionamiento o una función. Cuando aplicas la configuración, Terraform crea un plan de ejecución y realiza las operaciones necesarias para configurar Apigee.

En esta página, se resume la funcionalidad de Terraform disponible para Apigee. Para obtener información general sobre el uso de Terraform con Google Cloud, consulta Terraform en Google Cloud la documentación.

Antes de comenzar

Para configurar Terraform para tu proyecto de Apigee, haz lo siguiente:

  1. Prepara tu entorno de desarrollo, ya sea Cloud Shell o un shell local:

    Cloud Shell

    Para usar una terminal en línea con gcloud CLI y Terraform ya configurados, activa Cloud Shell.

    En la parte inferior de esta página, se inicia una sesión de Cloud Shell y se muestra una ventana de línea de comandos. La sesión puede tardar unos segundos en inicializarse.

    Ten en cuenta que Cloud Shell ya tiene Terraform integrado.

    Shell local

    Para usar un entorno de desarrollo local, sigue estos pasos:

    1. Instala Google Cloud CLI.

    2. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

    3. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

      gcloud init
    4. Instala Terraform.

  2. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  3. Habilita las APIs de Cloud Resource Manager y de Identity and Access Management (IAM):

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el serviceusage.services.enable permiso. Obtén información para otorgar roles. 

    gcloud services enable cloudresourcemanager.googleapis.com  iam.googleapis.com
  4. Asegúrate de que tu proyecto de Google Cloud no tenga agregada la Google Cloud Platform - Resource Location Restriction restricción de la política de la organización.

Recursos de Terraform para Apigee

En la siguiente tabla, se resumen las características y funciones que puedes administrar con los recursos de Terraform para Apigee. Es posible que esta lista no sea exhaustiva. Encuentra todos los recursos de Terraform para Apigee en el repositorio de GitHub de Google Cloud Platform Cloud Foundation Fabric y en la documentación de HashiCorp Google Provider para Apigee. Siempre consulta estos recursos para obtener la funcionalidad más reciente.

Función o característica de Apigee Resumen de la compatibilidad con Terraform Más información
Aprovisiona Apigee Aprovisiona instancias de Apigee con Terraform. Opciones de aprovisionamiento
Aprovisiona el concentrador de API de Apigee Configura y administra el concentrador de API con Terraform. Aprovisiona el concentrador de API con Terraform
Configura Advanced API Security Configura perfiles de seguridad de evaluación de riesgos y condiciones de supervisión (v2)

Configura listas de exclusión de detección de abusos
Configura acciones de seguridad		 Configura Advanced API Security con Terraform