@redpanda-data/docs-extensions-and-macros 4.4.2 → 4.5.0

package/cli-utils/convert-doc-links.js

@@ -0,0 +1,58 @@
+const { URL } = require('url');
+
+/**
+ * Converts a docs.redpanda.com URL, optionally suffixed with a label in brackets, into an Antora xref resource ID string.
+ *
+ * If the input includes a label in square brackets (e.g., `[Label]`), the label is preserved and appended to the resulting xref.
+ *
+ * @param {string} input - A docs.redpanda.com URL, optionally followed by a label in square brackets.
+ * @returns {string} The corresponding Antora xref resource ID, with the label preserved if present.
+ *
+ * @throws {Error} If the input is not a valid URL or does not belong to docs.redpanda.com.
+ */
+function urlToXref(input) {
+  // Peel off an optional “[label]”
+  let urlPart  = input;
+  let label    = '';
+  const mLabel = input.match(/^(.*)\[([^\]]+)\]$/);
+  if (mLabel) {
+    urlPart = mLabel[1];
+    label   = mLabel[2];
+  }
+
+  //Parse & validate
+  let url;
+  try {
+    url = new URL(urlPart);
+  } catch {
+    throw new Error(`Invalid URL: ${input}`);
+  }
+  if (!/docs\.redpanda\.com$/.test(url.hostname)) {
+    throw new Error(`Not a docs.redpanda.com URL: ${input}`);
+  }
+
+  // Strip any leading “/docs”, “/docs/vX.Y”, “/docs/current”, “/vX.Y” or “/current”
+  let p = url.pathname.replace(
+    /^\/(?:docs(?:\/(?:v?\d+\.\d+|current))?|v?\d+\.\d+|current)\/?/,
+    ''
+  );
+  // Drop trailing slash
+  p = p.replace(/\/$/, '');
+  const segments = p.split('/').filter(Boolean);
+
+  // Build module + path + .adoc
+  let xref;
+  if (segments.length === 0) {
+    xref = 'xref:index.adoc';
+  } else {
+    const moduleName = segments.shift();
+    const pagePath   = segments.join('/');
+    const fileName   = (pagePath || moduleName) + '.adoc';
+    xref = `xref:${moduleName}:${fileName}`;
+  }
+
+  // Re-attach label if there was one
+  return label ? `${xref}[${label}]` : xref;
+}
+
+module.exports = { urlToXref };

package/cli-utils/generate-cluster-docs.sh

@@ -73,7 +73,7 @@ else
     "$TAG"
 fi
 
-echo "✅ Redpanda cluster docs generated successfully!"
+echo "✅ $MODE docs generated successfully!"
 
 # Tear down the cluster
 cd "$SCRIPT_DIR"/../docker-compose

package/cli-utils/self-managed-docs-branch.js

