v2 Getting Started (AWS)

.github/workflows/feature-branch-only-to-main.yml

@@ -0,0 +1,28 @@
+name: "Restrict Docs PR merges"
+
+on:
+  pull_request:
+    types: [opened, reopened, edited]
+
+jobs:
+  validate-refs:
+    name: "Validate Refs"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Validate
+        run: |
+          # We allow merging to a branch which is a feature branch for documentation.
+          if [[ $GITHUB_BASE_REF == aws-docs-* || $GITHUB_BASE_REF == snowflake-docs-* ]]; then
+              echo "Merging to a feature branch. Allowing."
+              exit 0
+          fi
+
+          # We allow merging to main so long as it's from a feature branch for documentation.
+          if [[ $GITHUB_BASE_REF == main && ($GITHUB_HEAD_REF == aws-docs-* || $GITHUB_HEAD_REF == snowflake-docs-*) ]]; then
+              echo "Merging feature branch to main. Allowing."
+              exit 0
+          fi
+
+          # All other scenarios aren't valid for merging.
+          echo "Please ensure all changes are merged to a feature branch. Only feature branches can be merged into main. Rejecting."
+          exit 1

.github/workflows/update-extensions-docs.yml

@@ -0,0 +1,73 @@
+name: Update LocalStack Extensions Docs
+
+on:
+  schedule:
+    # Run on the 1st of every month at 00:00 UTC
+    - cron: "0 0 1 * *"
+  workflow_dispatch:
+    inputs:
+      targetBranch:
+        description: 'Target branch to create the PR against'
+        required: false
+        type: string
+        default: 'main'
+
+env:
+  TARGET_BRANCH: ${{ github.event.inputs.targetBranch || 'main' }}
+
+jobs:
+  update-extensions-docs:
+    name: Update LocalStack Extensions Docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout docs
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          path: docs
+          ref: ${{ env.TARGET_BRANCH }}
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.11"
+
+      - name: Generate Extensions documentation
+        working-directory: docs
+        run: |
+          python3 scripts/generate_extensions_docs.py
+        env:
+          LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}
+
+      - name: Check for changes
+        id: check-for-changes
+        working-directory: docs
+        env:
+          TARGET_BRANCH: ${{ env.TARGET_BRANCH }}
+        run: |
+          # Check if there are changed files
+          # Check against the PR branch if it exists, otherwise against the target branch
+          mkdir -p resources
+          FILE_TO_CHECK="src/content/docs/aws/tooling/extensions/official-extensions.md"
+          (git diff --name-only origin/extensions-docs-auto-updates "$FILE_TO_CHECK" 2>/dev/null || git diff --name-only "origin/$TARGET_BRANCH" "$FILE_TO_CHECK" 2>/dev/null) | tee resources/diff-check.log
+          echo "diff-count=$(cat resources/diff-check.log | wc -l)" >> $GITHUB_OUTPUT
+          cat resources/diff-check.log
+
+      - name: Create PR
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
+        if: ${{ success() && steps.check-for-changes.outputs.diff-count != '0' && steps.check-for-changes.outputs.diff-count != '' }}
+        with:
+          path: docs
+          title: "Update LocalStack Extensions Documentation"
+          body: |
+            Automated update of the LocalStack Official Extensions documentation.
+
+            This PR was auto-generated by the `update-extensions-docs` workflow which runs on the 1st of every month.
+
+            **Changes include:**
+            - Updated list of official and community extensions available on the marketplace
+          branch: "extensions-docs-auto-updates"
+          author: "LocalStack Bot <localstack-bot@users.noreply.github.com>"
+          committer: "LocalStack Bot <localstack-bot@users.noreply.github.com>"
+          commit-message: "update generated LocalStack Extensions docs"
+          token: ${{ secrets.PRO_ACCESS_TOKEN }}

CODEOWNERS

@@ -103,7 +103,7 @@
 /src/content/docs/aws/services/eks.mdx @nik-localstack @pinzon @quetzalliwrites @HarshCasper
 
 # elasticache
-/src/content/docs/aws/services/elasticache.mdx @thrau @giograno @silv-io @quetzalliwrites @HarshCasper
+/src/content/docs/aws/services/elasticache.mdx @giograno @silv-io @quetzalliwrites @HarshCasper
 
 # elb
 /src/content/docs/aws/services/elb.mdx @nik-localstack @quetzalliwrites @HarshCasper
@@ -132,9 +132,6 @@
 # iot
 /src/content/docs/aws/services/iot.mdx @viren-nadkarni @quetzalliwrites @HarshCasper
 
-# kafka
-/src/content/docs/aws/services/kafka.mdx @thrau @quetzalliwrites @HarshCasper
-
 # kinesisanalyticsv2
 /src/content/docs/aws/services/kinesisanalyticsv2.mdx @viren-nadkarni @quetzalliwrites @HarshCasper
 
@@ -202,7 +199,7 @@
 /src/content/docs/aws/services/sns.mdx @bentsku @baermat @quetzalliwrites @HarshCasper
 
 # sqs
-/src/content/docs/aws/services/sqs.mdx @baermat @thrau @quetzalliwrites @HarshCasper
+/src/content/docs/aws/services/sqs.mdx @baermat @quetzalliwrites @HarshCasper
 
 # ssm
 /src/content/docs/aws/services/ssm.mdx @viren-nadkarni @quetzalliwrites @HarshCasper