chore: setup infra for docs

Author: ivan-aksamentov

Diff for: .github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: docs
+
+on:
+  push:
+    branches: [ 'release-docs' ]
+
+  pull_request:
+    paths:
+      - 'docs/**'
+
+concurrency:
+  group: cli-${{ github.workflow }}-${{ github.ref_type }}-${{ github.event.pull_request.number || github.ref || github.run_id }}
+  cancel-in-progress: true
+
+defaults:
+  run:
+    shell: bash -euo pipefail {0}
+
+env:
+  GITHUB_REPOSITORY_URL: ${{ github.server_url }}/${{ github.repository }}
+
+jobs:
+
+  docs:
+    name: "docs"
+    runs-on: "ubuntu-24.04"
+    environment:
+      name: ${{ github.ref }}
+
+    steps:
+      - uses: "actions/checkout@v4"
+        with:
+          fetch-depth: 1
+          submodules: true
+
+      - uses: "actions/setup-node@v4"
+        with:
+          node-version: "22"
+
+      - name: "install dependencies"
+        run: |
+          npm install -g bun
+          bun install
+
+      - name: "build docs"
+        run: |
+          bun prod:build
+
+      - name: "deploy docs"
+        if: ${{ endsWith(github.ref, '/release-docs') }}
+        run: |
+          ./docs/deploy

Diff for: docs/deploy

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euxo pipefail
+shopt -s globstar
+trap "exit" INT
+
+: "${AWS_S3_BUCKET:?The environment variable is required}"
+: "${AWS_CLOUDFRONT_DISTRIBUTION_ID:?The environment variable is required}"
+
+export AWS_MAX_ATTEMPTS=10
+
+pushd "docs/build" >/dev/null
+{
+  # Upload non-HTML files
+  aws s3 sync \
+    --delete \
+    --only-show-errors \
+    --cache-control "max-age=2592000, public" \
+    --metadata-directive REPLACE \
+    --exclude "*.html" \
+    . "s3://${AWS_S3_BUCKET}/"
+
+  # Remove .html extension from HTML files and move them to a separate directory to handle them separately
+  mkdir -p temporary_htmls
+  find . -type f -name "*.html" -exec bash -c 'mv "$0" "temporary_htmls/${0%.html}"' {} \;
+
+  # Upload extensionless HTML files
+  aws s3 sync \
+    --delete \
+    --only-show-errors \
+    --content-type "text/html" \
+    --cache-control "max-age=0, must-revalidate" \
+    --metadata-directive REPLACE \
+    temporary_htmls/ "s3://${AWS_S3_BUCKET}/"
+
+  # Update Cloudfront cache
+  aws cloudfront create-invalidation \
+    --no-paginate \
+    --distribution-id "${AWS_CLOUDFRONT_DISTRIBUTION_ID}" \
+    --paths "/*" \
+    >/dev/null
+}
+popd >/dev/null