Skip to content

Commit bbce78c

Browse files
committed
Mention orchestration, cleanup, add comparison table subpage
1 parent 8248f2d commit bbce78c

File tree

3 files changed

+107
-40
lines changed

3 files changed

+107
-40
lines changed

deploy-manage/deploy.md

Lines changed: 49 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@ mapped_urls:
44
- https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro-deploy.html
55
---
66

7-
# Deploy
8-
97
% What needs to be done: Write from scratch
108

119
% GitHub issue: https://github.com/elastic/docs-projects/issues/334
@@ -17,79 +15,90 @@ mapped_urls:
1715
% - [ ] ./raw-migrated-files/docs-content/serverless/intro.md
1816
% - [ ] ./raw-migrated-files/elasticsearch/elasticsearch-reference/elasticsearch-intro-deploy.md
1917

18+
# Deploy
19+
2020
Whether you're planning to use Elastic's pre-built solutions or Serverless projects, build your own applications with {{es}}, or analyze your data using {{kib}} tools, you'll need to deploy Elastic first.
2121

2222
This page will help you understand your deployment options and choose the approach that best fits your needs.
2323

2424
## Core components
2525

26-
Every Elastic deployment requires Elasticsearch as its core data store and search/analytics engine.
27-
Additionally, Kibana provides the user interface for all Elastic solutions and Serverless projects. It is required for most use cases, from data exploration to monitoring and security analysis.
26+
Every Elastic deployment requires {{es}} as its core data store and search/analytics engine.
27+
Additionally, {{kib}} provides the user interface for all Elastic solutions and Serverless projects. It is required for most use cases, from data exploration to monitoring and security analysis.
2828

2929
Your choice of deployment type determines how you'll set up and manage these core components, plus any additional components you need.
3030

31-
Elastic offers deployment options ranging from fully automated to fully self-managed.
32-
3331
:::{tip}
3432
Learn more about the [{{stack}}](/get-started/the-stack.md) to understand the core and optional components of an Elastic deployment.
35-
:::
33+
:::
3634

37-
## Deployment types overview
35+
## Choosing your deployment type
3836

3937
:::{include} _snippets/deployment-options-overview.md
4038
:::
4139

42-
## Versioning and compatability
43-
44-
In {{serverless-full}}, you automatically get access to the latest versions of Elastic features and you don't need to manage version compatibility.
45-
46-
All other deployment types use stack versioning, where components are tested and versioned together to ensure compatibility. ECE and ECK have their own deployment versions, in addition to stack versioning.
40+
### Who manages the infrastructure?
4741

48-
Consider this when choosing your deployment type:
42+
#### Managed by Elastic
4943

50-
- Choose Serverless if you want automatic access to the latest features and don't want to manage version compatibility
51-
- Choose other deployment types if you need more control over version management
44+
If you want to focus on using Elastic products rather than managing infrastructure, choose:
5245

53-
:::{tip}
54-
Learn more about [versioning and availability](/get-started/versioning-availability.md).
55-
:::
46+
- **Serverless**: Zero operational overhead, automatic scaling and updates, latest features
47+
- **Cloud hosted**: Balance of control and managed operations, choice of resources and regions
5648

57-
## Choose your deployment path
49+
#### Self-managed options
5850

59-
Your deployment choice determines how you'll set up and manage these components.
51+
If you need to run Elastic on your infrastructure, choose between a fully self-managed deployment or using an orchestrator:
6052

61-
### Step 1: Who manages the infrastructure?
53+
- **Fully self-managed**: Complete control and responsibility for your Elastic deployment
54+
- **With orchestration**:
55+
- **Elastic Cloud on Kubernetes (ECK)**: If you need Kubernetes-native orchestration
56+
- **Elastic Cloud Enterprise (ECE)**: If you need a multi-tenant orchestration platform
6257

63-
#### Managed by Elastic
58+
:::::{note}
59+
:::{dropdown} About orchestration
6460

65-
If you want to focus on using Elastic products rather than managing infrastructure, choose:
61+
An orchestrator automates the deployment and management of multiple Elastic clusters, handling tasks like scaling, upgrades, and monitoring.
6662

67-
- **Serverless**: Zero operational overhead, automatic scaling and updates, latest features
68-
- **Cloud hosted**: Balance of control and managed operations, choice of resources and regions
63+
Consider orchestration if you:
64+
- Need to manage multiple Elastic clusters
65+
- Want automated operations at scale
66+
- Have a Kubernetes environment (ECK)
67+
- Need to build a multi-tenant platform (ECE)
6968

70-
#### Self-managed with your infrastructure
69+
Orchestrators manage the lifecycle of your Elastic deployments but don't change how the core products work. When using ECK or ECE:
70+
- You'll still use the same Elasticsearch and Kibana features and configurations
71+
- Most product documentation remains applicable
72+
- You can add other Elastic products as needed
73+
- The orchestrator handles operational tasks while you focus on using and configuring the products
7174

