Adds Kibana topics + tab grouping & sync

Author: yetanothertw

deploy-manage/deploy/self-managed/_snippets/wolfi.md

@@ -5,18 +5,20 @@ To use the Wolfi image, append `-wolfi` to the image tag in the Docker command.
 For example:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker pull docker.elastic.co/elasticsearch/elasticsearch-wolfi:{{version.stack}}
 ```
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 ```sh subs=true
 docker pull docker.elastic.co/elasticsearch/elasticsearch-wolfi:<specific.version>
 ```
-You can download and install a specific version of {{es}} {{version.stack.base | M }} by replacing `<specific.version>` with the version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
+You can download and install a specific version of the {{version.stack.base | M }} stack by replacing `<specific.version>` with the version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 :::
 
 ::::

deploy-manage/deploy/self-managed/install-elasticsearch-docker-basic.md

@@ -35,14 +35,16 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 3. Pull the {{es}} Docker image.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     docker pull docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
     :::
 
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```sh subs=true
     docker pull docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
@@ -52,8 +54,9 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 4. Optional: Install [Cosign](https://docs.sigstore.dev/cosign/system_config/installation/) for your environment. Then use Cosign to verify the {{es}} image’s signature.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     $$$docker-verify-signature$$$
 
     ```sh subs=true
@@ -73,6 +76,7 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
     :::
 
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     $$$docker-verify-signature$$$
 
@@ -97,8 +101,9 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 5. Start an {{es}} container.
 
     ::::::{tab-set}
-
+    :group: docker
     :::::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     docker run --name es01 --net elastic -p 9200:9200 -it -m 1GB docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
@@ -117,6 +122,7 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
     :::::
 
     :::::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```sh subs=true
     docker run --name es01 --net elastic -p 9200:9200 -it -m 1GB docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
@@ -174,13 +180,15 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 2. Start a new {{es}} container. Include the enrollment token as an environment variable.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     docker run -e ENROLLMENT_TOKEN="<token>" --name es02 --net elastic -it -m 1GB docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
     :::
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```sh subs=true
     docker run -e ENROLLMENT_TOKEN="<token>" --name es02 --net elastic -it -m 1GB docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
@@ -199,13 +207,15 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 1. Pull the {{kib}} Docker image.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     docker pull docker.elastic.co/kibana/kibana:{{version.stack}}
     ```
     :::
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{kib}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```sh subs=true
     docker pull docker.elastic.co/kibana/kibana:<specific.version>
@@ -216,14 +226,16 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 2. Optional: Verify the {{kib}} image’s signature.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     wget https://artifacts.elastic.co/cosign.pub
     cosign verify --key cosign.pub docker.elastic.co/kibana/kibana:{{version.stack}}
     ```
     :::
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{kib}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```sh subs=true
     wget https://artifacts.elastic.co/cosign.pub
@@ -236,13 +248,15 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 3. Start a {{kib}} container.
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     ```sh subs=true
     docker run --name kib01 --net elastic -p 5601:5601 docker.elastic.co/kibana/kibana:{{version.stack}}
     ```
     :::
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{kib}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
      ```sh subs=true
     docker run --name kib01 --net elastic -p 5601:5601 docker.elastic.co/kibana/kibana:<specific.version>

deploy-manage/deploy/self-managed/install-elasticsearch-docker-compose.md

@@ -42,8 +42,9 @@ Use Docker Compose to start a three-node {{es}} cluster with {{kib}}. Docker Com
 5. Edit the `.env` file to set the `STACK_VERSION`:
 
     ::::{tab-set}
-
+    :group: docker
     :::{tab-item} Latest
+    :sync: latest
     Set the stack version to the current {{es}} {{version.stack}} version. 
     ```txt subs=true
     ...
@@ -54,6 +55,7 @@ Use Docker Compose to start a three-node {{es}} cluster with {{kib}}. Docker Com
     :::
 
     :::{tab-item} Specific version
+    :sync: specific
     Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
     ```txt subs=true
     ...

deploy-manage/deploy/self-managed/install-elasticsearch-docker-configure.md

@@ -64,8 +64,9 @@ To encrypt your secure settings with a password and have them persist outside th
 For example:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker run -it --rm \
 -v full_path_to/config:/usr/share/elasticsearch/config \
@@ -75,6 +76,7 @@ bin/elasticsearch-keystore create -p
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 docker run -it --rm \
@@ -88,8 +90,9 @@ bin/elasticsearch-keystore create -p
 You can also use a `docker run` command to add or update secure settings in the keystore. You’ll be prompted to enter the setting values. If the keystore is encrypted, you’ll also be prompted to enter the keystore password.
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker run -it --rm \
 -v full_path_to/config:/usr/share/elasticsearch/config \
@@ -101,6 +104,7 @@ my.other.secure.setting
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 docker run -it --rm \
@@ -126,15 +130,17 @@ If you’ve already created the keystore and don’t need to update it, you can
 In some environments, it might make more sense to prepare a custom image that contains your configuration. A `Dockerfile` to achieve this might be as simple as:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 FROM docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
 COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/
 ```
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 FROM docker.elastic.co/elasticsearch/elasticsearch:<specific.version>

deploy-manage/deploy/self-managed/install-elasticsearch-docker-prod.md

@@ -132,14 +132,16 @@ Increased ulimits for [nofile](setting-system-settings.md) and [nproc](/deploy-m
 To check the Docker daemon defaults for ulimits, run:
 
 ::::{tab-set}
-
-    :::{tab-item} Latest
+:group: docker
+:::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker run --rm docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}} /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'
 ```
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 docker run --rm docker.elastic.co/elasticsearch/elasticsearch:<specific.version> /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'
@@ -179,14 +181,16 @@ To manually set the heap size in production, bind mount a [JVM options](elastics
 For testing, you can also manually set the heap size using the `ES_JAVA_OPTS` environment variable. For example, to use 1GB, use the following command.
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker run -e ES_JAVA_OPTS="-Xms1g -Xmx1g" -e ENROLLMENT_TOKEN="<token>" --name es01 -p 9200:9200 --net elastic -it docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
 ```
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 docker run -e ES_JAVA_OPTS="-Xms1g -Xmx1g" -e ENROLLMENT_TOKEN="<token>" --name es01 -p 9200:9200 --net elastic -it docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
@@ -202,14 +206,16 @@ The `ES_JAVA_OPTS` variable overrides all other JVM options. We do not recommend
 Pin your deployments to a specific version of the {{es}} Docker image. For example:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 ```sh subs=true
 docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
 ```
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 docker.elastic.co/elasticsearch/elasticsearch:<specific.version>

deploy-manage/deploy/self-managed/install-elasticsearch-from-archive-on-linux-macos.md

@@ -46,8 +46,9 @@ Download and install the archive for Linux or MacOS.
 The Linux archive for {{es}} can be downloaded and installed as follows:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 To download and install the {{es}} {{version.stack}} archive, enter:
 ```sh subs=true
 wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{{version.stack}}-linux-x86_64.tar.gz
@@ -61,6 +62,7 @@ cd elasticsearch-{{version.stack}}/ <2>
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<specific.version>-linux-x86_64.tar.gz
@@ -80,8 +82,9 @@ cd elasticsearch-<specific.version>/ <2>
 The MacOS archive for {{es}} can be downloaded and installed as follows:
 
 ::::{tab-set}
-
+:group: docker
 :::{tab-item} Latest
+:sync: latest
 To download and install the {{es}} {{version.stack}} archive, enter:
 ```sh subs=true
 curl -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{{version.stack}}-darwin-x86_64.tar.gz
@@ -94,6 +97,7 @@ cd elasticsearch-{{version.stack}}/ <2>
 :::
 
 :::{tab-item} Specific version
+:sync: specific
 Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
 ```sh subs=true
 curl -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<specific.version>-darwin-x86_64.tar.gz

deploy-manage/deploy/self-managed/install-kibana-from-archive-on-linux-macos.md

@@ -29,6 +29,11 @@ macOS is supported for development purposes only and is not covered under the su
 
 The Linux archive for {{kib}} {{version.stack}} can be downloaded and installed as follows:
 
+::::{tab-set}
+:group: docker-kib
+:::{tab-item} Latest
+:sync: latest
+To download and install the {{kib}} {{version.stack}} archive, enter:
 ```sh subs=true
 curl -O https://artifacts.elastic.co/downloads/kibana/kibana-{{version.stack}}-linux-x86_64.tar.gz
 curl https://artifacts.elastic.co/downloads/kibana/kibana-{{version.stack}}-linux-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
@@ -38,11 +43,32 @@ cd kibana-{{version.stack}}/ <2>
 
 1. Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output `kibana-<version>-linux-x86_64.tar.gz: OK`.
 2. This directory is known as `$KIBANA_HOME`.
+:::
+
+:::{tab-item} Specific version
+:sync: specific
+Replace `<specific.version>` with the {{kib}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
+```sh subs=true
+curl -O https://artifacts.elastic.co/downloads/kibana/kibana-<specific.version>-linux-x86_64.tar.gz
+curl https://artifacts.elastic.co/downloads/kibana/kibana-<specific.version>-linux-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
+tar -xzf kibana-<specific.version>-linux-x86_64.tar.gz
+cd kibana-<specific.version>/ <2>
+```
+
+1. Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output `kibana-<specific.version>-linux-x86_64.tar.gz: OK`.
+2. This directory is known as `$KIBANA_HOME`.
+:::
+::::
 
 ### MacOS [install-darwin64]
 
 The Darwin archive for {{kib}} {{version.stack}} can be downloaded and installed as follows:
 
+::::{tab-set}
+:group: docker-kib
+:::{tab-item} Latest
+:sync: latest
+To download and install the {{kib}} {{version.stack}} archive, enter:
 ```sh subs=true
 curl -O https://artifacts.elastic.co/downloads/kibana/kibana-{{version.stack}}-darwin-x86_64.tar.gz
 curl https://artifacts.elastic.co/downloads/kibana/kibana-{{version.stack}}-darwin-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
@@ -52,7 +78,22 @@ cd kibana-{{version.stack}}/ <2>
 
 1. Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output `kibana-<version>-darwin-x86_64.tar.gz: OK`.
 2. This directory is known as `$KIBANA_HOME`.
+:::
+
+:::{tab-item} Specific version
+:sync: specific
+Replace `<specific.version>` with the {{kib}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
+```sh subs=true
+curl -O https://artifacts.elastic.co/downloads/kibana/kibana-<specific.version>-darwin-x86_64.tar.gz
+curl https://artifacts.elastic.co/downloads/kibana/kibana-<specific.version>-darwin-x86_64.tar.gz.sha512 | shasum -a 512 -c - <1>
+tar -xzf kibana-<specific.version>-darwin-x86_64.tar.gz
+cd kibana-<specific.version>/ <2>
+```
 
+1. Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output `kibana-<specific.version>-darwin-x86_64.tar.gz: OK`.
+2. This directory is known as `$KIBANA_HOME`.
+:::
+::::
 
 ::::{admonition} macOS Gatekeeper warnings
 :class: important