chore(releasing): Prepare v0.38.0 release

Signed-off-by: Jesse Szwedko <[email protected]>
vectordotdev · May 7, 2024 · ea0ec6f · ea0ec6f
1 parent 79a2294
commit ea0ec6f
Show file tree

Hide file tree

Showing 29 changed files with 402 additions and 69 deletions.
diff --git a/changelog.d/19183_chronicle_namespace_support.enhancement.md b/changelog.d/19183_chronicle_namespace_support.enhancement.md
diff --git a/changelog.d/19686_element_size_histogram.enhancement.md b/changelog.d/19686_element_size_histogram.enhancement.md
diff --git a/changelog.d/19990_support_loading_secrets_from_aws_secrets_manager.feature.md b/changelog.d/19990_support_loading_secrets_from_aws_secrets_manager.feature.md
diff --git a/changelog.d/20074_protobuf_decoder.breaking.md b/changelog.d/20074_protobuf_decoder.breaking.md
diff --git a/changelog.d/20154_length_delimited_framing_options.feature.md b/changelog.d/20154_length_delimited_framing_options.feature.md
diff --git a/changelog.d/20172_max_number_of_messages.enhancement.md b/changelog.d/20172_max_number_of_messages.enhancement.md
diff --git a/changelog.d/20214_amqp_expiration.enhancement.md b/changelog.d/20214_amqp_expiration.enhancement.md
diff --git a/changelog.d/20224_kafka_source_event_instrumentation.fix.md b/changelog.d/20224_kafka_source_event_instrumentation.fix.md
diff --git a/changelog.d/20228_fix-log-to-metric-set-supported.fix.md b/changelog.d/20228_fix-log-to-metric-set-supported.fix.md
diff --git a/changelog.d/20244_change_inner_databend_client.enhancement.md b/changelog.d/20244_change_inner_databend_client.enhancement.md
diff --git a/changelog.d/20265-distroless-debian12.enhancement.md b/changelog.d/20265-distroless-debian12.enhancement.md
diff --git a/changelog.d/20281_chronicle_labels_support.enhancement.md b/changelog.d/20281_chronicle_labels_support.enhancement.md
diff --git a/changelog.d/20282_aws_access_key_id_and_assume_role_auth.fix.md b/changelog.d/20282_aws_access_key_id_and_assume_role_auth.fix.md
diff --git a/changelog.d/20292_splunk_hec_add_message_semantic_meaning.fix.md b/changelog.d/20292_splunk_hec_add_message_semantic_meaning.fix.md
diff --git a/changelog.d/20331_databend_config_ndjson.enhancement.md b/changelog.d/20331_databend_config_ndjson.enhancement.md
diff --git a/changelog.d/20335_added_support_for_insert_distributed_one_random_shard.feature.md b/changelog.d/20335_added_support_for_insert_distributed_one_random_shard.feature.md
diff --git a/changelog.d/20437-enterprise.deprecation.md b/changelog.d/20437-enterprise.deprecation.md
diff --git a/changelog.d/dd_agent_parse_ddtags_format.breaking.md b/changelog.d/dd_agent_parse_ddtags_format.breaking.md
diff --git a/changelog.d/dd_logs_reconstruct_ddtags.fix.md b/changelog.d/dd_logs_reconstruct_ddtags.fix.md
diff --git a/changelog.d/elasticsearch_sink_document_versioning.feature.md b/changelog.d/elasticsearch_sink_document_versioning.feature.md
diff --git a/changelog.d/prometheus_mixed_gauges.fix.md b/changelog.d/prometheus_mixed_gauges.fix.md
diff --git a/changelog.d/remove_strict_env_vars.breaking.md b/changelog.d/remove_strict_env_vars.breaking.md
diff --git a/changelog.d/splunk_hec_logs_auto_extract_ts.fix.md b/changelog.d/splunk_hec_logs_auto_extract_ts.fix.md
diff --git a/distribution/install.sh b/distribution/install.sh
@@ -13,7 +13,7 @@ set -u
 # If PACKAGE_ROOT is unset or empty, default it.
 PACKAGE_ROOT="${PACKAGE_ROOT:-"https://packages.timber.io/vector"}"
 # If VECTOR_VERSION is unset or empty, default it.
