Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Deploy and Manage: Elastic Cloud Enterprise Deploy #499

Open
wants to merge 19 commits into
base: main
Choose a base branch
from
Open

Conversation

eedugon
Copy link
Contributor

@eedugon eedugon commented Feb 19, 2025

This is the first PR as part of the effort to refine all ECE content, per https://github.com/elastic/docs-projects/issues/339

Changes:

  • Toc updated a bit: prepare your environment moved inside Deploy and Orchestrator.
  • New ECE overview doc added with the sub-docs Service-architecture and containers.
  • Deploy -> ECE landing page created
  • Deploy an orchestrator landing page created
  • Configure ECE landing page just merging source docs and kept as the original (this will need a refinement in a future PR).

Pages to review:

  • ECE landing page.

  • ECE overview (with childs, almost untouched). This is a new page, we could include all this content in the landing page but i think it won't be better.

  • Deploy an orchestrator

  • Configure ECE: I have only brought here the content from the mapped documents. This will need refinement, let's get some feedback about this but the focus on this content will be in the next PR.

Note that the links that appear in Additional topics are duplicated in the Deployan orgrestrator and the main landing page. I'd like to get feedback about if this is ok or if we shouldn' link to those external sections in both places (security, snapshots, license, maintenance, user and roles)

cc: @shainaraskas

Try one of the [getting started guides](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/getting-started-guides.html) to discover the core concepts of the Elastic Stack and understand how Elastic can help you.
::::

### What is ECE?
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this heading, along with "Why ECE," can be removed, and their content can simply be part of the introduction. For example:

ECE has evolved from Elastic's hosted Cloud SaaS offering into a standalone product. You can deploy ECE on public or private clouds, virtual machines, or on-premises.

With Elastic Cloud Enterprise, you can:

  • Host regulated or sensitive data on your internal network.
  • Reuse your existing investment in on-premises infrastructure and reduce costs.
  • Maximize hardware utilization across multiple clusters.
  • Centralize the management of Elastic deployments across teams and geographies.

(or something similar)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yeah, those sections don't look very natural. It was part of the original content. I'll review it, thanks!!

Copy link
Collaborator

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

:)

* [Deploy ECE](./cloud-enterprise/deploy-an-orchestrator.md)
Copy link
Collaborator

Choose a reason for hiding this comment

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

might want to specify that this is the orchestrator / installation - this always confused me in the original doc

Other sections of the documentation also include important tasks related to ECE:

* [Secure your ECE installation](../security/secure-your-elastic-cloud-enterprise-installation.md)
Copy link
Collaborator

Choose a reason for hiding this comment

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

technically, the rest of the security section might be relevant as well (e.g. securing settings, saved objects?)

could call out the ece section specifically though

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Secure your ECE installation was a page in the original content with a lot of security related topics for ECE as chid docs. I hope to have something similar in the security section there.

It's true that I expect that to be focused on the orchestrator security and not on deployments security.

I'll add a link to the "secure your deployments" area which was https://www.elastic.co/guide/en/cloud-enterprise/current/ece-securing-clusters.html in the original docs. Thanks!

What I wouldn't do linking in the main page of ECE to something as specific as kibana saved objects, but if you share other examples that I might be missing please share!

For secure settings I expect them to be part of the security content mentioned previously.


% Use migrated content from existing pages that map to this page:
% should we use a L2 heading here or just continue?
Copy link
Collaborator

Choose a reason for hiding this comment

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

I like the L2


% What needs to be done: Refine
{{ece}} (ECE) is an Elastic self-managed solution for deploying, orchestrating, and managing {{es}} clusters at scale. It provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines.
Copy link
Collaborator

Choose a reason for hiding this comment

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

this page is missing the key info from the ECE overview below (the "why ECE")

- https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html
---

# Elastic Cloud Enterprise overview [Elastic-Cloud-Enterprise-overview]
Copy link
Collaborator

Choose a reason for hiding this comment

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

IMO I'd just pull this up a level because there's not that much stuff

I'd also just merge the service-oriented arch page and the services as docker containers page because they are overlapping

Copy link
Collaborator

Choose a reason for hiding this comment

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

this can wait for later though for time reasons

shainaraskas
shainaraskas previously approved these changes Feb 20, 2025
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