Trialing a tabs approach for older versions

Author: yetanothertw

deploy-manage/deploy/self-managed/_snippets/tip-install-other-9-versions.md

@@ -0,0 +1,3 @@
+:::{tip}
+You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+:::

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

@@ -4,6 +4,19 @@ To use the Wolfi image, append `-wolfi` to the image tag in the Docker command.
 
 For example:
 
+::::{tab-set}
+
+:::{tab-item} Latest
 ```sh subs=true
 docker pull docker.elastic.co/elasticsearch/elasticsearch-wolfi:{{version.stack}}
-```
+```
+:::
+
+:::{tab-item} Specific version
+```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}}.
+:::
+
+::::

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

@@ -34,12 +34,26 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
 
 3. Pull the {{es}} Docker image.
 
+    ::::{tab-set}
+
+    :::{tab-item} Latest
     ```sh subs=true
     docker pull docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
+    :::
+
+    :::{tab-item} Specific version
+    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>
+    ```
+    :::
 
 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}
+
+    :::{tab-item} Latest
     $$$docker-verify-signature$$$
 
     ```sh subs=true
@@ -56,9 +70,35 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
       - Existence of the claims in the transparency log was verified offline
       - The signatures were verified against the specified public key
     ```
+    :::
+    
+    :::{tab-item} Specific version
+    Replace `<specific.version>` with the {{es}} version number you want. For example, you can replace `<specific.version>` with {{version.stack.base}}.
+    $$$docker-verify-signature$$$
+
+    ```sh subs=true
+    wget https://artifacts.elastic.co/cosign.pub
+    cosign verify --key cosign.pub docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
+    ```
+
+    The `cosign` command prints the check results and the signature payload in JSON format:
+
+    ```sh subs=true
+    Verification for docker.elastic.co/elasticsearch/elasticsearch:<specific.version> --
+    The following checks were performed on each of these signatures:
+      - The cosign claims were validated
+      - Existence of the claims in the transparency log was verified offline
+      - The signatures were verified against the specified public key
+    ```
+    :::
+    ::::
+
 
 5. Start an {{es}} container.
 
+    ::::::{tab-set}
+
+    :::::{tab-item} Latest
     ```sh subs=true
     docker run --name es01 --net elastic -p 9200:9200 -it -m 1GB docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
@@ -67,14 +107,34 @@ Use Docker commands to start a single-node {{es}} cluster for development or tes
     Use the `-m` flag to set a memory limit for the container. This removes the need to [manually set the JVM size](/deploy-manage/deploy/self-managed/install-elasticsearch-docker-prod.md#docker-set-heap-size).
     ::::
 
-
     {{ml-cap}} features such as [semantic search with ELSER](/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md) require a larger container with more than 1GB of memory. If you intend to use the {{ml}} capabilities, then start the container with this command:
 
     ```sh subs=true
     docker run --name es01 --net elastic -p 9200:9200 -it -m 6GB -e "xpack.ml.use_auto_machine_memory_percent=true" docker.elastic.co/elasticsearch/elasticsearch:{{version.stack}}
     ```
 
     The command prints the `elastic` user password and an enrollment token for {{kib}}.
+    :::::
+
+    :::::{tab-item} Specific version
+    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>
+    ```
+
+    ::::{tip}
+    Use the `-m` flag to set a memory limit for the container. This removes the need to [manually set the JVM size](/deploy-manage/deploy/self-managed/install-elasticsearch-docker-prod.md#docker-set-heap-size).
+    ::::
+
+    {{ml-cap}} features such as [semantic search with ELSER](/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md) require a larger container with more than 1GB of memory. If you intend to use the {{ml}} capabilities, then start the container with this command:
+
+    ```sh subs=true
+    docker run --name es01 --net elastic -p 9200:9200 -it -m 6GB -e "xpack.ml.use_auto_machine_memory_percent=true" docker.elastic.co/elasticsearch/elasticsearch:<specific.version>
+    ```
+
+    The command prints the `elastic` user password and an enrollment token for {{kib}}.
+    :::::
+    ::::::
 
 6. Copy the generated `elastic` password and enrollment token. These credentials are only shown when you start {{es}} for the first time. You can regenerate the credentials using the following commands.
 
@@ -113,9 +173,20 @@ 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}
+
+    :::{tab-item} 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
+    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>
+    ```
+    :::
+    ::::
 
 3. Call the [cat nodes API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-cat-nodes) to verify the node was added to the cluster.
 

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

@@ -56,8 +56,7 @@ cd elasticsearch-{{version.stack}}/ <2>
 1. Compares the SHA of the downloaded `.tar.gz` archive and the published checksum, which should output `elasticsearch-<version>-linux-x86_64.tar.gz: OK`.
 2. This directory is known as `$ES_HOME`.
 
-:::{tip}
-You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+:::{include} _snippets/tip-install-other-9-versions.md
 :::
 
 ### MacOS [install-macos]
@@ -88,8 +87,7 @@ xattr -d -r com.apple.quarantine <archive-or-directory>
 Alternatively, you can add a security override by following the instructions in the *If you want to open an app that hasn’t been notarized or is from an unidentified developer* section of [Safely open apps on your Mac](https://support.apple.com/en-us/HT202491).
 ::::
 
-:::{tip}
-You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+:::{include} _snippets/tip-install-other-9-versions.md
 :::
 
 ## Step 2: Enable automatic creation of system indices [targz-enable-indices]

deploy-manage/deploy/self-managed/install-elasticsearch-with-debian-package.md

@@ -110,8 +110,7 @@ sudo dpkg -i elasticsearch-{{version.stack}}-amd64.deb
 
 1. Compares the SHA of the downloaded Debian package and the published checksum, which should output `elasticsearch-<version>-amd64.deb: OK`.
 
-:::{tip}
-You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+:::{include} _snippets/tip-install-other-9-versions.md
 :::
 
 ## Step 3: Set up the node for connectivity

deploy-manage/deploy/self-managed/install-elasticsearch-with-rpm.md

@@ -97,8 +97,7 @@ sudo zypper modifyrepo --enable elasticsearch && \
     :::{include} _snippets/skip-set-kernel-params.md
     :::
 
-    :::{tip}
-    You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+    :::{include} _snippets/tip-install-other-9-versions.md
     :::
 
 2. Copy the terminal output from the install command to a local file. In particular, you’ll need the password for the built-in `elastic` superuser account. The output also contains the commands to enable {{es}} to [run as a service](#running-systemd).

deploy-manage/deploy/self-managed/install-elasticsearch-with-zip-on-windows.md

@@ -50,8 +50,7 @@ Unzip it with your favorite unzip tool. This will create a folder called `elasti
 cd C:\Program Files\elasticsearch-{{version.stack}}
 ```
 
-:::{tip}
-You can download and install another version of {{es}} {{version.stack.base | M }} by replacing {{version.stack}} with the version number you want. For example, you can replace {{version.stack}} with {{version.stack.base}}.
+:::{include} _snippets/tip-install-other-9-versions.md
 :::
 
 ## Step 2: Enable automatic creation of system indices [windows-enable-indices]