Etape 1. Installation de l'interface de ligne de commande Terraform

Pour installer l'interface de ligne de commande Terraform, procédez comme suit :

1. Créez un dossier terraform sur votre machine locale et accédez à votre dossier Terraform.

   mkdir terraform && cd terraform
   

2. Téléchargez la version souhaitée de Terraform. Par exemple, vous pouvez télécharger terraform_0.15.5_darwin_amd64.zip pour Mac OS.

   Le plug-in IBM Cloud Provider pour Terraform ne prend actuellement en charge que les versions 0.12.x, 0.13.x et 0.14.x de Terraform. Veillez à sélectionner une version de Terraform prise en charge.

3. Extrayez le fichier zip Terraform et copiez les fichiers dans votre répertoire Terraform.

4. Réglez la variable d'environnement PATH sur vos fichiers Terraform.

   export PATH=$PATH:<terraform-directory>/terraform
   

5. Vérifiez que l'installation a abouti en utilisant une commande terraform.

   ./terraform
   

Étape 2. Configurez le plug-inProvider IBM Cloud

Une fois l'installation de l'interface de ligne de commande Terraform terminée, vous devez installer le plug-in IBM Cloud Provider pour Terraform pour pouvoir commencer à utiliser les ressources et les services dans IBM Cloud. Pour une liste des versions prises en charge, voir les versions du plug-in IBM Cloud Provider.

L'installation du plug-in IBM Cloud Provider varie en fonction de la version de l'interface de ligne de commande Terraform que vous allez utiliser. Pour exécuter vos fichiers de configuration Terraform avec Terraform version 0.13.x ou ultérieure, il n'est pas nécessaire d'installer le plug-in IBM Cloud Provider pour Terraform. Pour plus d'informations, voir Terraform v0.13.x and higher.

Par exemple, pour exécuter vos fichiers de configuration Terraform avec Terraform version 0.13.x ou ultérieure, procédez comme suit :

1. Créez un fichier versions.tf et indiquez la version du plug-in IBM Cloud Provider que vous souhaitez utiliser à l'aide du paramètre version.

   terraform {
       required_providers {
           ibm = {
               source = "IBM-Cloud/ibm"
               version = "<provider version>"
               }
       }
   }
   

   Exemple :

   terraform {
       required_version = ">= 0.15"
       required_providers {
           ibm = {
               source = "ibm-cloud/ibm"
               version = "1.48.0-beta0"
           }
       }
   }
   

2. Stockez le fichier versions.tf dans votre référentiel Git ou dans le dossier d'installation de Terraform.

Si vous utilisez des modules Terraform on IBM Cloud, vous devez ajouter un fichier versions.tf à tous les dossiers de module. Vous pouvez référencer le bloc fournisseur Terraform à partir du registre des fournisseurs. Pour les configurations Activity Tracker Event Routing, vous pouvez utiliser les modules Terraform IBM pour IBM Cloud Activity Tracker Event Routing qui fournissent des modules pré-construits et testés pour les configurations IBM Cloud Activity Tracker Event Routing les plus courantes.

Étape 3. Configurez le plug-in Provider IBM Cloud

Une fois l'installation terminée, vous devez configurer le plug-in IBM Cloud Provider.

Avant de commencer à utiliser Terraform on IBM Cloud, vous devez extraire les données d'identification et les paramètres obligatoires pour une source de données ou une ressource Terraform et les spécifier dans la configuration du provider. Le plug-in IBM Cloud Provider utilise cette configuration pour s'authentifier auprès de la plateforme IBM Cloud et afficher, créer, mettre à jour ou supprimer des ressources et des services IBM Cloud.

Le tableau ci-dessous répertorie les paramètres d'entrée que vous pouvez définir dans le bloc provider de votre fichier de configuration Terraform on IBM Cloud :

Pour plus d'informations sur l'utilisation des variables d'environnement, voir Using environment variables.

Vous pouvez ajouter plusieurs configurations de fournisseur dans le même fichier de configuration Terraform on IBM Cloud pour créer vos ressources IBM Cloud avec différents paramètres de fournisseur. Par exemple, vous pouvez ajouter plusieurs fournisseurs afin d'utiliser des paramètres d'entrée différents, par exemple des régions, des zones, des générations d'infrastructure ou encore des comptes, et finalement créer les ressources IBM Cloud dans votre fichier de configuration Terraform on IBM Cloud. Pour plus d'informations, voir la référence du bloc fournisseur.

Étape 4. Initialisez l'interface de ligne de commande de Terraform.

Initialisez ensuite l'interface de ligne de commande Terraform. Exécutez la commande suivante :

./terraform init

Le message suivant devrait s'afficher : Terraform has been successfully initialized!.

Étape 5. Créez un fichier de variables

Créez un fichier de variables nommé variables.tf afin d'inclure des valeurs codées en dur.

L'exemple suivant répertorie les variables que vous définissez :

// Data source arguments for atracker settings

variable "atracker_metadata_region_primary" {
  description = "Location where the metadata configuration is stored"
  type = string
  default = "Enter a supported location"
}

variable "atracker_metadata_region_backup" {
  description = "Location where the metadata configuration is stored"
  type = string
  default = "Enter a supported location"
}

// Data source arguments for atracker_targets
variable "target_type" {
  description = "Type of resource that can be defined as a target. Valid values are cloud_object_storage, cloud_logs and event_streams"
  type        = string
}

variable "atracker_target_name" {
  description = "The name of the target. Must be 256 characters or less."
  type        = string
  default     = "Enter a default target name"
}

// Data source arguments for target of type cloud_object_storage
variable "cos_bucket_name" {
  description = "Name of the Cloud Object Storage bucket"
  type        = string
}

