[ISSUE-154] Add Watches

.github/workflows/test.yml

@@ -60,7 +60,9 @@ jobs:
         image: docker.elastic.co/elasticsearch/elasticsearch:${{ matrix.version }}
         env:
           discovery.type: single-node
+          xpack.license.self_generated.type: trial
           xpack.security.enabled: true
+          xpack.watcher.enabled: true
           repositories.url.allowed_urls: https://example.com/*
           path.repo: /tmp
           ELASTIC_PASSWORD: ${{ env.ELASTIC_PASSWORD }}

Makefile

@@ -86,6 +86,8 @@ docker-elasticsearch: docker-network ## Start Elasticsearch single node cluster
 		-p 9200:9200 -p 9300:9300 \
 		-e "discovery.type=single-node" \
 		-e "xpack.security.enabled=true" \
+		-e "xpack.watcher.enabled=true" \
+		-e "xpack.license.self_generated.type=trial" \
 		-e "repositories.url.allowed_urls=https://example.com/*" \
 		-e "path.repo=/tmp" \
 		-e ELASTIC_PASSWORD=$(ELASTICSEARCH_PASSWORD) \

docs/resources/elasticsearch_logstash_pipeline.md

@@ -113,5 +113,5 @@ Optional:
 Import is supported using the following syntax:
 
 ```shell
-terraform import elasticstack_elasticsearch_security_logstash_pipeline.my_pipeline <cluster_uuid>/<pipeline ID>
+terraform import elasticstack_elasticsearch_logstash_pipeline.my_pipeline <cluster_uuid>/<pipeline ID>
 ```

docs/resources/elasticsearch_watcher_watch.md

@@ -0,0 +1,89 @@
+---
+subcategory: "Watcher"
+layout: ""
+page_title: "Elasticstack: elasticstack_elasticsearch_watcher_watch Resource"
+description: |-
+  Adds and manages a Watch.
+---
+
+# Resource: elasticstack_elasticsearch_watcher_watch
+
+Adds and manages a Watch. See: https://www.elastic.co/guide/en/elasticsearch/reference/current/watcher-api.html
+
+## Example Usage
+
+```terraform
+provider "elasticstack" {
+  elasticsearch {}
+}
+
+resource "elasticstack_elasticsearch_watcher_watch" "example" {
+  watch_id = "test_watch"
+  active   = true
+
+  body = jsonencode({
+    "trigger" = {
+      "schedule" = {
+        "cron" = "0 0/1 * * * ?"
+      }
+    },
+    "input" = {
+      "none" = {}
+    },
+    "condition" = {
+      "always" = {}
+    },
+    "actions" = {},
+    "metadata" = {
+      "example_key" = "example_value"
+    },
+    "throttle_period_in_millis" = 10000
+  })
+}
+
+output "watch" {
+  value = elasticstack_elasticsearch_watcher_watch.example.watch_id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `body` (String) Configuration for the pipeline.
+- `watch_id` (String) Identifier for the watch.
+
+### Optional
+
+- `active` (Boolean) Defines whether the watch is active or inactive by default. The default value is true, which means the watch is active by default.
+- `elasticsearch_connection` (Block List, Max: 1, Deprecated) Elasticsearch connection configuration block. This property will be removed in a future provider version. Configure the Elasticsearch connection via the provider configuration instead. (see [below for nested schema](#nestedblock--elasticsearch_connection))
+
+### Read-Only
+
+- `id` (String) Internal identifier of the resource.
+
+<a id="nestedblock--elasticsearch_connection"></a>
+### Nested Schema for `elasticsearch_connection`
+
+Optional:
+
+- `api_key` (String, Sensitive) API Key to use for authentication to Elasticsearch
+- `ca_data` (String) PEM-encoded custom Certificate Authority certificate
+- `ca_file` (String) Path to a custom Certificate Authority certificate
+- `cert_data` (String) PEM encoded certificate for client auth
+- `cert_file` (String) Path to a file containing the PEM encoded certificate for client auth
+- `endpoints` (List of String, Sensitive) A list of endpoints where the terraform provider will point to, this must include the http(s) schema and port number.
+- `insecure` (Boolean) Disable TLS certificate validation
+- `key_data` (String, Sensitive) PEM encoded private key for client auth
+- `key_file` (String) Path to a file containing the PEM encoded private key for client auth
+- `password` (String, Sensitive) Password to use for API authentication to Elasticsearch.
+- `username` (String) Username to use for API authentication to Elasticsearch.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import elasticstack_elasticsearch_watcher_watch.watch_id <cluster_uuid>/<watch ID>
+```