-VECTOR_VERSION="${VECTOR_VERSION:-"0.37.1"}"
+VECTOR_VERSION="${VECTOR_VERSION:-"0.38.0"}"
 _divider="--------------------------------------------------------------------------------"
 _prompt=">>>"
 _indent="   "

diff --git a/website/content/en/highlights/2024-05-07-0-38-0-upgrade-guide.md b/website/content/en/highlights/2024-05-07-0-38-0-upgrade-guide.md
@@ -0,0 +1,64 @@
+---
+date: "2024-05-06"
+title: "0.38 Upgrade Guide"
+description: "An upgrade guide that addresses breaking changes in 0.38.0"
+authors: ["jszwedko"]
+release: "0.38.0"
+hide_on_release_notes: false
+badges:
+  type: breaking change
+---
+
+Vector's 0.38.0 release includes a **breaking change**:
+
+1. [Vector now requires mandatory environment variables](#strict-env-vars)
+
+and **deprecations**:
+
+1. [Deprecation of undefined environment variable warnings](#strict-env-vars)
+1. [Deprecation of `enterprise` configuration](#enterprise-configuration)
+
+We cover them below to help you upgrade quickly:
+
+## Upgrade guide
+
+### Breaking Change
+
+#### Vector now requires mandatory environment variables {#strict-env-vars}
+
+Vector has the ability to [interpolate environment variables into its
+configuration](/docs/reference/configuration/#environment-variables) as a means of templating
+configuration. Now, if an environment variable is undefined, and no default is set, Vector will
+output an error and stop. To set a default, use the `-` interpolation syntax.
+
+If you want to have Vector start-up even if an environment variable is undefined you can provide
+a default like `${FOO-bar}` to default `FOO` to `bar` if it is unset.
+
+The reason for this change is that users often miss the undefined variable warning and are confused
+by Vector not behaving as the expected. Certain characters need to be escaped in regex capture
+groups to avoid interpolation. For example, instead of using `$1`, you need to add an escape as
+`$$1`.
+
+### Deprecations
+
+#### Path coalescing is deprecated {#path-coalescing}
+
+Coalescing of field lookup paths (e.g. `.(field1|field2)`) are deprecated and will be removed in
+a future version. This feature did not seem to be used much and significantly complicates the parts
+of the codebase.
+
+If you were using this feature, you can accomplish the same through conditionals like:
+
+```vrl
+field = if exists(.field1) {
+  .field1
+} else if exists(.field2) {
+  .field2
+}
+```
+
+#### Deprecation of `enterprise` configuration {#enterprise-configuration}
+
+The `enterprise` global configuration option that was used to integrate Vector with the Datadog
+Observability Pipelines product has been deprecated and will be removed in a future Vector version.
+Please reach out to Datadog support if you are impacted by this.
diff --git a/website/content/en/releases/0.38.0.md b/website/content/en/releases/0.38.0.md
@@ -0,0 +1,4 @@
+---
+title: Vector v0.38.0 release notes
+weight: 21
+---
diff --git a/website/cue/reference/administration/interfaces/kubectl.cue b/website/cue/reference/administration/interfaces/kubectl.cue
@@ -19,7 +19,7 @@ administration: interfaces: kubectl: {
 	role_implementations: [Name=string]: {
 		commands: {
 			_deployment_variant:       string
-			_vector_version:           "0.37"
+			_vector_version:           "0.38"
 			_namespace:                string | *"vector"
 			_controller_resource_type: string
 			_controller_resource_name: string | *_deployment_variant