Skip to content

Conversation

pkward
Copy link

@pkward pkward commented Jul 11, 2025

Summary

This PR adds a community-contributed example to the "Configure offline endpoints and air-gapped environments" documentation. It introduces the artifacts-bundler Bash-based CLI tool that automates downloading Elastic Stack artifacts, endpoint security content, and optionally builds an NGINX image for serving the content in air-gapped environments.

Why This Is Useful

Preparing air-gapped Elastic deployments—especially Elastic Defend with endpoint artifact requirements—is time-consuming and error-prone when done manually. This tool simplifies:

  • Multi-version artifact downloading
  • Endpoint manifest and global artifact fetch
  • Bundle creation (.tar.gz)
  • Optional Docker/Nginx server generation

This is especially helpful for DoD or offline regulated environments.

Placement

This contribution adds a dropdown section under:

Step 3: Manually copy artifact updates

in the configure-offline-endpoints-air-gapped-environments.md document. It provides an alternative method using a community-contributed Bash script to automate downloading and bundling endpoint artifacts.

@pkward pkward requested a review from a team as a code owner July 11, 2025 16:59
Copy link

github-actions bot commented Jul 11, 2025

@florent-leborgne
Copy link
Contributor

Hi @pkward, just want to say we've seen your suggestion and are currently discussing it internally as it's not usual for us to openly link to community third-parties from our official docs. We'll provide an update as soon as we have a clear path. Thank you for your contribution, and for your patience!

@xeraa
Copy link

xeraa commented Jul 24, 2025

Hey @pkward,
This looks like a great addition. Could we interest you in contributing it as a blog post?
To explain it a bit more: The Elastic documentation documents and recommends officially supported tools and configurations, which doesn't quite work here. But it is very useful so we'd love to find the right home for it :)

@pkward
Copy link
Author

pkward commented Jul 24, 2025

Hey @pkward, This looks like a great addition. Could we interest you in contributing it as a blog post? To explain it a bit more: The Elastic documentation documents and recommends officially supported tools and configurations, which doesn't quite work here. But it is very useful so we'd love to find the right home for it :)

Yes, of course! Is there a similar process for submitting the contribution as a Blog post?

@xeraa
Copy link

xeraa commented Jul 24, 2025

Google doc would be preferred so we can go back and forth a bit more easily. I think some context / story around it + a bit more structure (like https://www.elastic.co/blog/elasticsearch-mcp-server-aws-marketplace etc) and we should be good to go. And if you share it with me (philipp at elastic dot co), I can kick off the rest of the process on our side :)

@pkward
Copy link
Author

pkward commented Jul 25, 2025

Google doc would be preferred so we can go back and forth a bit more easily. I think some context / story around it + a bit more structure (like https://www.elastic.co/blog/elasticsearch-mcp-server-aws-marketplace etc) and we should be good to go. And if you share it with me (philipp at elastic dot co), I can kick off the rest of the process on our side :)

I just shared the document with you in google docs. Thanks again!

@xeraa
Copy link

xeraa commented Jul 25, 2025

That was quick :)
I kicked off the blog process internally to work out the finer details. Hold tight.

@florent-leborgne
Copy link
Contributor

Glad we found a way! I take it that we can close this PR.

Feel free to contribute to the docs or suggest other improvements in the future.
Thanks again!

@pkward
Copy link
Author

pkward commented Jul 25, 2025

Thank you both! @florent-leborgne @xeraa

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