Skip to content

ECE AWS load balancers, ipv6 and proxy protocol v2 tutorial#5602

Draft
eedugon wants to merge 6 commits intomainfrom
ece_aws_nlb_ipv6_tutorial
Draft

ECE AWS load balancers, ipv6 and proxy protocol v2 tutorial#5602
eedugon wants to merge 6 commits intomainfrom
ece_aws_nlb_ipv6_tutorial

Conversation

@eedugon
Copy link
Copy Markdown
Contributor

@eedugon eedugon commented Mar 24, 2026

DO NOT MERGE UNTIL ECE RELEASE IS CLARIFIED

Summary

Adding new doc from https://github.com/elastic/cloud/pull/153120 into docs-content as a tutorial.

Original content by @brendandw refined in this commit (for your review):

  • Includes a small clarification between client IP preservation vs propagation with proxy protocol v2.
  • Update the existing installation procedure, enforcing one-by-one proxy container recreation and validation to reduce outage risks.
  • Cross-links to and from other ECE docs.

Pending:

  • Clarify to what ECE version this applies.
  • Clarify since when the ECE installation script and proxy supports --proxy-protocol-version 2 and --proxy-protocol-lenient flags, because our docs are already mentioning proxy protocol v2 support in the ece-load-balancers.md doc.
  • Determine if we need to update standard installation documents to mention the possibility of needing / wanting proxy protocol version 2, as that should be configured at installation time preferably.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes : cursor with GPT model
  • No

@eedugon eedugon changed the title Ece aws nlb ipv6 tutorial ECE AWS load balancers, ipv6 and proxy protocol v2 tutorial Mar 24, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 24, 2026

Vale Linting Results

Summary: 1 warning, 1 suggestion found

⚠️ Warnings (1)
File Line Rule Message
deploy-manage/deploy/cloud-enterprise/ece-load-balancers.md 47 Elastic.Spelling 'balancer's' is a possible misspelling.
💡 Suggestions (1)
File Line Rule Message
deploy-manage/deploy/cloud-enterprise/ece-networking-prereq.md 15 Elastic.WordChoice Consider using 'deactivated, deselected, hidden, turned off, unavailable' instead of 'disabled', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 24, 2026

@eedugon eedugon self-assigned this Mar 24, 2026
@eedugon eedugon added the ece Elastic Cloud Enterprise label Mar 25, 2026
Comment on lines +191 to +194
```bash
# Get the admin password from an ECE host
ADMIN_PASSWORD=$(sudo cat /mnt/data/elastic/bootstrap-state/bootstrap-secrets.json | jq -r '.adminconsole_root_password')

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copied from https://github.com/elastic/cloud/pull/153120#pullrequestreview-3998097378, by @jakommo :

I think this only exists on the first ECE host that was installed and I've also seen that customers removed it for security reasons.
Should we default to set the PW manually with a note that it can be sourced from this file if it exists on the host?

There's no need to provide this step, maybe just as a tip in case the user doesn't know the admin password. Ideally we should link to other official docs if the reader needs to know more about the admin password. For the tutorial this is already reported as a prerequisite.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ece Elastic Cloud Enterprise

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant