TCLOUD-4780: Created workflows for automatic previews

Author: tiny-james

.github/workflows/preview_create.yml

@@ -0,0 +1,68 @@
+name: Preview Create/Update
+
+on:
+  create:
+    branches-ignore:
+      - 'main'
+      - 'develop'
+      - 'tinymce/**'
+      - 'release/**'
+      - 'archived/**'
+
+  push:
+    branches-ignore:
+      - 'main'
+      - 'develop'
+      - 'tinymce/**'
+      - 'release/**'
+      - 'archived/**'
+
+jobs:
+
+  build:
+    name: Update Docs Preview
+
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        shell: bash
+        working-directory: ./.github/workflows/scripts
+
+    steps:
+    - name: Checkout branch
+      uses: actions/checkout@v5
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v5
+      with:
+        cache: 'yarn'
+        node-version: 24
+
+    - name: Install dependencies
+      run: yarn install
+
+    - name: Build Website
+      run: yarn antora ./antora-playbook.yml
+
+    - name: Rename sitemap.xml
+      run: |
+        mv ./build/site/sitemap.xml ./build/site/antora-sitemap.xml
+
+    - name: Convert branch into subdomain
+      id: get-subdomain
+      run: |
+        node ./branch-to-subdomain.js | { read s; echo "subdomain=$s" } >> $GITHUB_OUTPUT
+
+    - name: configure aws credentials
+      uses: aws-actions/[email protected]
+      with:
+        role-to-assume: arn:aws:iam::327995277200:role/staging-docs-preview-update
+        role-session-name: docs-preview-update
+        aws-region: us-east-2
+
+    - name: Upload website preview to S3
+      run: |
+        aws s3 sync --delete ./build/site s3://tiny-cloud-antora-docs-preview/${SUBDOMAIN}/docs
+      env:
+        SUBDOMAIN: ${{ steps.get-subdomain.outputs.subdomain }}

.github/workflows/preview_delete.yml

@@ -0,0 +1,49 @@
+name: Preview Delete
+
+on:
+  delete:
+    branches-ignore:
+      - 'main'
+      - 'develop'
+      - 'tinymce/**'
+      - 'release/**'
+      - 'archived/**'
+
+jobs:
+  cleanup:
+    name: Cleanup Docs Preview
+
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        shell: bash
+        working-directory: ./.github/workflows/scripts
+
+    steps:
+    - name: Checkout branch
+      uses: actions/checkout@v5
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v5
+      with:
+        cache: 'yarn'
+        node-version: 24
+
+    - name: Convert branch into subdomain
+      id: get-subdomain
+      run: |
+        node ./branch-to-subdomain.js | { read s; echo "subdomain=$s" } >> $GITHUB_OUTPUT
+
+    - name: configure aws credentials
+      uses: aws-actions/[email protected]
+      with:
+        role-to-assume: arn:aws:iam::327995277200:role/staging-docs-preview-update
+        role-session-name: docs-preview-delete
+        aws-region: us-east-2
+
+    - name: Remove website preview from S3
+      run: |
+        aws s3 rm s3://tiny-cloud-antora-docs-preview/${SUBDOMAIN}/docs
+      env:
+        SUBDOMAIN: ${{ steps.get-subdomain.outputs.subdomain }}

.github/workflows/scripts/branch-to-subdomain.js

@@ -0,0 +1,11 @@
+
+const branch = process.argv[2] ?? process.env.GITHUB_REF_NAME;
+const subdomain = (
+  branch
+    .toLowerCase()                  // convert to lowercase
+    .replace(/[/\s]/g, '-')         // convert spaces and slashes to dash
+    .replace(/[^0-9a-z-]/g, '')     // remove non alphanumeric+dash
+    .replace(/-$/g, '')             // remove trailing dash
+    .slice(0, 63)                   // limit to 63 characters
+);
+console.log(subdomain);