feat(website): add docs::warnings macro support and warn about no auth

scripts/generate-component-docs.rb

@@ -781,6 +781,16 @@ def resolve_schema(root_schema, schema)
     resolved['required'] = is_required_field
   end
 
+  # Resolve any warnings attached to this option.
+  #
+  # Warnings can be specified in Rust via `#[configurable(metadata(docs::warnings = "..."))]`.
+  # Multiple warnings can be specified by repeating the attribute, and they will be emitted as an
+  # array in the CUE output.
+  warnings = get_schema_metadata(schema, 'docs::warnings')
+  if !warnings.nil?
+    resolved['warnings'] = warnings.is_a?(Array) ? warnings : [warnings]
+  end
+
   # Reconcile the resolve schema, which essentially gives us a chance to, once the schema is
   # entirely resolved, check it for logical inconsistencies, fix up anything that we reasonably can,
   # and so on.

src/config/api.rs

@@ -5,6 +5,7 @@ use vector_lib::configurable::configurable_component;
 
 /// API options.
 #[configurable_component(global_option("api"))]
+#[configurable(metadata(docs::warnings = "The API has no authentication and exposes all event data flowing through Vector. It must not be exposed to untrusted clients."))]
 #[derive(Clone, Copy, Debug, Eq, PartialEq)]
 #[serde(default, deny_unknown_fields)]
 pub struct Options {

website/cue/reference/generated/configuration.cue

@@ -70,6 +70,7 @@ generated: configuration: configuration: {
 			}
 		}
 		description: "API options."
+		warnings: ["The API has no authentication and exposes all event data flowing through Vector. It must not be exposed to untrusted clients."]
 	}
 	enrichment_tables: {
 		type: object: options: {