variable "cos_target_crn" {
  description = "CRN of the Cloud Object Storage bucket"
  type        = string
}

variable "cos_endpoint" {
  description = "Private endpoint of the Cloud Object Storage bucket"
  type        = string
}


// Resource arguments for atracker_route
variable "atracker_route_name" {
  description = "The name of the route. Must be 180 characters or less and cannot include any special characters other than `(space) - . _ :`."
  type        = string
  default     = "Enter a default target name"
}
variable "atracker_route_receive_global_events" {
  description = "Whether or not all global events should be forwarded to this region."
  type        = bool
  default     = false
}
variable "atracker_route_rules" {
  description = "Routing rules that will be evaluated in their order of the array."
  type        = list(object({ example=string }))
  default     = [ { example: "object" } ]
}

Pour afficher la liste des régions valides, voir Emplacements.

Étape 6. Créez un fichier de configuration Terraform

Créez ensuite un fichier de configuration Terraform nommé main.tf. Dans ce fichier, vous configurez Activity Tracker Event Routing en utilisant le langage de configuration HashiCorp (HCL). Pour plus d'informations, voir la documentation de Terraform.

resource "ibm_atracker_settings" "atracker_settings" {
  metadata_region_primary = var.atracker_metadata_region_primary
  metadata_region_backup = var.atracker_metadata_region_backup
  default_targets = ["comma-separated-list-of-target-ids"]
  permitted_target_regions  = ["comma-separated-list-of-locations"]
  private_api_endpoint_only = false

  # Optional but recommended lifecycle flag
  lifecycle {
    create_before_destroy = true
  }
}

# Target type: cloud-object-storage
# Using service to service authorization
resource "ibm_atracker_target" "atracker_target" {
  cos_endpoint {
     endpoint = var.cos_endpoint
     target_crn = var.cos_target_crn
     bucket = var.cos_bucket_name
     service_to_service_enabled = true
  }
  name = "<Target-Name>"
  target_type = "cloud_object_storage"
  region = "us-south"
}

# Target type: cloud-object-storage
# Using a service ID Api key
resource "ibm_atracker_target" "atracker_target" {
  cos_endpoint {
     endpoint = var.cos_endpoint
     target_crn = var.cos_target_crn
     bucket = var.cos_bucket_name
     api_key = "api_key"
  }
  name = "<Target-Name>"
  target_type = "cloud_object_storage"
  region = "us-south"
}

# Target type: cloud_logs
# Using a service ID API key
resource "ibm_atracker_target" "atracker_cloudlogs_target" {
  cloudlogs_endpoint {
    target_crn = "crn:v1:bluemix:public:logs:eu-es:a/11111111111111111111111111111111:22222222-2222-2222-2222-222222222222::"
  }
  name = "<Target-Name>"
  target_type = "cloud_logs"
  region = "us-south"
}

# Target type: event-streams
# Using a service ID API key
resource "ibm_atracker_target" "atracker_eventstreams_target" {
  eventstreams_endpoint {
    target_crn = "crn:v1:bluemix:public:logs:us-south:a/11111111111111111111111111111111:22222222-2222-2222-2222-222222222222::"
    brokers = ["xxxxx.cloud.ibm.com:9093","yyyyy.cloud.ibm.com:9093"]
    topic = "my-topic"
    api_key = "api-key"
  }
  name = "<Target-Name>"
  target_type = "event_streams"
  region = "us-south"
}

## Create a route to route auditing events from Frankfurt

resource "ibm_atracker_route" "atracker_route_instance" {
  lifecycle {
    create_before_destroy = true
  }
  name = "<Route-Name>"
  rules {
    target_ids = [ibm_atracker_target.atracker_target.id]
    locations = ["eu-de"]
  }
}

## Create a route to route auditing events from 2 regions and also global events.

resource "ibm_atracker_route" "atracker_route_instance-global" {
  name = var.route_name-global

  rules {
    target_ids = [ibm_atracker_target.atracker_target-global.id]
    locations = ["global", "us-south", "eu-de"]
  }
}

## Create a route that includes multiple rules.

resource "ibm_atracker_route" "atracker_route_instance-global" {
  name = var.route_name-global

  rules {
    target_ids = [ibm_atracker_target.atracker_target-global.id]
    locations = ["eu-gb", "eu-de"]
  }
  rules {
    target_ids = [ibm_atracker_target.atracker_eventstreams_target.id]
    locations = ["us-south", "global"]
  }
}

module "activity_tracker" {
  source  = "terraform-ibm-modules/activity-tracker/ibm"
  version = "X.Y.Z" # Replace with a specific release version

  cos_targets = [{
    bucket_name   = var.cos_bucket_name
    endpoint      = var.cos_endpoint
    instance_id   = var.cos_target_crn
    target_region = "us-south"
    target_name   = "<Target-Name>"
  }]

  activity_tracker_routes = [{
    route_name = "<Route-Name>"
    locations  = ["eu-de"]
    target_ids = [module.activity_tracker.activity_tracker_targets[var.cos_bucket_name].id]
  }]
}

Etape 7. Ressources d'approvisionnement

Procédez comme suit :

1. Initialisez l'interface de ligne de commande de Terraform.

   ./terraform init
   

2. Créez un plan d'exécution Terraform. Le plan d'exécution Terraform récapitule toutes les actions à exécuter pour créer l'instance Activity Tracker, la clé de ressource et la règle d'accès IAM dans votre compte.

   ./terraform plan
   

3. Créez les ressources.

   ./terraform apply
   

   Pour supprimer des ressources, exécutez ./terraform destroy.

Étape suivante ?

Vérifiez que les ressources ont été créées.

Explorez tous les modules disponibles dans le registre Terraform IBM Modules(TIM).