Voraussetzungen

• Bevor Sie beginnen, stellen Sie sicher, dass Sie über den erforderlichen Zugang verfügen, um IBM Cloud Logs Ressourcen zu erstellen und mit ihnen zu arbeiten.
• Installieren Sie die Terraform CLI.

IBM Cloud-Provider-Plug-in konfigurieren

Nachdem Sie die Konfiguration abgeschlossen haben, müssen Sie das IBM Cloud-Provider-Plug-in konfigurieren.

Bevor Sie mit der Arbeit mit Terraform unter IBM Cloud beginnen können, müssen Sie die Berechtigungsnachweise und Parameter abrufen, die für eine Terraform-Ressource oder Datenquelle erforderlich sind und sie in der Konfiguration des provider angeben. Diese Konfiguration wird vom IBM Cloud-Provider-Plug-in für die Authentifizierung mit der IBM Cloud-Plattform und zum Anzeigen, Erstellen, Aktualisieren oder Löschen von IBM Cloud-Ressourcen und Services verwendet.

In der folgenden Tabelle werden Eingabeparameter aufgelistet, die Sie im Block provider Ihres Terraforms in der IBM Cloud-Konfigurationsdatei festlegen können:

Weitere Informationen über die Verwendung von Umgebungsvariablen finden Sie unter Verwendung von Umgebungsvariablen.

ibmcloud_api_key = "<ibmcloud_api_key>"
region = "region"
account_id = "<Account ID>"
rg_id = "d7c0e937c529461f90a19e1421f9746d"
plan = "standard"
cos_instance_crn = "crn:v1:bluemix:public:cloud-object-storage:global:a/<Account ID>:<COS instance ID>::"
cos_storage_class = "standard"
cos_bucket_data_name = "cloud-logs-tf-data"
cos_bucket_metrics_name = "cloud-logs-tf-metrics"
event_notifications_crn = "crn:v1:bluemix:public:event-notifications:eu-gb:a/<Account ID>:<Event Notifications instance ID>::"
event_notifications_instance_id = "<Event Notifications instance ID>"
event_notifications_region = "eu-gb"

variable "ibm_region" {
  description = "Region to create resources. To see the list of valid regions, see https://cloud.ibm.com/docs/cloud-logs?topic=cloud-logs-regions."
  type        = string
  default     = "eu-gb"
}

variable "resource_group_name" {
  type        = string
  description = "Resource group where resources are created"
  default     = "Default"
}


variable "rg_id" {
  type        = string
  description = "Resource group ID where resources are created"
  default     = "b302120431c4456097f8970d80b93dfb"
}

variable "plan" {
  type        = string
  description = "Service plan for Cloud Logs instances"
  default     = "standard"
}

variable "cos_instance_crn" {
  type        = string
  description = "COS instance CRN where buckets are created"
  default     = "crn:v1:bluemix:public:cloud-object-storage:global:a/<Account ID>:<COS instance ID>::"
}

variable "cos_storage_class" {
  type        = string
  description = "COS instance storage class"
  default     = "standard"
}

variable "account_id" {
  type        = string
  description = "Account where resources are created"
  default     = "<Account ID>"
}

variable "cos_bucket_data_name" {
  type        = string
  description = "Cloud Object Storage bucket data name"
  default     = "cloud-logs-tf-data"
}

variable "cos_bucket_metrics_name" {
  type        = string
  description = "Cloud Object Storage bucket data name"
  default     = "cloud-logs-tf-metrics"
}

variable "event_notifications_crn" {
  type        = string
  description = "Event Notifications CRN"
  default     = "crn:v1:bluemix:public:event-notifications:eu-gb:a/<Account ID>:<Event Notifications Instance ID>::"
}

variable "event_notifications_instance_id" {
  type        = string
  description = "Event Notifications instance ID"
  default     = "<Event Notifications Instance ID>"
}

variable "event_notifications_region" {
  type        = string
  description = "Event notifications region"
  default     = "eu-gb"
}

variable "ibmcloud_api_key" {}
variable "region" {}

provider "ibm" {
  ibmcloud_api_key    = var.ibmcloud_api_key
  region = var.region
}

Erstellen Sie die Terraform-Konfigurationsdateien zur Bereitstellung einer Instanz von IBM Cloud Logs

Erstellen Sie dann die folgenden Dateien:

• data-bucket.tf: Enthält die Terraform-Ressourcendefinition zur Erstellung eines Buckets zum Speichern von Protokolldaten.

  resource "ibm_cos_bucket" "data_bucket" {
  	      bucket_name          = var.cos_bucket_data_name
    	resource_instance_id = var.cos_instance_crn
    	region_location      = var.region
  	    storage_class        = var.cos_storage_class
  }
  

• metrics-bucket.tf: Enthält die Terraform-Ressourcendefinition zur Erstellung eines Buckets zur Speicherung von Metriken, die aus Protokolldaten gesammelt werden.

  resource "ibm_cos_bucket" "metrics_bucket" {
  	      bucket_name          = var.cos_bucket_metrics_name
    	resource_instance_id = var.cos_instance_crn
  	    region_location      = var.region
    	storage_class        = var.cos_storage_class
  }
  

