Skip to content

Conversation

@eedugon
Copy link
Contributor

@eedugon eedugon commented Nov 6, 2025

Summary

This PR converts duplicate content into reusable snippets for remote cluster configuration, specifically for private CA connections and trusted environment management, plus some small refinement.

Note: The content of retrieve-ece-ca.md would benefit from a writing review, as it's the only piece of text that was elaborated for this PR, the rest is internal refactoring and minor refinement.

Changes

Private CA Certificate Retrieval

  • Created retrieve-ece-ca.md snippet containing the steps to retrieve the CA certificate of a remote ECE proxy
  • Created apikeys-local-ece-remote-private.md snippet with the steps to configure the local ECE deployment when the remote cluster certificate is signed by a private CA
  • Created apikeys-local-ech-remote-private.md snippet with the steps to configure the local {{ech}} deployment when the remote cluster certificate is signed by a private CA
  • Replaced duplicate content in all affected files with snippet includes

Trusted Environment Management

  • Converted the following pages to use shared snippets as they were 99% identical:
    • ec-edit-remove-trusted-environment.md
    • ece-edit-remove-trusted-environment.md
  • Created snippets:
    • trusted-environment-manage.md - Introduction section
    • trusted-environment-remove-cert.md - Remove certificate-based trusted environment steps
    • trusted-environment-update-cert.md - Update certificate-based trusted environment steps
    • trusted-environment-change-api-key.md - Change cross-cluster API key steps

Additional Improvements

  • Removed duplicate image files (cloud-enterprise-delete-trust-environment.png and cloud-enterprise-edit-trust-environment.png) that were identical to their non-enterprise counterparts
  • Updated image references to use the unified image names

Minor Updates

  • Applied small changes to other snippets that will be used later with incoming ECK-related documentation for remote clusters

@eedugon eedugon marked this pull request as ready for review November 6, 2025 22:04
@eedugon eedugon requested a review from a team as a code owner November 6, 2025 22:04
@eedugon eedugon changed the title private CA connections converted to snippets Private CA connections converted to snippets Nov 6, 2025
@eedugon eedugon changed the title Private CA connections converted to snippets Private CA connections and trusted environments management converted to snippets Nov 6, 2025
@eedugon eedugon changed the title Private CA connections and trusted environments management converted to snippets Remote clusters - private CA connections and trusted environments management converted to snippets Nov 6, 2025
Copy link
Contributor

@yetanothertw yetanothertw left a comment

Choose a reason for hiding this comment

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

Great work on this, Edu! Reusable content is much easier to maintain!

I've left a few minor nitpicky comments, and a question because the intention of the instruction wasn't clear to me (but maybe it would be clear to an admin performing this task).

Co-authored-by: Vlada Chirmicci <vlada.chirmicci@elastic.co>
@eedugon eedugon merged commit ac93a60 into main Nov 7, 2025
7 checks passed
@eedugon eedugon deleted the remote_clusters_generic_extra_snippets branch November 7, 2025 12:13
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.

3 participants