From 9a0b1e9bd1ab6089abf3c6a10d2d5a081f9632d8 Mon Sep 17 00:00:00 2001 From: Puneet Dixit <236133619+puneetdixit200@users.noreply.github.com> Date: Wed, 20 May 2026 21:34:10 +0530 Subject: [PATCH 1/2] docs: document supported architectures Signed-off-by: Puneet Dixit <236133619+puneetdixit200@users.noreply.github.com> --- docs/guides/supported-architectures.md | 35 ++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/guides/supported-architectures.md diff --git a/docs/guides/supported-architectures.md b/docs/guides/supported-architectures.md new file mode 100644 index 0000000000..d381a52142 --- /dev/null +++ b/docs/guides/supported-architectures.md @@ -0,0 +1,35 @@ +--- +title: "Supported architectures" +linkTitle: "Supported architectures" +weight: 16 +--- + +Cortex release artifacts are built and tested for the architectures listed +below. Use these targets when selecting container images, binary artifacts, or +OS packages for production deployments. + +## Supported release targets + +| Artifact type | Operating system | Architectures | +|---------------|------------------|---------------| +| Container images | Linux | `amd64`, `arm64` | +| Cortex binary | Linux | `amd64`, `arm64` | +| Cortex binary | macOS | `amd64`, `arm64` | +| Query tee binary | Linux | `amd64`, `arm64` | +| Query tee binary | macOS | `amd64`, `arm64` | +| Debian package | Linux | `amd64`, `arm64` | +| RPM package | Linux | `amd64`, `arm64` | + +The CI and release pipelines build Cortex with `GOOS` and `GOARCH` targets +matching these rows. Integration tests also run against Linux `amd64` and +`arm64` Cortex images. + +## Unsupported targets + +Other operating systems or architectures may work when built from source, but +they are not part of the regular Cortex release artifacts or CI matrix. Treat +those builds as unsupported unless you validate them in your own environment. + +Cortex does not require architecture-specific CPU extensions such as AVX in its +release build configuration. If you use external services or custom base images +alongside Cortex, verify their architecture and CPU requirements separately. From e0a509a0345055555630f181b0a8e493cdf348de Mon Sep 17 00:00:00 2001 From: Puneet Dixit Date: Thu, 21 May 2026 06:08:59 +0530 Subject: [PATCH 2/2] docs: clarify supported architecture testing Signed-off-by: Puneet Dixit --- docs/guides/supported-architectures.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/guides/supported-architectures.md b/docs/guides/supported-architectures.md index d381a52142..aef1270b83 100644 --- a/docs/guides/supported-architectures.md +++ b/docs/guides/supported-architectures.md @@ -4,9 +4,9 @@ linkTitle: "Supported architectures" weight: 16 --- -Cortex release artifacts are built and tested for the architectures listed -below. Use these targets when selecting container images, binary artifacts, or -OS packages for production deployments. +Cortex release artifacts are built for the operating systems and architectures +listed below. Use these targets when selecting container images, binary +artifacts, or OS packages for production deployments. ## Supported release targets @@ -14,15 +14,15 @@ OS packages for production deployments. |---------------|------------------|---------------| | Container images | Linux | `amd64`, `arm64` | | Cortex binary | Linux | `amd64`, `arm64` | -| Cortex binary | macOS | `amd64`, `arm64` | -| Query tee binary | Linux | `amd64`, `arm64` | -| Query tee binary | macOS | `amd64`, `arm64` | +| Cortex binary | darwin (macOS) | `amd64`, `arm64` | +| `query-tee` binary | Linux | `amd64`, `arm64` | +| `query-tee` binary | darwin (macOS) | `amd64`, `arm64` | | Debian package | Linux | `amd64`, `arm64` | | RPM package | Linux | `amd64`, `arm64` | The CI and release pipelines build Cortex with `GOOS` and `GOARCH` targets -matching these rows. Integration tests also run against Linux `amd64` and -`arm64` Cortex images. +matching these rows. Automated tests run against Linux `amd64` and `arm64` +Cortex images. ## Unsupported targets