blob: 0b233e9f3f76b3ec0fba3fd5528299412473d692 [file] [log] [blame]
// Copyright (c) HashiCorp, Inc.
// SPDX-License-Identifier: MPL-2.0
package logging
import (
"fmt"
"log"
"regexp"
"strings"
"github.com/hashicorp/terraform-plugin-sdk/v2/helper/customdiff"
"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
"github.com/hashicorp/terraform-provider-google-beta/google-beta/tpgresource"
transport_tpg "github.com/hashicorp/terraform-provider-google-beta/google-beta/transport"
)
var loggingBucketConfigSchema = map[string]*schema.Schema{
"name": {
Type: schema.TypeString,
Computed: true,
Description: `The resource name of the bucket`,
},
"location": {
Type: schema.TypeString,
Required: true,
ForceNew: true,
Description: `The location of the bucket.`,
},
"bucket_id": {
Type: schema.TypeString,
Required: true,
ForceNew: true,
Description: `The name of the logging bucket. Logging automatically creates two log buckets: _Required and _Default.`,
},
"description": {
Type: schema.TypeString,
Optional: true,
Computed: true,
Description: `An optional description for this bucket.`,
},
"retention_days": {
Type: schema.TypeInt,
Optional: true,
Default: 30,
Description: `Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.`,
},
"lifecycle_state": {
Type: schema.TypeString,
Computed: true,
Description: `The bucket's lifecycle such as active or deleted.`,
},
"cmek_settings": {
Type: schema.TypeList,
MaxItems: 1,
Optional: true,
Description: `The CMEK settings of the log bucket. If present, new log entries written to this log bucket are encrypted using the CMEK key provided in this configuration. If a log bucket has CMEK settings, the CMEK settings cannot be disabled later by updating the log bucket. Changing the KMS key is allowed.`,
Elem: &schema.Resource{
Schema: map[string]*schema.Schema{
"name": {
Type: schema.TypeString,
Computed: true,
Description: `The resource name of the CMEK settings.`,
},
"kms_key_name": {
Type: schema.TypeString,
Required: true,
Description: `The resource name for the configured Cloud KMS key.
KMS key name format:
"projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]"
To enable CMEK for the bucket, set this field to a valid kmsKeyName for which the associated service account has the required cloudkms.cryptoKeyEncrypterDecrypter roles assigned for the key.
The Cloud KMS key used by the bucket can be updated by changing the kmsKeyName to a new valid key name. Encryption operations that are in progress will be completed with the key that was in use when they started. Decryption operations will be completed using the key that was used at the time of encryption unless access to that key has been revoked.
See [Enabling CMEK for Logging Buckets](https://cloud.google.com/logging/docs/routing/managed-encryption-storage) for more information.`,
},
"kms_key_version_name": {
Type: schema.TypeString,
Computed: true,
Description: `The CryptoKeyVersion resource name for the configured Cloud KMS key.
KMS key name format:
"projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[VERSION]"
For example:
"projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key/cryptoKeyVersions/1"
This is a read-only field used to convey the specific configured CryptoKeyVersion of kms_key that has been configured. It will be populated in cases where the CMEK settings are bound to a single key version.`,
},
"service_account_id": {
Type: schema.TypeString,
Computed: true,
Description: `The service account associated with a project for which CMEK will apply.
Before enabling CMEK for a logging bucket, you must first assign the cloudkms.cryptoKeyEncrypterDecrypter role to the service account associated with the project for which CMEK will apply. Use [v2.getCmekSettings](https://cloud.google.com/logging/docs/reference/v2/rest/v2/TopLevel/getCmekSettings#google.logging.v2.ConfigServiceV2.GetCmekSettings) to obtain the service account ID.
See [Enabling CMEK for Logging Buckets](https://cloud.google.com/logging/docs/routing/managed-encryption-storage) for more information.`,
},
},
},
},
"index_configs": {
Type: schema.TypeSet,
MaxItems: 20,
Optional: true,
Description: `A list of indexed fields and related configuration data.`,
Elem: &schema.Resource{
Schema: map[string]*schema.Schema{
"field_path": {
Type: schema.TypeString,
Required: true,
Description: `The LogEntry field path to index.`,
},
"type": {
Type: schema.TypeString,
Required: true,
Description: `The type of data in this index
Note that some paths are automatically indexed, and other paths are not eligible for indexing. See [indexing documentation]( https://cloud.google.com/logging/docs/view/advanced-queries#indexed-fields) for details.
For example: jsonPayload.request.status`,
},
},
},
},
}
type loggingBucketConfigIDFunc func(d *schema.ResourceData, config *transport_tpg.Config) (string, error)
// ResourceLoggingBucketConfig creates a resource definition by merging a unique field (eg: folder) to a generic logging bucket
// config resource. In practice the only difference between these resources is the url location.
func ResourceLoggingBucketConfig(parentType string, parentSpecificSchema map[string]*schema.Schema, iDFunc loggingBucketConfigIDFunc) *schema.Resource {
return &schema.Resource{
Create: resourceLoggingBucketConfigAcquireOrCreate(parentType, iDFunc),
Read: resourceLoggingBucketConfigRead,
Update: resourceLoggingBucketConfigUpdate,
Delete: resourceLoggingBucketConfigDelete,
Importer: &schema.ResourceImporter{
State: resourceLoggingBucketConfigImportState(parentType),
},
Schema: tpgresource.MergeSchemas(loggingBucketConfigSchema, parentSpecificSchema),
UseJSONNumber: true,
CustomizeDiff: customdiff.All(
tpgresource.DefaultProviderProject,
),
}
}
var loggingBucketConfigIDRegex = regexp.MustCompile("(.+)/(.+)/locations/(.+)/buckets/(.+)")
func resourceLoggingBucketConfigImportState(parent string) schema.StateFunc {
return func(d *schema.ResourceData, meta interface{}) ([]*schema.ResourceData, error) {
parts := loggingBucketConfigIDRegex.FindStringSubmatch(d.Id())
if parts == nil {
return nil, fmt.Errorf("unable to parse logging sink id %#v", d.Id())
}
if len(parts) != 5 {
return nil, fmt.Errorf("Invalid id format. Format should be '{{parent}}/{{parent_id}}/locations/{{location}}/buckets/{{bucket_id}} with parent in %s", LoggingSinkResourceTypes)
}
validLoggingType := false
for _, v := range LoggingSinkResourceTypes {
if v == parts[1] {
validLoggingType = true
break
}
}
if !validLoggingType {
return nil, fmt.Errorf("Logging parent type %s is not valid. Valid resource types: %#v", parts[1],
LoggingSinkResourceTypes)
}
if err := d.Set(parent, parts[1]+"/"+parts[2]); err != nil {
return nil, fmt.Errorf("Error setting parent: %s", err)
}
if err := d.Set("location", parts[3]); err != nil {
return nil, fmt.Errorf("Error setting location: %s", err)
}
if err := d.Set("bucket_id", parts[4]); err != nil {
return nil, fmt.Errorf("Error setting bucket_id: %s", err)
}
return []*schema.ResourceData{d}, nil
}
}
func resourceLoggingBucketConfigAcquireOrCreate(parentType string, iDFunc loggingBucketConfigIDFunc) func(*schema.ResourceData, interface{}) error {
return func(d *schema.ResourceData, meta interface{}) error {
config := meta.(*transport_tpg.Config)
userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
if err != nil {
return err
}
id, err := iDFunc(d, config)
if err != nil {
return err
}
if parentType == "project" {
//logging bucket can be created only at the project level, in future api may allow for folder, org and other parent resources
log.Printf("[DEBUG] Fetching logging bucket config: %#v", id)
url, err := tpgresource.ReplaceVars(d, config, fmt.Sprintf("{{LoggingBasePath}}%s", id))
if err != nil {
return err
}
res, _ := transport_tpg.SendRequest(transport_tpg.SendRequestOptions{
Config: config,
Method: "GET",
RawURL: url,
UserAgent: userAgent,
})
if res == nil {
log.Printf("[DEGUG] Loggin Bucket not exist %s", id)
// we need to pass the id in here because we don't want to set it in state
// until we know there won't be any errors on create
return resourceLoggingBucketConfigCreate(d, meta, id)
}
}
d.SetId(id)
return resourceLoggingBucketConfigUpdate(d, meta)
}
}
func resourceLoggingBucketConfigCreate(d *schema.ResourceData, meta interface{}, id string) error {
config := meta.(*transport_tpg.Config)
userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
if err != nil {
return err
}
obj := make(map[string]interface{})
obj["name"] = d.Get("name")
obj["description"] = d.Get("description")
obj["retentionDays"] = d.Get("retention_days")
obj["cmekSettings"] = expandCmekSettings(d.Get("cmek_settings"))
obj["indexConfigs"] = expandIndexConfigs(d.Get("index_configs"))
url, err := tpgresource.ReplaceVars(d, config, "{{LoggingBasePath}}projects/{{project}}/locations/{{location}}/buckets?bucketId={{bucket_id}}")
if err != nil {
return err
}
log.Printf("[DEBUG] Creating new Bucket: %#v", obj)
billingProject := ""
project, err := tpgresource.GetProject(d, config)
if err != nil {
return err
}
billingProject = project
// err == nil indicates that the billing_project value was found
if bp, err := tpgresource.GetBillingProject(d, config); err == nil {
billingProject = bp
}
res, err := transport_tpg.SendRequest(transport_tpg.SendRequestOptions{
Config: config,
Method: "POST",
Project: billingProject,
RawURL: url,
UserAgent: userAgent,
Body: obj,
Timeout: d.Timeout(schema.TimeoutCreate),
})
if err != nil {
return fmt.Errorf("Error creating Bucket: %s", err)
}
d.SetId(id)
log.Printf("[DEBUG] Finished creating Bucket %q: %#v", d.Id(), res)
return resourceLoggingBucketConfigRead(d, meta)
}
func resourceLoggingBucketConfigRead(d *schema.ResourceData, meta interface{}) error {
config := meta.(*transport_tpg.Config)
userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
if err != nil {
return err
}
log.Printf("[DEBUG] Fetching logging bucket config: %#v", d.Id())
url, err := tpgresource.ReplaceVars(d, config, fmt.Sprintf("{{LoggingBasePath}}%s", d.Id()))
if err != nil {
return err
}
res, err := transport_tpg.SendRequest(transport_tpg.SendRequestOptions{
Config: config,
Method: "GET",
RawURL: url,
UserAgent: userAgent,
})
if err != nil {
log.Printf("[WARN] Unable to acquire logging bucket config at %s", d.Id())
d.SetId("")
return err
}
if err := d.Set("name", res["name"]); err != nil {
return fmt.Errorf("Error setting name: %s", err)
}
if err := d.Set("description", res["description"]); err != nil {
return fmt.Errorf("Error setting description: %s", err)
}
if err := d.Set("lifecycle_state", res["lifecycleState"]); err != nil {
return fmt.Errorf("Error setting lifecycle_state: %s", err)
}
if err := d.Set("retention_days", res["retentionDays"]); err != nil {
return fmt.Errorf("Error setting retention_days: %s", err)
}
if err := d.Set("cmek_settings", flattenCmekSettings(res["cmekSettings"])); err != nil {
return fmt.Errorf("Error setting cmek_settings: %s", err)
}
if err := d.Set("index_configs", flattenIndexConfigs(res["indexConfigs"])); err != nil {
return fmt.Errorf("Error setting index_configs: %s", err)
}
return nil
}
func resourceLoggingBucketConfigUpdate(d *schema.ResourceData, meta interface{}) error {
config := meta.(*transport_tpg.Config)
userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
if err != nil {
return err
}
obj := make(map[string]interface{})
url, err := tpgresource.ReplaceVars(d, config, fmt.Sprintf("{{LoggingBasePath}}%s", d.Id()))
if err != nil {
return err
}
obj["retentionDays"] = d.Get("retention_days")
obj["description"] = d.Get("description")
obj["cmekSettings"] = expandCmekSettings(d.Get("cmek_settings"))
obj["indexConfigs"] = expandIndexConfigs(d.Get("index_configs"))
updateMask := []string{}
if d.HasChange("retention_days") {
updateMask = append(updateMask, "retentionDays")
}
if d.HasChange("description") {
updateMask = append(updateMask, "description")
}
if d.HasChange("cmek_settings") {
updateMask = append(updateMask, "cmekSettings")
}
if d.HasChange("index_configs") {
updateMask = append(updateMask, "indexConfigs")
}
url, err = transport_tpg.AddQueryParams(url, map[string]string{"updateMask": strings.Join(updateMask, ",")})
if err != nil {
return err
}
_, err = transport_tpg.SendRequest(transport_tpg.SendRequestOptions{
Config: config,
Method: "PATCH",
RawURL: url,
UserAgent: userAgent,
Body: obj,
Timeout: d.Timeout(schema.TimeoutUpdate),
})
if err != nil {
return fmt.Errorf("Error updating Logging Bucket Config %q: %s", d.Id(), err)
}
return resourceLoggingBucketConfigRead(d, meta)
}
func resourceLoggingBucketConfigDelete(d *schema.ResourceData, meta interface{}) error {
name := d.Get("bucket_id")
for _, restrictedName := range []string{"_Required", "_Default"} {
if name == restrictedName {
log.Printf("[WARN] Default logging bucket configs cannot be deleted. Removing logging bucket config from state: %#v", d.Id())
return nil
}
}
config := meta.(*transport_tpg.Config)
userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
if err != nil {
return err
}
url, err := tpgresource.ReplaceVars(d, config, fmt.Sprintf("{{LoggingBasePath}}%s", d.Id()))
if err != nil {
return err
}
if _, err := transport_tpg.SendRequest(transport_tpg.SendRequestOptions{
Config: config,
Method: "DELETE",
RawURL: url,
UserAgent: userAgent,
Timeout: d.Timeout(schema.TimeoutUpdate),
}); err != nil {
return fmt.Errorf("Error deleting Logging Bucket Config %q: %s", d.Id(), err)
}
return nil
}
func expandCmekSettings(v interface{}) interface{} {
if v == nil {
return nil
}
l := v.([]interface{})
if len(l) == 0 || l[0] == nil {
return nil
}
original := l[0].(map[string]interface{})
transformed := map[string]interface{}{
"name": original["name"],
"kmsKeyName": original["kms_key_name"],
"kmsKeyVersionName": original["kms_key_version_name"],
"serviceAccountId": original["service_account_id"],
}
return transformed
}
func flattenCmekSettings(cmekSettings interface{}) []map[string]interface{} {
if cmekSettings == nil {
return nil
}
cmekSettingsData := cmekSettings.(map[string]interface{})
data := map[string]interface{}{
"name": cmekSettingsData["name"],
"kms_key_name": cmekSettingsData["kmsKeyName"],
"kms_key_version_name": cmekSettingsData["kmsKeyVersionName"],
"service_account_id": cmekSettingsData["serviceAccountId"],
}
return []map[string]interface{}{data}
}
func expandIndexConfigs(maybeIndexConfigs interface{}) []map[string]interface{} {
if maybeIndexConfigs == nil {
return nil
}
indexConfigs := maybeIndexConfigs.(*schema.Set).List()
transformedIndexConfigs := make([]map[string]interface{}, 0, len(indexConfigs))
for _, entry := range indexConfigs {
original := entry.(map[string]interface{})
transformed := map[string]interface{}{
"fieldPath": original["field_path"],
"type": original["type"],
}
transformedIndexConfigs = append(transformedIndexConfigs, transformed)
}
return transformedIndexConfigs
}
func flattenIndexConfigs(maybeIndexConfigs interface{}) []map[string]interface{} {
if maybeIndexConfigs == nil {
return nil
}
indexConfigs := maybeIndexConfigs.([]interface{})
flattenedIndexConfigs := make([]map[string]interface{}, 0, len(indexConfigs))
for _, entry := range indexConfigs {
indexConfig := entry.(map[string]interface{})
if len(indexConfig) < 1 {
continue
}
flattenedIndexConfigs = append(flattenedIndexConfigs, map[string]interface{}{
"field_path": indexConfig["fieldPath"],
"type": indexConfig["type"],
})
}
return flattenedIndexConfigs
}