72-
If you need to run Elastic on your infrastructure, you have three options:
75+
::::{tip}
76+
Documentation will specify when certain features or configurations are not applicable to specific deployment types.
77+
::::
78+
:::
79+
:::::
7380

74-
- **Basic self-managed**: Direct control over all aspects of deployment
75-
- **Elastic Cloud on Kubernetes (ECK)**: Kubernetes-native orchestration
76-
- **Elastic Cloud Enterprise (ECE)**: Multi-tenant orchestration platform
81+
### Versioning and compatibility
7782

78-
### Step 2: For self-managed - do you need orchestration?
83+
In {{serverless-full}}, you automatically get access to the latest versions of Elastic features and you don't need to manage version compatibility.
7984

80-
If you chose self-managed, consider whether you need orchestration:
85+
With other deployment types ({{ecloud}} Hosted, ECE, and ECK), you control which {{stack}} versions you deploy and when you upgrade. The ECE and ECK orchestrators themselves also receive regular version updates, independent of the {{stack}} versions they manage.
8186

82-
- **No orchestration needed**:
83-
Choose basic self-managed deployment for full control and direct management
87+
Consider this when choosing your deployment type:
8488

85-
- **Kubernetes environment**:
86-
Use ECK for native Kubernetes orchestration and automated operations
89+
- Choose Serverless if you want automatic access to the latest features and don't want to manage version compatibility
90+
- Choose other deployment types if you need more control over version management
8791

88-
- **Multi-tenant platform**:
89-
Use ECE to deploy {{ecloud}} on your own infrastructure
92+
:::{tip}
93+
Learn more about [versioning and availability](/get-started/versioning-availability.md).
94+
:::
9095

91-
## Cost considerations
96+
### Cost considerations
9297

9398
- **Serverless**: Pay for what you use
9499
- **Cloud hosted**: Subscription-based with resource allocation
95100
- **Self-managed options**: Infrastructure costs plus operational overhead mean a higher total cost of ownership (TCO)
101+
102+
:::::{tip}
103+
For a detailed comparison of features and capabilities across deployment types, see the [Deployment comparison reference](./deploy/deployment-comparison.md).
104+
:::::
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
2+
# Deployment comparison reference
3+
4+
This reference provides detailed comparisons of features and capabilities across Elastic's deployment options: self-managed deployments, Elastic Cloud Hosted, and Serverless. For a high-level overview of deployment types and guidance on choosing between them, see the [overview](../deploy.md).
5+
6+
## Security features
7+
8+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
9+
|-------------------|-------------|--------------------------------|-------------------------|
10+
| Custom security configurations | Yes | Limited | No |
11+
| Authentication realms and custom roles | Yes | Yes | No |
12+
| Audit logging | Yes | Yes | No |
13+
14+
## Management features
15+
16+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
17+
|-------------------|-------------|--------------------------------|-------------------------|
18+
| Full control over configuration | Yes | Limited | No |
19+
| Infrastructure flexibility | Yes | No | No |
20+
| Autoscaling | No | Yes | Yes |
21+
| Data tiers management | No | Yes | No |
22+
| Snapshot management | No | Yes | No |
23+
| High availability and disaster recovery | Yes | Yes | Yes |
24+
| Multi-cloud support | No | Yes | Yes |
25+
| Shard management and replicas | Yes | Yes | No |
26+
27+
## Monitoring features
28+
29+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
30+
|-------------------|-------------|--------------------------------|-------------------------|
31+
| Watcher | Yes | Yes | No |
32+
33+
## Data lifecycle features
34+
35+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
36+
|-------------------|-------------|--------------------------------|-------------------------|
37+
| Index lifecycle management (ILM) | Yes | Yes | No (uses data streams) |
38+
| Data tiers management | No | Yes | No |
39+
| Snapshot management | No | Yes | No |
40+
41+
## Integration features
42+
43+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
44+
|-------------------|-------------|--------------------------------|-------------------------|
45+
| Custom plugins | Yes | No | No |
46+
| Self-managed connectors | Yes | No | Limited |
47+
| Elasticsearch-Hadoop integration | Yes | Yes | No |
48+
| Cross cluster search (CCS) | Yes | Yes | No |
49+
| Cross cluster replication | Yes | Yes | Yes |
50+
51+
## Development and testing features
52+
53+
| Feature/capability | Self-managed | Elastic Cloud Hosted | Serverless |
54+
|-------------------|-------------|--------------------------------|-------------------------|
55+
| Advanced testing and development | Yes | No | No |
56+
| Java (JVM) customization | Yes | No | No |
57+

deploy-manage/toc.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ toc:
2424
- file: distributed-architecture/kibana-tasks-management.md
2525
- file: deploy.md
2626
children:
27+
- file: deploy/deployment-comparison.md
2728
- file: deploy/elastic-cloud.md
2829
children:
2930
- file: deploy/elastic-cloud/create-an-organization.md

0 commit comments

Comments
 (0)