• main.tf: Enthält die Terraform-Ressourcendefinition, um die Instanz IBM Cloud Logs zu erstellen und den Data Bucket und den Metrics Bucket anzuhängen.

  data "ibm_resource_group" "group" {
    name = "marisa"
  }
  
  resource "ibm_resource_instance" "cloud_logs_instance" {
    name              = "cloud-logs-via-tf"
    service           = "logs"
    plan              = var.plan
    location          = var.region
    resource_group_id = data.ibm_resource_group.group.id
  
    parameters = {
      retention_period = "7"
    }
  
  }
  
  resource "null_resource" "update_instance_parameters" {
    triggers = {
      instance_id = ibm_resource_instance.cloud_logs_instance.id
    }
  
    provisioner "local-exec" {
      command = <<EOT
        ibmcloud login --apikey=$IC_API_KEY
        ibmcloud resource service-instance-update ${ibm_resource_instance.cloud_logs_instance.guid} -p '{"logs_bucket_crn": "${ibm_cos_bucket.data_bucket.crn}", "logs_bucket_endpoint": "${ibm_cos_bucket.data_bucket.s3_endpoint_direct}", "metrics_bucket_crn": "${ibm_cos_bucket.metrics_bucket.crn}","metrics_bucket_endpoint": "${ibm_cos_bucket.metrics_bucket.s3_endpoint_direct}"}'
      EOT
    }
    depends_on = [ibm_iam_authorization_policy.policy-cl-data-bucket,ibm_iam_authorization_policy.policy-cl-metrics-bucket]
  }
  

• en_s2s.tf: Enthält die Terraform-Ressourcendefinition zur Erstellung der Service-to-Service-Autorisierungen zwischen der Instanz IBM Cloud Logs und den Buckets.

  locals {
  	  cos_instance_id = split(":", ibm_cos_bucket.data_bucket.resource_instance_id)[7]
  }
  
  resource "ibm_iam_authorization_policy" "policy-cl-data-bucket" {
      source_service_name         = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles                       = ["Writer"]
  
      resource_attributes {
  	          name  = "serviceName"
  	      value = "cloud-object-storage"
      }
  
      resource_attributes {
  	 	        name  = "serviceInstance"
  	 	        value = local.cos_instance_id
  	 	        operator = "stringEquals"
      }
  
      resource_attributes {
  		        name = "resourceType"
  		        value = "bucket"
  		        operator = "stringEquals"
  	      }
  
      resource_attributes {
  	 	        name  = "resource"
  	      	  value = ibm_cos_bucket.data_bucket.bucket_name
  	 	        operator = "stringEquals"
      }
  
  	      resource_attributes {
  		        name  = "accountId"
  		        value = var.account_id
  	      }
  }
  
  resource "ibm_iam_authorization_policy" "policy-cl-metrics-bucket" {
  	    source_service_name         = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles                       = ["Writer"]
  
  
      resource_attributes {
  	        name  = "serviceName"
  	        value = "cloud-object-storage"
      }
  
      resource_attributes {
  	        name  = "serviceInstance"
  	 	      value = local.cos_instance_id
  	 	      operator = "stringEquals"
      }
  
      resource_attributes {
  		      name = "resourceType"
  		      value = "bucket"
  		      operator = "stringEquals"
  	      }
  
      resource_attributes {
  	 	      name  = "resource"
  	 	      value = ibm_cos_bucket.metrics_bucket.bucket_name
  	 	      operator = "stringEquals"
      }
  
      resource_attributes {
  		      name  = "accountId"
  		      value = var.account_id
  	      }
  }
  

• event-notification-extension.tf: Enthält die Terraform-Ressourcendefinition zur Erstellung einer ausgehenden Integration zwischen der Instanz IBM Cloud Logs und der Instanz IBM Cloud Event Notifications, über die Sie Benachrichtigungen an Ihre Ziele wie Slack oder E-Mail senden.

  resource "ibm_logs_outgoing_webhook" "logs_outgoing_webhook_instance" {
  	    instance_id               = ibm_resource_instance.cloud_logs_instance.guid
  	    region                    = ibm_resource_instance.cloud_logs_instance.location
  	    name        			  = "Event-notification-cloud-logs-instance"
  	    type                      = "ibm_event_notifications"
  	    ibm_event_notifications {
  	    event_notifications_instance_id = var.event_notifications_instance_id
   	    region_id                       = var.event_notifications_region
  	    }
  	    depends_on = [ibm_iam_authorization_policy.policy-event-notifications]
  }
  

• s2s.tf: Enthält die Terraform-Ressourcendefinition, um die Autorisierung zwischen der Instanz IBM Cloud Logs und der Instanz IBM Cloud Event Notifications zu erstellen.

  resource "ibm_iam_authorization_policy" "policy-event-notifications" {
  	    source_service_name = "logs"
  	    source_resource_instance_id = ibm_resource_instance.cloud_logs_instance.guid
  	    roles               = ["Reader","Event Source Manager","Viewer"]
  	    description         = ""
  	    target_service_name = "event-notifications"
  }
  

Weitere Informationen über die Verwendung von Terraform für IBM Cloud Ressourcen finden Sie unter ibm_resource_instance

Ressourcen bereitstellen

Führen Sie die folgenden Schritte aus:

1. Terraform-Befehlszeilenschnittstelle initialisieren.

   ../terraform init
   

   Die folgende Nachricht sollte angezeigt werden: Terraform has been successfully initialized!.

2. Erstellen Sie einen Terraform-Ausführungsplan. Der Terraform-Ausführungsplan fasst alle Aktionen zusammen, die ausgeführt werden müssen, um den IBM Cloud Logs-Namespace und die IAM-Zugriffsrichtlinie in Ihrem Konto zu erstellen.

   ../terraform plan
   

3. Erstellen Sie die Ressourcen.

   ../terraform apply
   

   Um Ressourcen zu löschen, führen Sie ./terraform destroy aus.

Weitere Schritte

Stellen Sie sicher, dass die Ressourcen erstellt werden. Starten Sie die Observability-Benutzeroberfläche und überprüfen Sie, ob die Instanz erstellt worden ist.

Sie können alle Module für produktionsreife Konfigurationen untersuchen:

• Terraform IBM Module(TIM)GitHub Repository
• Terraform IBM Module(TIM)-Register