Utiliser Terraform avec Apigee

HashiCorp Terraform est un outil IaC (Infrastructure as Code) qui vous permet de provisionner et de configurer Apigee à l'aide de code.

Lorsque vous utilisez Terraform avec Apigee, vous créez des fichiers Terraform qui décrivent la configuration souhaitée pour le provisionnement ou une fonctionnalité. Lorsque vous appliquez la configuration, Terraform crée un plan d'exécution et effectue les opérations nécessaires à la configuration d'Apigee.

Cette page récapitule les fonctionnalités Terraform disponibles pour Apigee. Pour obtenir des informations générales sur l'utilisation de Terraform avec Google Cloud, consultez la documentation Terraform sur Google Cloud .

Avant de commencer

Pour configurer Terraform pour votre projet Apigee :

  1. Préparez votre environnement de développement, Cloud Shell ou un shell local :

    Cloud Shell

    Pour utiliser un terminal en ligne avec la gcloud CLI et Terraform déjà configurés, activez Cloud Shell.

    En bas de la page, une session Cloud Shell démarre et affiche une invite de ligne de commande. L'initialisation de la session peut prendre quelques secondes.

    Notez que Terraform est déjà intégré à Cloud Shell.

    Shell local

    Pour utiliser un environnement de développement local, procédez comme suit :

    1. Installez la Google Cloud CLI.

    2. Configurez la gcloud CLI afin d'utiliser votre identité fédérée.

      Pour en savoir plus, consultez Se connecter à la gcloud CLI avec votre identité fédérée.

    3. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

      gcloud init
    4. Installez Terraform.

  2. Vérifiez que la facturation est activée pour votre projet Google Cloud .

  3. Activez les API Cloud Resource Manager et Identity and Access Management (IAM) :

    Rôles requis pour activer les API

    Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles. 

    gcloud services enable cloudresourcemanager.googleapis.com  iam.googleapis.com
  4. Assurez-vous que la contrainte de règle d'administration Google Cloud Platform - Resource Location Restriction n'est pas ajoutée à votre projet Google Cloud.

Ressources Terraform pour Apigee

Le tableau suivant récapitule les fonctionnalités que vous pouvez gérer à l'aide des ressources Terraform pour Apigee. Cette liste n'est peut-être pas exhaustive. Retrouvez toutes les ressources Terraform pour Apigee dans le dépôt GitHub Google Cloud Platform Cloud Foundation Fabric et dans la documentation HashiCorp Google Provider pour Apigee. Consultez toujours ces ressources pour connaître les dernières fonctionnalités.

Fonctionnalité Apigee Récapitulatif de la compatibilité avec Terraform En savoir plus
Provisionner Apigee Provisionnez des instances Apigee à l'aide de Terraform. Options de provisionnement
Provisionner le hub d'API Apigee Configurer et gérer le hub d'API à l'aide de Terraform Provisionner le hub d'API avec Terraform
Configurer Advanced API Security Configurer les profils de sécurité et les conditions de surveillance pour l'évaluation des risques (v2)

Configurer les listes d'exclusion pour la détection des utilisations abusives
Configurer les actions de sécurité		 Configurer Advanced API Security avec Terraform