@@ -0,0 +1,90 @@
+const https = require('https');
+const yaml = require('js-yaml');
+const { spawnSync } = require('child_process');
+
+/**
+ * Retrieves the current Self-Managed documentation version from the remote antora.yml file.
+ *
+ * @returns {Promise<string>} Resolves with the version string (e.g., "25.1").
+ *
+ * @throws {Error} If the antora.yml file cannot be fetched, parsed, or if the version field is missing.
+ */
+function fetchRemoteAntoraVersion() {
+  const url = 'https://raw.githubusercontent.com/redpanda-data/docs/main/antora.yml'
+  return new Promise((resolve, reject) => {
+    https.get(url, res => {
+      if (res.statusCode !== 200) {
+        return reject(new Error(`Failed to fetch antora.yml: ${res.statusCode}`))
+      }
+      let body = ''
+      res.on('data', chunk => (body += chunk))
+      res.on('end', () => {
+        try {
+          const cfg = yaml.load(body)
+          if (cfg.version == null) {
+            throw new Error('version field missing')
+          }
+          const version = String(cfg.version).trim()
+          resolve(version)
+        } catch (err) {
+          reject(err)
+        }
+      })
+    }).on('error', reject)
+  })
+}
+
+/**
+ * Determines the appropriate documentation branch for a given operator tag based on the remote Antora version.
+ *
+ * Normalizes the input tag, extracts the major.minor version, and applies version-specific logic to select the correct branch. Verifies that the chosen branch exists in the remote repository.
+ *
+ * @param {string} operatorTag - The operator tag to evaluate (e.g., "operator/v25.1.2" or "v25.1.2").
+ * @returns {Promise<string>} The name of the documentation branch to use.
+ *
+ * @throws {Error} If the tag cannot be parsed or if the determined branch does not exist in the remote repository.
+ */
+async function determineDocsBranch(operatorTag) {
+  // Strip any "operator/" prefix
+  const TAG = operatorTag.replace(/^(?:operator|release)\//, '')
+  // Pull in the remote Antora version
+  const ANTORA = await fetchRemoteAntoraVersion()
+  // Extract v<major>.<minor>
+  const mm = TAG.match(/^v(\d+\.\d+)/)
+  const filtered = mm ? `v${mm[1]}` : null
+
+  if (!filtered) {
+    throw new Error(`Could not parse major.minor from ${TAG}`)
+  }
+
+  let branch
+  if (filtered === 'v2.4') {
+    if (ANTORA === '25.1') {
+      branch = 'main'
+    } else {
+      branch = 'v/24.3'
+    }
+  } else if (filtered === `v${ANTORA}`) {
+    branch = 'main'
+  } else {
+    branch = `v/${filtered.slice(1)}`
+  }
+
+  // Verify branch exists
+  const repo = 'https://github.com/redpanda-data/docs.git'
+  const ref  = `refs/heads/${branch}`
+  const ok = spawnSync('git', ['ls-remote', '--exit-code', '--heads', repo, ref], {
+    stdio: 'ignore'
+  }).status === 0
+
+  if (!ok) {
+    throw new Error(`Docs branch ${branch} not found in ${repo}`)
+  }
+
+  return branch
+}
+
+module.exports = {
+  fetchRemoteAntoraVersion,
+  determineDocsBranch
+}

package/cli-utils/start-cluster.sh

@@ -20,12 +20,22 @@ if [[ "$TAG" != "latest" ]]; then
   MAJOR_MINOR="$(echo "$TAG" | sed -E 's/^v?([0-9]+\.[0-9]+).*$/\1/')"
 fi
 
+# Conditionally override quickstart dir for >= 25.1
+if [[ "$MAJOR_MINOR" =~ ^([0-9]+)\.([0-9]+)$ ]]; then
+  major="${BASH_REMATCH[1]}"
+  minor="${BASH_REMATCH[2]}"
+
+  if (( major > 25 )) || (( major == 25 && minor >= 1 )); then
+    QUICKSTART_DIR="$PACKAGE_ROOT/docker-compose/25.1"
+  fi
+fi
+
 # Fetch quickstart into package root if needed
 if [[ ! -d "$QUICKSTART_DIR" ]]; then
   echo "📥 Fetching Redpanda quickstart for ${MAJOR_MINOR}…"
   if [[ "$TAG" == "latest" ]]; then
-	  curl -sSLf --retry 3 https://docs.redpanda.com/redpanda-quickstart.tar.gz \
-	  | tar -C "$PACKAGE_ROOT" -xzf -
+    curl -sSLf --retry 3 https://docs.redpanda.com/redpanda-quickstart.tar.gz \
+      | tar -C "$PACKAGE_ROOT" -xzf -
   else
     curl -sSLf --retry 3 "https://docs.redpanda.com/${MAJOR_MINOR}-redpanda-quickstart.tar.gz" \
       | tar -C "$PACKAGE_ROOT" -xzf -

package/docker-compose/25.1/bootstrap.yml

@@ -0,0 +1,67 @@
+# =================================================================
+# This file defines initial cluster properties for a Redpanda cluster.
+# Some of these settings are intended for quickstart development and evaluation
+# and are not suitable for production environments.
+#
+# For more information on bootstrap files, see:
+# https://docs.redpanda.com/current/deploy/deployment-option/self-hosted/manual/production/production-deployment/#configure-a-bootstrap-file
+# =================================================================
+
+#
+# Enable SASL authentication for the Kafka and Admin APIs.
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#admin_api_require_auth
+admin_api_require_auth: true
+# At least one superuser is required to be able to create other SASL users
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#superusers
+superusers:
+  - superuser
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#enable_sasl
+enable_sasl: true
+# Allow topics to be created on first access.
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#auto_create_topics_enabled
+auto_create_topics_enabled: true
+# Enable data transforms.
+# https://docs.redpanda.com/current/develop/data-transforms/how-transforms-work/
+data_transforms_enabled: true
+# Enable audit logging (enterprise feature).
+# https://docs.redpanda.com/current/manage/audit-logging/
+audit_enabled: true
+# Enable Tiered Storage (enterprise feature).
+# https://docs.redpanda.com/current/manage/tiered-storage/
+cloud_storage_enabled: true
+cloud_storage_region: local
+cloud_storage_access_key: minio
+cloud_storage_secret_key: redpandaTieredStorage7
+cloud_storage_api_endpoint: minio
+cloud_storage_api_endpoint_port: 9000
+cloud_storage_disable_tls: true
+cloud_storage_bucket: redpanda
+cloud_storage_enable_remote_write: true
+cloud_storage_enable_remote_read: true
+# Forces segments to be uploaded to Tiered Storage faster for the purposes of the quickstart
+# https://docs.redpanda.com/current/reference/properties/object-storage-properties/#cloud_storage_segment_max_upload_interval_sec
+cloud_storage_segment_max_upload_interval_sec: 60
+# Continuous Data Balancing (enterprise feature) continuously monitors your node and rack availability and disk usage. This enables self-healing clusters that dynamically balance partitions, ensuring smooth operations and optimal cluster performance.
+# https://docs.redpanda.com/current/manage/cluster-maintenance/continuous-data-balancing/
+partition_autobalancing_mode: continuous
+# Enable Redpanda to collect consumer group metrics.
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#enable_consumer_group_metrics
+enable_consumer_group_metrics:
+  - "group"
+  - "partition"
+  - "consumer_lag"
+# Lower the interval for the autogeneration of consumer group metrics.
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#consumer_group_lag_collection_interval_sec
+consumer_group_lag_collection_interval_sec: 60
+# Enable Redpanda to collect host metrics.
+# https://docs.redpanda.com/current/reference/properties/cluster-properties/#enable_host_metrics
+enable_host_metrics: true
+# Enable for Iceberg metrics
+iceberg_enabled: true
+# Set up Iceberg REST catalog configuration
+iceberg_catalog_type: rest
+iceberg_rest_catalog_endpoint: http://catalog:8181
+# Credentials are required, but the catalog ignores them
+iceberg_rest_catalog_client_id: catalog
+iceberg_rest_catalog_client_secret: catalog123
+iceberg_catalog_commit_interval_ms: 5000

package/docker-compose/25.1/docker-compose.yml

@@ -0,0 +1,414 @@
+name: redpanda-cluster
+networks:
+  redpanda_network:
+    driver: bridge
+volumes:
+  redpanda-0: null
+  redpanda-1: null
+  redpanda-2: null
+  minio: null
+services:
+  ##################
+  # Redpanda Brokers #
+  ##################
+  redpanda-0:
+    command:
+      - redpanda
+      - start
+      - --kafka-addr internal://0.0.0.0:9092,external://0.0.0.0:19092
+      # Address the broker advertises to clients that connect to the Kafka API.
+      # Use the internal addresses to connect to the Redpanda brokers
+      # from inside the same Docker network.
+      # Use the external addresses to connect to the Redpanda brokers
+      # from outside the Docker network.
+      - --advertise-kafka-addr internal://redpanda-0:9092,external://localhost:19092
+      - --pandaproxy-addr internal://0.0.0.0:8082,external://0.0.0.0:18082
+      # Address the broker advertises to clients that connect to the HTTP Proxy.
+      - --advertise-pandaproxy-addr internal://redpanda-0:8082,external://localhost:18082
+      - --schema-registry-addr internal://0.0.0.0:8081,external://0.0.0.0:18081
+      # Redpanda brokers use the RPC API to communicate with each other internally.
+      - --rpc-addr redpanda-0:33145
+      - --advertise-rpc-addr redpanda-0:33145
+      # Mode dev-container uses well-known configuration properties for development in containers.
+      - --mode dev-container
+      # Tells Seastar (the framework Redpanda uses under the hood) to use 1 core on the system.
+      - --smp 1
+      - --default-log-level=info
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    container_name: redpanda-0
+    # Sets the username and password of the bootstrap SCRAM superuser
+    # See https://docs.redpanda.com/current/deploy/deployment-option/self-hosted/manual/production/production-deployment/#bootstrap-a-user-account
+    environment:
+      RP_BOOTSTRAP_USER: "superuser:secretpassword"
+    volumes:
+      - redpanda-0:/var/lib/redpanda/data
+      - ./bootstrap.yml:/etc/redpanda/.bootstrap.yaml
+    networks:
+      - redpanda_network
+    ports:
+      - 18081:18081
+      - 18082:18082
+      - 19092:19092
+      - 19644:9644
+    healthcheck:
+      test: ["CMD", "rpk", "cluster", "info", "-X", "user=superuser", "-X", "pass=secretpassword"]
+      interval: 10s
+      timeout: 15s
+      retries: 10
+    depends_on:
+      minio:
+        condition: service_healthy
+  redpanda-1:
+    command:
+      - redpanda
+      - start
+      - --kafka-addr internal://0.0.0.0:9092,external://0.0.0.0:29092
+      - --advertise-kafka-addr internal://redpanda-1:9092,external://localhost:29092
+      - --pandaproxy-addr internal://0.0.0.0:8082,external://0.0.0.0:28082
+      - --advertise-pandaproxy-addr internal://redpanda-1:8082,external://localhost:28082
+      - --schema-registry-addr internal://0.0.0.0:8081,external://0.0.0.0:28081
+      - --rpc-addr redpanda-1:33145
+      - --advertise-rpc-addr redpanda-1:33145
+      - --mode dev-container
+      - --smp 1
+      - --default-log-level=info
+      - --seeds redpanda-0:33145
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    container_name: redpanda-1
+    environment:
+      RP_BOOTSTRAP_USER: "superuser:secretpassword"
+    volumes:
+      - redpanda-1:/var/lib/redpanda/data
+      - ./bootstrap.yml:/etc/redpanda/.bootstrap.yaml
+    networks:
+      - redpanda_network
+    ports:
+      - 28081:28081
+      - 28082:28082
+      - 29092:29092
+      - 29644:9644
+    depends_on:
+      - redpanda-0
+      - minio
+  redpanda-2:
+    command:
+      - redpanda
+      - start
+      - --kafka-addr internal://0.0.0.0:9092,external://0.0.0.0:39092
+      - --advertise-kafka-addr internal://redpanda-2:9092,external://localhost:39092
+      - --pandaproxy-addr internal://0.0.0.0:8082,external://0.0.0.0:38082
+      - --advertise-pandaproxy-addr internal://redpanda-2:8082,external://localhost:38082
+      - --schema-registry-addr internal://0.0.0.0:8081,external://0.0.0.0:38081
+      - --rpc-addr redpanda-2:33145
+      - --advertise-rpc-addr redpanda-2:33145
+      - --mode dev-container
+      - --smp 1
+      - --default-log-level=info
+      - --seeds redpanda-0:33145
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    container_name: redpanda-2
+    environment:
+      RP_BOOTSTRAP_USER: "superuser:secretpassword"
+    volumes:
+      - redpanda-2:/var/lib/redpanda/data
+      - ./bootstrap.yml:/etc/redpanda/.bootstrap.yaml
+    networks:
+      - redpanda_network
+    ports:
+      - 38081:38081
+      - 38082:38082
+      - 39092:39092
+      - 39644:9644
+    depends_on:
+      - redpanda-0
+      - minio
+  ####################
+  # Redpanda Console #
+  ####################
+  console:
+    container_name: redpanda-console
+    image: docker.redpanda.com/redpandadata/${CONSOLE_DOCKER_REPO:-console}:${REDPANDA_CONSOLE_VERSION:-latest}
+    networks:
+      - redpanda_network
+    entrypoint: /bin/sh
+    command: -c 'echo "$$CONSOLE_CONFIG_FILE" > /tmp/config.yml && /app/console'
+    volumes:
+      - ./config:/tmp/config/
+    environment:
+      CONFIG_FILEPATH: ${CONFIG_FILEPATH:-/tmp/config.yml}
+      CONSOLE_CONFIG_FILE: |
+        # Configure a connection to the Redpanda cluster
+        # See https://docs.redpanda.com/current/console/config/connect-to-redpanda/
+        kafka:
+          brokers: ["redpanda-0:9092"]
+          sasl:
+            enabled: true
+            impersonateUser: true
+        schemaRegistry:
+          enabled: true
+          urls: ["http://redpanda-0:8081","http://redpanda-1:8081","http://redpanda-2:8081"]
+          authentication:
+            impersonateUser: true
+        redpanda:
+          adminApi:
+            enabled: true
+            urls: ["http://redpanda-0:9644","http://redpanda-1:9644","http://redpanda-2:9644"]
+            authentication:
+              basic:
+                username: superuser
+                password: secretpassword
+              impersonateUser: false
+        console:
+          # Configures Redpanda Console to fetch topic documentation from GitHub and display it in the UI.
+          # See https://docs.redpanda.com/current/console/config/topic-documentation/
+          topicDocumentation:
+            enabled: true
+            git:
+              enabled: true
+              repository:
+                url: https://github.com/redpanda-data/docs
+                branch: main
+                baseDirectory: tests/docker-compose
+        authentication:
+          jwtSigningKey: vazxnT+ZHtxKslK6QlDGovcYnSjTk/lKMmZ+mHrBVE+YdVDkLgSuP6AszAKe9Gvq
+          basic:
+            enabled: true
+        authorization:
+          roleBindings:
+          - roleName: admin
+            users:
+              - loginType: basic
+                name: superuser
+    ports:
+      - 8080:8080
+    depends_on:
+      redpanda-0:
+        condition: service_healthy
+  ####################
+  # Redpanda Connect #
+  ####################
+  connect:
+    container_name: redpanda-connect
+    image: docker.redpanda.com/redpandadata/connect
+    networks:
+      - redpanda_network
+    entrypoint: /bin/sh
+    depends_on:
+      redpanda-0:
+        condition: service_healthy
+    command: -c 'echo "$$CONNECT_CFG_FILE" > /tmp/connect.yml; /redpanda-connect -c /tmp/connect.yml'
+    environment:
+      # This Redpanda Connect configuration creates fake data,
+      # processes it, and writes the output to a set of topics.
+      #
+      # Input:
+      #  - Uses Redpanda Connect's generate input to generate fake data.
+      # See https://docs.redpanda.com/redpanda-connect/components/inputs/generate/
+      # Pipeline:
+      #  - Bloblang mapping to batch each input and map 1 message to 'logins'
+      #    topic, and a random number (1-3) of messages to 'transaction' topic
+      #  - Unarchive processor to parse the JSON array and extract each
+      #    element into its own message.
+      # See https://docs.redpanda.com/redpanda-connect/guides/bloblang/about/
+      # Output:
+      #  - kafka_franz output to write the messages to the Redpanda brokers.
+      # See https://docs.redpanda.com/redpanda-connect/components/outputs/kafka_franz/
+      CONNECT_CFG_FILE: |
+        input:
+          generate:
+            interval: 1s
+            mapping: |
+              let first_name = fake("first_name")
+              let last_name  = fake("last_name")
+
+              root.user_id    = counter()
+              root.name       = $$first_name + " " + $$last_name
+              root.email      = ($$first_name.slice(0,1) + $$last_name + "@" + fake("domain_name")).lowercase()
+              root.ip         = fake("ipv4")
+              root.login_time = now()
+        pipeline:
+          processors:
+            - mapping: |
+                root = range(0, random_int(min:2, max:4)).map_each(cust -> this)
+            - unarchive:
+                format: "json_array"
+            - mapping: |
+                if batch_index() == 0 {
+                  meta topic = "logins"
+                  root = this
+                } else {
+                  meta topic       = "transactions"
+                  root.user_id     = this.user_id
+                  root.email       = this.email
+                  root.index       = batch_index() - 1
+                  root.product_url = fake("url")
+                  root.price       = fake("amount_with_currency")
+                  root.timestamp   = now()
+                }
+        output:
+          kafka_franz:
+            seed_brokers: [ "redpanda-0:9092" ]
+            topic: $${! metadata("topic") }
+            sasl:
+              - mechanism: SCRAM-SHA-256
+                password: secretpassword
+                username: superuser
+  ####################
+  # rpk container to create the edu-filtered-domains topic #
+  # See https://docs.redpanda.com/current/reference/rpk/rpk-topic/rpk-topic-create/
+  ####################
+  createtopic:
+    command:
+      - topic
+      - create
+      - edu-filtered-domains
+      - -X user=superuser
+      - -X pass=secretpassword
+      - -X brokers=redpanda-0:9092
+      - --topic-config
+      - redpanda.iceberg.mode=key_value
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    networks:
+      - redpanda_network
+    depends_on:
+      redpanda-0:
+        condition: service_healthy
+  ####################
+  # rpk container to register the schema #
+  # See https://docs.redpanda.com/current/manage/schema-reg/schema-reg-api/
+  ####################
+  registerschema:
+    command:
+      - registry
+      - schema
+      - create
+      - transactions
+      - --schema
+      - /etc/redpanda/transactions-schema.json
+      - -X user=superuser
+      - -X pass=secretpassword
+      - -X registry.hosts=redpanda-0:8081
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    # Mount the local directory that contains your schema to the container.
+    volumes:
+      - ./transactions-schema.json:/etc/redpanda/transactions-schema.json
+    networks:
+      - redpanda_network
+    depends_on:
+      redpanda-0:
+        condition: service_healthy
+  ####################
+  # rpk container to deploy a consumer group #
+  # See https://docs.redpanda.com/current/reference/rpk/rpk-topic/rpk-topic-consume/
+  ####################
+  consumergroup:
+    command:
+      - topic
+      - consume
+      - transactions
+      - --group
+      - transactions-consumer
+      - -X user=superuser
+      - -X pass=secretpassword
+      - -X brokers=redpanda-0:9092
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    networks:
+      - redpanda_network
+    depends_on:
+      - deploytransform
+  ####################
+  # rpk container to deploy the pre-built data transform #
+  # See https://docs.redpanda.com/current/develop/data-transforms/deploy/
+  ####################
+  deploytransform:
+    command:
+      - transform
+      - deploy
+      - --file=/etc/redpanda/regex.wasm
+      - --name=regex
+      - --input-topic=logins
+      - --output-topic=edu-filtered-domains
+      - --var=PATTERN="[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.edu"
+      - --var=MATCH_VALUE=true
+      - -X user=superuser
+      - -X pass=secretpassword
+      - -X admin.hosts=redpanda-0:9644
+    image: docker.redpanda.com/redpandadata/${REDPANDA_DOCKER_REPO:-redpanda}:${REDPANDA_VERSION:-latest}
+    volumes:
+      - ./transform/regex.wasm:/etc/redpanda/regex.wasm
+    networks:
+      - redpanda_network
+    depends_on:
+      redpanda-0:
+        condition: service_healthy
+      createtopic:
+        condition: service_started
+  ####################
+  # MinIO for Tiered Storage #
+  # See https://min.io/
+  #
+  # NOTE: MinIO is included in this quickstart for development and evaluation purposes only.
+  # It is not supported for production deployments of Redpanda.
+  #
+  # For production environments, use one of the supported object storage providers:
+  # https://docs.redpanda.com/current/deploy/deployment-option/self-hosted/manual/production/requirements/#object-storage-providers-for-tiered-storage
+  ####################
+  minio:
+    container_name: minio
+    image: minio/minio
+    command: server --console-address ":9001" /data
+    ports:
+      - 9000:9000
+      - 9001:9001
+    environment:
+      MINIO_ROOT_USER: minio
+      MINIO_ROOT_PASSWORD: redpandaTieredStorage7
+      MINIO_SERVER_URL: "http://minio:9000"
+      MINIO_REGION_NAME: local
+      MINIO_DOMAIN: minio
+    volumes:
+      - minio:/data
+    networks:
+      redpanda_network:
+        aliases:
+          - redpanda.minio
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/ready"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+  mc:
+    depends_on:
+      minio:
+        condition: service_healthy
+    image: minio/mc
+    container_name: mc
+    networks:
+      - redpanda_network
+    environment:
+      - AWS_ACCESS_KEY_ID=minio
+      - AWS_SECRET_ACCESS_KEY=redpandaTieredStorage7
+      - AWS_REGION=local
+    entrypoint: >
+      /bin/sh -c "
+      until (/usr/bin/mc config host add minio http://minio:9000 minio redpandaTieredStorage7) do echo '...waiting...' && sleep 1; done;
+      /usr/bin/mc mb minio/redpanda;
+      /usr/bin/mc policy set public minio/redpanda;
+      tail -f /dev/null
+      "
+  catalog:
+    image: tabulario/iceberg-rest
+    container_name: iceberg-rest
+    networks:
+      - redpanda_network
+    depends_on:
+      - minio
+    ports:
+      - 8181:8181
+    environment:
+      - AWS_ACCESS_KEY_ID=minio
+      - AWS_SECRET_ACCESS_KEY=redpandaTieredStorage7
+      - AWS_REGION=local
+      - CATALOG_WAREHOUSE=s3://redpanda/
+      - CATALOG_IO__IMPL=org.apache.iceberg.aws.s3.S3FileIO
+      - CATALOG_S3_ENDPOINT=http://minio:9000