Skip to content

Commit 768ea7f

Browse files
authored
Merge branch 'main' into bulk-import-streams
2 parents 38d1817 + 8e0cb46 commit 768ea7f

File tree

69 files changed

+892
-491
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

69 files changed

+892
-491
lines changed

.github/CODEOWNERS

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,20 @@
99
# The docs
1010
/cloud-account/ @elastic/admin-docs
1111
/deploy-manage/ @elastic/admin-docs
12+
1213
/explore-analyze/ @elastic/core-docs @elastic/experience-docs
14+
/explore-analyze/alerts-cases/ @elastic/experience-docs
15+
/explore-analyze/dashboards/ @elastic/experience-docs
16+
/explore-analyze/discover/ @elastic/experience-docs
17+
/explore-analyze/elastic-inference/ @elastic/developer-docs @elastic/experience-docs
18+
/explore-analyze/find-and-organize/ @elastic/experience-docs
19+
/explore-analyze/machine-learning/ @elastic/developer-docs @elastic/experience-docs
20+
/explore-analyze/query-filter/ @elastic/developer-docs @elastic/experience-docs
21+
/explore-analyze/report-and-share/ @elastic/experience-docs
22+
/explore-analyze/scripting/ @elastic/admin-docs
23+
/explore-analyze/transforms/ @elastic/developer-docs
24+
/explore-analyze/visualize/ @elastic/experience-docs
25+
1326
/extend/ @elastic/core-docs
1427
/get-started/ @elastic/core-docs @elastic/project-docs
1528

@@ -64,7 +77,7 @@
6477
/troubleshoot/security/ @elastic/ski-docs
6578

6679
# Raw migrated files
67-
/raw-migrated-files/ @elastic/docs
80+
/raw-migrated-files/ @elastic/admin-docs
6881

6982
# Legacy serverless docs
7083
/serverless/ @elastic/admin-docs

deploy-manage/deploy/cloud-enterprise/change-endpoint-urls.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ https://<CLUSTER_ID.LOCAL_HOST_IP>.ip.es.io:9243
2020
```
2121

2222
::::{important}
23-
If your application does not support HTTPS, you can connect to the HTTP endpoint on port 9200. However, for security reasons, it is recommended to use **HTTPS (9243)** whenever possible.
23+
For security reasons, it is recommended to use **HTTPS (9243)** whenever possible.
2424
::::
2525

2626
To change endpoints in the Cloud UI:
@@ -43,3 +43,7 @@ If you have an App Search instance, after specifying a new deployment domain nam
4343
::::{note}
4444
The built-in Proxy Certificate only validates against the default endpoint format described on this page. Once you change it, it is necessary to upload a new Proxy Certificate as described in [Manage security certificates](/deploy-manage/security/secure-your-elastic-cloud-enterprise-installation/manage-security-certificates.md). For test only, clients can be configured with hostname verification disabled until the new certificate is uploaded.
4545
::::
46+
47+
::::{note}
48+
If you do not use wildcard certificates, you must configure SAN entries for each component of the deployment (for example, {{es}} or {{kib}}) and repeat this process for every deployment. Review [Wildcard DNS record and certificates](./ece-wildcard-dns.md) for more guidance.
49+
::::

deploy-manage/deploy/cloud-enterprise/ece-wildcard-dns.md

Lines changed: 24 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,39 @@ products:
88
- id: cloud-enterprise
99
---
1010

11-
# Wildcard DNS record [ece-wildcard-dns]
11+
# Wildcard DNS record and certificates [ece-wildcard-dns]
1212

1313
::::{warning}
1414
Don't use `ip.es.io` for production systems. Set up your own domain name and DNS resolver for production. We do not guarantee uptime with `ip.es.io`.
1515

1616
`ip.es.io` is intended for use only by {{ece}} customers. We may, acting in our sole discretion, immediately terminate, suspend, or block any unauthorized users or uses without notice.
1717
::::
1818

19-
By default, {{ece}} uses the external `ip.es.io` service provided by Elastic to resolve virtual {{es}} cluster host names in compliance with RFC1918. The service works by resolving host names of the form `<ip>.ip.es.io` to `<ip>`. In the case of {{ece}}, each cluster is assigned a virtual host name of the form `<cluster id>.<proxy ip address>.ip.es.io:<port>`, such as `6dfc65aae62341e18a8b7692dcc97186.10.8.156.132.ip.es.io:9243`. The `ip.es.io` service simply resolves the virtual host name of the cluster to the proxy address which is specified during installation, `10.8.156.132` in our example, so that client requests are sent to the proxy. The proxy then extracts the cluster ID from the virtual host name of the cluster and uses its internal routing table to route the request to the right allocator.
19+
By default, {{ece}} uses the external `ip.es.io` service provided by Elastic to resolve virtual {{es}} cluster host names in compliance with RFC1918. The service works by resolving host names of the form `<ip>.ip.es.io` to `<ip>`. In the case of {{ece}}, each cluster is assigned a virtual host name of the form `<cluster id>.<proxy ip address>.ip.es.io:<port>`, such as `6dfc65aae62341e18a8b7692dcc97186.10.8.156.132.ip.es.io:9243`.
20+
21+
The `ip.es.io` service simply resolves the virtual host name of the cluster to the proxy address which is specified during installation, `10.8.156.132` in our example, so that client requests are sent to the proxy. The proxy then extracts the cluster ID from the virtual host name of the cluster and uses its internal routing table to route the request to the right allocator.
22+
23+
## Considerations for production
2024

2125
The `ip.es.io` service is provided to help you evaluate {{ece}} without having to set up DNS records for your environment. You must set up a wildcard DNS record for your production system. You typically set up a wildcard DNS record that resolves to the proxy host or to a load balancer if you set up multiple proxies fronted by a load balancer. You can create both a wildcard DNS entry for your endpoints and a wildcard TLS/SSL certificate, so that you can create multiple clusters without the need for further DNS or TSL/SSL modifications. Simply configure your DNS to point to your load balancers and install your certificates on them, so that communication with the cluster is secure.
2226

23-
A wildcard certificate is enabled based on the deployment domain name. For more information on modifying the deployment domain name, check [Configure endpoints](change-endpoint-urls.md). The deployment domain name also determines the endpoint URLs that are displayed in the Cloud UI.
27+
## Configuring wildcard DNS certificates
28+
29+
{{ece}} highly recommends using a wildcard DNS certificate, typically configured as a subdomain (for example, `*.ece.mycompany.com`), to automatically secure the unique endpoints generated for each deployment (for example, `[cluster-id].ece.mycompany.com`). For details on modifying the deployment domain name, see [Change endpoint URLs](change-endpoint-urls.md). The deployment domain name also determines the endpoint URLs displayed in the Cloud UI.
30+
31+
Additionally, if you use custom endpoint aliases, you must configure a wildcard DNS certificate for each application-specific subdomain, such as `*.es.mycompany.com` for {{es}} or `*.kb.mycompany.com` for {{kib}}. Refer to [Enable custom endpoint aliases](./enable-custom-endpoint-aliases.md) for more information. Platform administrators must enable this feature to allow deployment managers to create and modify aliases for their deployments.
32+
33+
34+
### Wildcard DNS certificate vs static SAN certificates
35+
36+
In {{ece}}, each deployment generates multiple DNS entries, as every component within a deployment has its own cluster ID and fully qualified domain name (FQDN), and may also have an [alias](./enable-custom-endpoint-aliases.md). In environments with many deployments, especially when aliases are used, this can result in hundreds of unique FQDNs that must be covered by the certificate.
37+
38+
For this reason, using a wildcard DNS certificate for a subdomain, such as `*.ece.mycompany.com`, is recommended over a certificate with static SAN entries, as it offers a more scalable, efficient, and operationally safe solution:
39+
40+
* **Operational cost:** Because deployment FQDNs cannot be predicted in advance, a wildcard certificate provides optimal flexibility, allowing the proxy to present a valid certificate for any deployment URL. In contrast, a certificate with static SAN entries must be reissued whenever a new deployment is created, which increases the operational overhead.
41+
42+
* **Security:** We suggest configuring your wildcard DNS certificate for a subdomain, such as `*.ece.mycompany.com`. Doing so significantly reduces security risks associated with certificate misconfigurations. In contrast, if a certificate with static SAN entries does not include the new deployment’s cluster IDs, clients will encounter certificate name mismatch warnings, indicating a security misconfiguration.
43+
44+
* **Performance:** Wildcard certificates are generally more performant than certificates with a large number of SAN entries. They are smaller, which reduces TLS handshake time, and scale automatically with new deployments. In contrast, certificates with a large number of SAN entries can increase handshake latency and may affect client compatibility.
2445

25-
Report security issues to [email protected].
2646

deploy-manage/deploy/cloud-enterprise/enable-custom-endpoint-aliases.md

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,21 +23,18 @@ After installing or upgrading to version 2.10 or later:
2323
2. [Update your proxy certificate(s)](../../security/secure-your-elastic-cloud-enterprise-installation/manage-security-certificates.md). In addition to currently configured domains, additional SAN entries must be configured for each application-specific subdomain:
2424

2525
::::{note}
26-
If you are not using wildcard certificates, you need to repeat this process for each deployment to account for specific aliases.
26+
If you are not using wildcard certificates, you need to repeat this process for each deployment to account for specific aliases. Review [Wildcard DNS record and certificates](./ece-wildcard-dns.md) for more guidance.
2727
::::
28-
28+
2929

3030
* For {{es}}, the certificate needs to allow for **\*.es.<your-domain>**
3131
* For {{kib}}, the certificate needs to allow for **\*.kb.<your-domain>**
3232
* For APM, the certificate needs to allow for **\*.apm.<your-domain>**
3333
* For Fleet, the certificate needs to allow for **\*.fleet.<your-domain>**
3434
* For Universal Profiling, the certificate needs to allow for **\*.profiling.<your-domain>** and **\*.symbols.<your-domain>**
3535

36+
3637
3. In the **Platform** menu, select **Settings**.
3738
4. Under the **Enable custom endpoint alias naming**, toggle the setting to allow platform administrators and deployment managers to choose a simplified, unique URL for the endpoint.
3839

39-
If you do not perform these steps, application endpoints will behave as they did in versions before 2.10.
40-
41-
To learn about setting up custom endpoint aliases for your deployments, check [Custom endpoint aliases](ece-regional-deployment-aliases.md).
42-
4340

deploy-manage/deploy/elastic-cloud/elastic-cloud-hosted-planning.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ We recommend that you use at least two availability zones for production and thr
2828
Increasing the number of zones should not be used to add more resources. The concept of zones is meant for High Availability (2 zones) and Fault Tolerance (3 zones), but neither will work if the cluster relies on the resources from those zones to be operational.
2929
:::
3030

31-
With multiple {{es}} nodes in multiple availability zones you have the recommended hardware. The next step is to ensure proper index replication. Each index, with the exception of searchable snapshot indices, should have one or more replicas. Use the [index settings API](https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-indices-get-settings-1) to find any indices without replicas:
31+
With multiple {{es}} nodes in multiple availability zones you have the recommended hardware. The next step is to ensure proper index replication. Each index, with the exception of searchable snapshot indices, should have one or more replicas. Use the [index settings API]({{es-apis}}operation/operation-indices-get-settings) to find any indices without replicas:
3232

3333
```sh
3434
GET _all/_settings/index.number_of_replicas
-54 KB
Loading
202 KB
Loading
190 KB
Loading
249 KB
Loading
334 KB
Loading

0 commit comments

Comments
 (0)