examples/resources/elasticstack_elasticsearch_logstash_pipeline/import.sh

@@ -1 +1 @@
-terraform import elasticstack_elasticsearch_security_logstash_pipeline.my_pipeline <cluster_uuid>/<pipeline ID>
+terraform import elasticstack_elasticsearch_logstash_pipeline.my_pipeline <cluster_uuid>/<pipeline ID>

examples/resources/elasticstack_elasticsearch_watcher_watch/import.sh

@@ -0,0 +1 @@
+terraform import elasticstack_elasticsearch_watcher_watch.watch_id <cluster_uuid>/<watch ID>

examples/resources/elasticstack_elasticsearch_watcher_watch/resource.tf

@@ -0,0 +1,31 @@
+provider "elasticstack" {
+  elasticsearch {}
+}
+
+resource "elasticstack_elasticsearch_watcher_watch" "example" {
+  watch_id = "test_watch"
+  active   = true
+
+  body = jsonencode({
+    "trigger" = {
+      "schedule" = {
+        "cron" = "0 0/1 * * * ?"
+      }
+    },
+    "input" = {
+      "none" = {}
+    },
+    "condition" = {
+      "always" = {}
+    },
+    "actions" = {},
+    "metadata" = {
+      "example_key" = "example_value"
+    },
+    "throttle_period_in_millis" = 10000
+  })
+}
+
+output "watch" {
+  value = elasticstack_elasticsearch_watcher_watch.example.watch_id
+}

internal/clients/elasticsearch/watch.go

@@ -0,0 +1,84 @@
+package elasticsearch
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"net/http"
+
+	"github.com/elastic/terraform-provider-elasticstack/internal/clients"
+	"github.com/elastic/terraform-provider-elasticstack/internal/models"
+	"github.com/elastic/terraform-provider-elasticstack/internal/utils"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+)
+
+func PutWatch(ctx context.Context, apiClient *clients.ApiClient, watch *models.Watch) diag.Diagnostics {
+	var diags diag.Diagnostics
+	watchBodyBytes, err := json.Marshal(watch.Body)
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	esClient, err := apiClient.GetESClient()
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	body := esClient.Watcher.PutWatch.WithBody(bytes.NewReader(watchBodyBytes))
+	active := esClient.Watcher.PutWatch.WithActive(watch.Status.State.Active)
+	res, err := esClient.Watcher.PutWatch(watch.WatchID, active, body, esClient.Watcher.PutWatch.WithContext(ctx))
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	defer res.Body.Close()
+	if diags := utils.CheckError(res, "Unable to create or update watch"); diags.HasError() {
+		return diags
+	}
+
+	return diags
+}
+
+func GetWatch(ctx context.Context, apiClient *clients.ApiClient, watchID string) (*models.Watch, diag.Diagnostics) {
+	var diags diag.Diagnostics
+
+	esClient, err := apiClient.GetESClient()
+	if err != nil {
+		return nil, diag.FromErr(err)
+	}
+
+	res, err := esClient.Watcher.GetWatch(watchID, esClient.Watcher.GetWatch.WithContext(ctx))
+	if err != nil {
+		return nil, diag.FromErr(err)
+	}
+	defer res.Body.Close()
+	if res.StatusCode == http.StatusNotFound {
+		return nil, nil
+	}
+	if diags := utils.CheckError(res, "Unable to find watch on cluster."); diags.HasError() {
+		return nil, diags
+	}
+
+	var watch models.Watch
+	if err := json.NewDecoder(res.Body).Decode(&watch); err != nil {
+		return nil, diag.FromErr(err)
+	}
+
+	watch.WatchID = watchID
+	return &watch, diags
+}
+
+func DeleteWatch(ctx context.Context, apiClient *clients.ApiClient, watchID string) diag.Diagnostics {
+	var diags diag.Diagnostics
+	esClient, err := apiClient.GetESClient()
+	if err != nil {
+		return diag.FromErr(err)
+	}
+	res, err := esClient.Watcher.DeleteWatch(watchID, esClient.Watcher.DeleteWatch.WithContext(ctx))
+
+	if err != nil && res.IsError() {
+		return diag.FromErr(err)
+	}
+	defer res.Body.Close()
+	if diags := utils.CheckError(res, "Unable to delete watch"); diags.HasError() {
+		return diags
+	}
+	return diags
+}