Skip to content

Commit 513a428

Browse files
authored
Merge branch 'main' into self-managed
2 parents 25a613e + 64e2a2a commit 513a428

File tree

172 files changed

+716
-5324
lines changed

Some content is hidden

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

172 files changed

+716
-5324
lines changed
Lines changed: 5 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
navigation_title: Air gapped environments
2+
navigation_title: Air-gapped environments
33
applies_to:
44
deployment:
55
eck: all
@@ -8,51 +8,9 @@ mapped_urls:
88
- https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-air-gapped.html
99
---
1010

11-
# Air gapped install
12-
13-
% What needs to be done: Refine
14-
15-
% GitHub issue: https://github.com/elastic/docs-projects/issues/309
16-
17-
% Scope notes: Curate and merget the content to have a proper guide for air gapped installations. Similar to ECE activity
18-
19-
% Use migrated content from existing pages that map to this page:
20-
21-
% - [ ] ./raw-migrated-files/stack-docs/elastic-stack/air-gapped-install.md
22-
23-
% already removed
24-
% - [ ] ./raw-migrated-files/cloud-on-k8s/cloud-on-k8s/k8s-air-gapped.md
25-
26-
% Internal links rely on the following IDs being on this page (e.g. as a heading ID, paragraph ID, etc):
27-
28-
$$$air-gapped-install$$$
29-
30-
$$$k8s-container-registry-override$$$
31-
32-
$$$k8s-eck-diag-air-gapped$$$
33-
34-
% There are two concepts and areas to explore here:
35-
% ECK installation on air-gapped. This has no complexity as it's all a matter of docker registry and docker images.
36-
% Managing deployments on an ECK running on air-gapped is something not really covered in the official ECK book and partly covered in stack-docs
37-
38-
% In this doc we will focus on ECK operator installation in air gapped environments, and we will link to Manage Deployments -> Air gapped (doesn't exist yet) for the content and examples about the rest.
39-
40-
% from fleet air-gapped
41-
% Kibana is able to reach the Elastic Package Registry to download package metadata and content.
42-
% Elastic Agents are able to download binaries during upgrades from the Elastic Artifact Registry.
43-
44-
% what about Elasticsearch requirements for example for GeoIP database, etc?
45-
46-
Pending to determine what to do with this:
47-
* Syncing container images for ECK and all other {{stack}} components over to a locally-accessible container repository.
48-
* Modifying the ECK helm chart configuration so that ECK is aware that it is supposed to use your offline container repository instead of the public Elastic repository.
49-
* Optionally, disabling ECK telemetry collection in the ECK helm chart. This configuration propagates to all other Elastic components, such as {{kib}}.
50-
* Building your custom deployment container image for the {{artifact-registry}}.
51-
* Building your custom deployment container image for the Elastic Endpoint Artifact Repository.
52-
5311
# Running in air-gapped environments [k8s-air-gapped]
5412

55-
The ECK operator can be run in an air-gapped environment without access to the open internet when it is configured not to pull container images from `docker.elastic.co`.
13+
The ECK operator can be run in an air-gapped environment without access to the open internet when configured to avoid pulling container images from `docker.elastic.co`.
5614

5715
By default ECK does not require you to specify the container image for each Elastic Stack application you deploy.
5816

@@ -63,13 +21,13 @@ metadata:
6321
name: quickstart
6422
spec:
6523
version: 8.16.1
66-
# image: docker.elastic.co/elasticsearch/elasticsearch:8.16.1 <1>
24+
# image: docker.elastic.co/elasticsearch/elasticsearch:8.16.1 // <1>
6725
nodeSets:
6826
- name: default
6927
count: 1
7028
# podTemplate:
7129
# spec:
72-
# imagePullSecrets: <2>
30+
# imagePullSecrets: // <2>
7331
# - name: private-registry-credentials-secret
7432
```
7533

@@ -113,49 +71,4 @@ For example, if your private registry is `my.registry` and all Elastic images ar
11371

11472
The [eck-diagnostics tool](../../../troubleshoot/deployments/cloud-on-k8s/run-eck-diagnostics.md) optionally runs diagnostics for Elastic Stack applications in a separate container that is deployed into the Kubernetes cluster.
11573

116-
In air-gapped environments with no access to the `docker.elastic.co` registry, you should copy the latest support-diagnostics container image to your internal image registry and then run the tool with the additional flag `--diagnostic-image <custom-support-diagnostics-image-name>`. To find out which support diagnostics container image matches your version of eck-diagnostics run the tool once without arguments and it will print the default image in use.
117-
118-
119-
% FROM THE OTHER CONTENT (ELASTIC-STACK):
120-
121-
### 2. Kubernetes & OpenShift Install [air-gapped-kubernetes-and-openshift]
122-
123-
Setting up air-gapped Kubernetes or OpenShift installs of the {{stack}} has some unique concerns, but the general dependencies are the same as in the self-managed install case on a regular Linux machine.
124-
125-
126-
#### 2.1. Elastic Kubernetes Operator (ECK) [air-gapped-k8s-os-elastic-kubernetes-operator]
127-
128-
The Elastic Kubernetes operator is an additional component in the Kubernetes OpenShift install that, essentially, does a lot of the work in installing, configuring, and updating deployments of the {{stack}}. For details, refer to the [{{eck}} install instructions](../../../deploy-manage/deploy/cloud-on-k8s/air-gapped-install.md).
129-
130-
The main requirements are:
131-
132-
* Syncing container images for ECK and all other {{stack}} components over to a locally-accessible container repository.
133-
* Modifying the ECK helm chart configuration so that ECK is aware that it is supposed to use your offline container repository instead of the public Elastic repository.
134-
* Optionally, disabling ECK telemetry collection in the ECK helm chart. This configuration propagates to all other Elastic components, such as {{kib}}.
135-
* Building your custom deployment container image for the {{artifact-registry}}.
136-
* Building your custom deployment container image for the Elastic Endpoint Artifact Repository.
137-
138-
139-
#### 2.2. Elastic Package Registry [air-gapped-k8s-os-elastic-package-registry]
140-
141-
The container image can be downloaded from the official Elastic Docker repository, as described in the {{fleet}} and {{elastic-agent}} [air-gapped environments](asciidocalypse://docs/docs-content/docs/reference/ingestion-tools/fleet/air-gapped.md) documentation.
142-
143-
This container would, ideally, run as a Kubernetes deployment. Refer to [Appendix C - EPR Kubernetes Deployment](../../../deploy-manage/deploy/self-managed/air-gapped-install.md#air-gapped-epr-kubernetes-example) for examples.
144-
145-
146-
#### 2.3. {{artifact-registry}} [air-gapped-k8s-os-elastic-artifact-registry]
147-
148-
A custom container would need to be created following similar instructions to setting up a web server in the [self-managed install case](../../../deploy-manage/deploy/self-managed/air-gapped-install.md#air-gapped-elastic-artifact-registry). For example, a container file using an NGINX base image could be used to run a build similar to the example described in [Appendix B - {{artifact-registry}}](../../../deploy-manage/deploy/self-managed/air-gapped-install.md#air-gapped-elastic-artifact-registry-example).
149-
150-
151-
#### 2.4. Elastic Endpoint Artifact Repository [air-gapped-k8s-os-elastic-endpoint-artifact-repository]
152-
153-
Just like the {{artifact-registry}}. A custom container needs to be created following similar instructions to setting up a web server for the [self-managed install case](../../../deploy-manage/deploy/self-managed/air-gapped-install.md#air-gapped-elastic-artifact-registry).
154-
155-
156-
#### 2.5. Ironbank Secure Images for Elastic [air-gapped-k8s-os-ironbank-secure-images]
157-
158-
Besides the public [Elastic container repository](https://www.docker.elastic.co), most {{stack}} container images are also available in Platform One’s [Iron Bank](https://ironbank.dso.mil/repomap?vendorFilters=Elastic&page=1&sort=1).
159-
160-
161-
74+
In air-gapped environments with no access to the `docker.elastic.co` registry, you should copy the latest support-diagnostics container image to your internal image registry and then run the tool with the additional flag `--diagnostic-image <custom-support-diagnostics-image-name>`. To find out which support diagnostics container image matches your version of eck-diagnostics, run the tool once without arguments and it will print the default image in use.

deploy-manage/deploy/elastic-cloud/add-plugins-extensions.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-adding-plugins.html
4+
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-adding-elastic-plugins.html
5+
- https://www.elastic.co/guide/en/cloud/current/ec-adding-plugins.html
26
applies_to:
37
deployment:
48
ess: ga
5-
mapped_pages:
6-
- https://www.elastic.co/guide/en/cloud/current/ec-adding-plugins.html
7-
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-adding-elastic-plugins.html
89
---
910

1011
# Add plugins and extensions [ec-adding-plugins]

deploy-manage/monitor/autoops/ec-autoops-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ $$$faq-autoops-monitoring$$$Does AutoOps monitor the entire Elastic Stack?
2020
: AutoOps is currently limited to {{es}} (not {{kib}}, Logstash and Beats).
2121

2222
$$$faq-autoops-supported-versions$$$What versions of Elasticsearch are supported for Elastic Cloud Hosted?
23-
: AutoOps is currently available for {{es}} versions 7.17 and above.
23+
: AutoOps supports {es} versions according to the [supported Elastic Stack versions](https://www.elastic.co/support/eol).
2424

2525
$$$faq-autoops-license$$$How is AutoOps currently licensed?
2626
: AutoOps current feature set is available to Elastic Cloud Hosted customers at all subscription tiers. For more information please refer to the [subscription page](https://www.elastic.co/subscriptions/cloud).

deploy-manage/monitor/stack-monitoring/elastic-cloud-stack-monitoring.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,13 @@ $$$ech-logging-and-monitoring-production$$$
6060

6161
$$$ech-logging-and-monitoring-retention$$$
6262

63+
% Please leave the AutoOps banner in the final content of this page
64+
65+
:::{important}
66+
If you’re using Elastic Cloud Hosted, then you can use AutoOps to monitor your cluster. AutoOps significantly simplifies cluster management with performance recommendations, resource utilization visibility, real-time issue detection and resolution paths. For more information, refer to [Monitor with AutoOps](/deploy-manage/monitor/autoops.md).
67+
:::
68+
69+
6370
**This page is a work in progress.** The documentation team is working to combine content pulled from the following pages:
6471

6572
* [/raw-migrated-files/cloud/cloud-heroku/ech-monitoring.md](/raw-migrated-files/cloud/cloud-heroku/ech-monitoring.md)

deploy-manage/tools/snapshot-and-restore.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,11 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html
4+
- https://www.elastic.co/guide/en/cloud/current/ec-snapshot-restore.html
5+
- https://www.elastic.co/guide/en/cloud/current/ec-restoring-snapshots.html
6+
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-snapshot-restore.html
7+
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-restoring-snapshots.html
8+
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-snapshots.html
29
applies_to:
310
deployment:
411
eck:

deploy-manage/tools/snapshot-and-restore/access-isolation-for-found-snapshots-repository.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud/current/ec-snapshot-repository-migration.html
24
applies_to:
35
deployment:
46
ess:

deploy-manage/tools/snapshot-and-restore/azure-repository.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/elasticsearch/reference/current/repository-azure.html
24
applies_to:
35
deployment:
46
self:

deploy-manage/tools/snapshot-and-restore/azure-storage-repository.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-configure-azure-snapshotting.html
24
applies_to:
35
deployment:
46
ece:

deploy-manage/tools/snapshot-and-restore/cloud-enterprise.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-manage-repositories.html
24
navigation_title: "Elastic Cloud Enterprise"
3-
45
applies_to:
56
deployment:
67
ece:

deploy-manage/tools/snapshot-and-restore/cloud-on-k8s.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
2+
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-snapshots.html
24
navigation_title: "Elastic Cloud on Kubernetes"
3-
45
applies_to:
56
deployment:
67
eck:

0 commit comments

Comments
 (0)