Skip to content

feat(terraform): bring-your-own Data Prepper pipeline + gp3 StorageClass - #16

Draft
kylehounslow wants to merge 5 commits into
mainfrom
feat/byo-data-prepper-pipeline
Draft

feat(terraform): bring-your-own Data Prepper pipeline + gp3 StorageClass#16
kylehounslow wants to merge 5 commits into
mainfrom
feat/byo-data-prepper-pipeline

Conversation

@kylehounslow

Copy link
Copy Markdown
Owner

What

Two additive, default-no-op terraform changes that let an operator run the stack as a custom-routing backend without editing chart defaults. Builds on the dataPrepperManageSecret gate merged in opensearch-project#308 (upstream).

  • data_prepper_pipeline_secret_file (default ""): path to a pipelines.yaml template. When set, terraform renders it (via templatefile, with opensearch_user/opensearch_password/trace_flush_interval) into the data-prepper-pipeline Secret, sets dataPrepperManageSecret=false so the chart renders no pipeline Secret of its own, and orders the Secret before the wait=true release so Data Prepper mounts it at boot.
  • extra_helm_values (default []): additional values file paths layered onto the release last.
  • gp3 StorageClass: EKS ships only gp2, but opensearch_storage_class/cortex_storage_class default to gp3. Without this, gp3 PVCs hang Pending and the release times out. Created via the EBS CSI driver, WaitForFirstConsumer to match gp2.

Why

The chart stays generic; a consumer supplies routing from outside. This completes the gate's usability (the gate shipped in opensearch-project#308 but nothing wired the external secret through terraform).

Status

Draft against the fork while validating end-to-end on a fresh account. Not for upstream until the full path is confirmed.

Test

  • terraform validate passes; terraform fmt clean.
  • Applied on a fresh account (752368927612): 78 resources, the data-prepper-pipeline Secret carries the consumer routing with no helm managed-by label (terraform-created, chart rendered nothing), Data Prepper mounted it and started, gp3 PVCs bound.

kylehounslow and others added 5 commits June 24, 2026 14:35
Add extra_helm_values and data_prepper_pipeline_secret_file variables so an
operator can supply a custom Data Prepper pipeline through the chart's
dataPrepperManageSecret=false gate: terraform renders the file into the
data-prepper-pipeline Secret and orders it before the release. Create a gp3
StorageClass (EKS ships only gp2) since the OpenSearch/Cortex storage_class
variables default to gp3.

Signed-off-by: Kyle Hounslow <kylhouns@amazon.com>
verbosity detailed serializes every span, log, and metric to stdout, which
throttles the collector pipeline under sustained load (observed ~6x slower
trace ingest at bench scale, with OpenSearch write pools idle). basic logs
per-batch counts, which is enough for the debug exporter's purpose.

Signed-off-by: Kyle Hounslow <kylhouns@amazon.com>
Signed-off-by: Kyle Hounslow <kylhouns@amazon.com>
Clarified comments regarding StorageClass creation for EKS and PVC binding.

Signed-off-by: Kyle Hounslow <7102778+kylehounslow@users.noreply.github.com>
…from chart

- create_gp3_storage_class (default true) lets operators opt out on clusters
  that already provide gp3 (EKS Auto Mode, manual, shared), avoiding the
  'already exists' apply failure.
- BYO pipeline Secret reads opensearchUsername/opensearchPassword defaults from
  the chart's values.yaml instead of re-hardcoding the literals, so the Secret
  and the cluster can't drift apart if the chart default changes.
- Add var.opensearch_username, wired into the release like opensearch_password.

Signed-off-by: Kyle Hounslow <kylhouns@amazon.com>
@kylehounslow
kylehounslow force-pushed the feat/byo-data-prepper-pipeline branch from 34f3a9a to 475c894 Compare June 26, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant