Speed up CI builds and prevent duplicate translation runs

- Use setup-node's npm cache instead of caching node_modules,
  which npm ci wipes anyway.
- Move puppeteer to optionalDependencies and pass --omit=optional
  in deploy/translate workflows, skipping the Chromium download.
- Add per-job concurrency: cancel in-flight builds on new pushes,
  but never cancel deploy or translate jobs mid-run.
- Set timeout-minutes: 60 on translate to bound stuck Anthropic
  batches.

Author: eandreeva-twr

.github/workflows/s3-deploy-development.yml

@@ -6,18 +6,16 @@ on:
 jobs:
   build-en:
     runs-on: ubuntu-latest
+    concurrency:
+      group: build-en-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: npm-${{ hashFiles('package-lock.json') }}
+          cache: 'npm'
 
       - name: Cache Astro build
         uses: actions/cache@v4
@@ -26,7 +24,7 @@ jobs:
           key: astro-dev-en-${{ github.sha }}
           restore-keys: astro-dev-en-
 
-      - run: npm ci
+      - run: npm ci --omit=optional
 
       - name: Build English only
         env:
@@ -49,18 +47,16 @@ jobs:
     strategy:
       matrix:
         locale: [zh, tr, ru]
+    concurrency:
+      group: build-locale-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: npm-${{ hashFiles('package-lock.json') }}
+          cache: 'npm'
 
       - name: Cache Astro build
         uses: actions/cache@v4
@@ -69,7 +65,7 @@ jobs:
           key: astro-dev-${{ matrix.locale }}-${{ github.sha }}
           restore-keys: astro-dev-${{ matrix.locale }}-
 
-      - run: npm ci
+      - run: npm ci --omit=optional
 
       - name: Build locale ${{ matrix.locale }}
         env:
@@ -85,6 +81,9 @@ jobs:
   deploy:
     needs: [build-en, build-locale]
     runs-on: ubuntu-latest
+    concurrency:
+      group: deploy-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: false
     permissions:
       contents: write
     environment: development

.github/workflows/s3-deploy-production.yml

@@ -41,13 +41,17 @@ jobs:
     needs: classify
     if: needs.classify.outputs.translation_only == 'false'
     runs-on: ubuntu-latest
+    concurrency:
+      group: check-internal-links-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - uses: actions/setup-node@v4
         with:
           node-version: 20
+          cache: 'npm'
       - run: npm install github-slugger
       - run: node scripts/check-links/index.mjs --diff --base=last-production-deploy --internal-only
 
@@ -57,18 +61,16 @@ jobs:
   build-en:
     needs: check-internal-links
     runs-on: ubuntu-latest
+    concurrency:
+      group: build-en-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: npm-${{ hashFiles('package-lock.json') }}
+          cache: 'npm'
 
       - name: Cache Astro build
         uses: actions/cache@v4
@@ -77,7 +79,7 @@ jobs:
           key: astro-en-${{ github.sha }}
           restore-keys: astro-en-
 
-      - run: npm ci
+      - run: npm ci --omit=optional
 
       - name: Build English only
         env:
@@ -101,18 +103,16 @@ jobs:
     strategy:
       matrix:
         locale: [zh, tr, ru]
+    concurrency:
+      group: build-locale-full-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: npm-${{ hashFiles('package-lock.json') }}
+          cache: 'npm'
 
       - name: Cache Astro build
         uses: actions/cache@v4
@@ -121,7 +121,7 @@ jobs:
           key: astro-${{ matrix.locale }}-${{ github.sha }}
           restore-keys: astro-${{ matrix.locale }}-
 
-      - run: npm ci
+      - run: npm ci --omit=optional
 
       - name: Build locale ${{ matrix.locale }}
         env:
@@ -137,6 +137,9 @@ jobs:
   deploy-full:
     needs: [build-en, build-locale-full]
     runs-on: ubuntu-latest
+    concurrency:
+      group: deploy-full-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: false
     permissions:
       contents: write
     environment: production
@@ -192,18 +195,16 @@ jobs:
     strategy:
       matrix:
         locale: [zh, tr, ru]
+    concurrency:
+      group: build-locale-only-${{ matrix.locale }}-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-
-      - name: Cache node_modules
-        uses: actions/cache@v4
-        with:
-          path: node_modules
-          key: npm-${{ hashFiles('package-lock.json') }}
+          cache: 'npm'
 
       - name: Cache Astro build
         uses: actions/cache@v4
@@ -212,7 +213,7 @@ jobs:
           key: astro-${{ matrix.locale }}-${{ github.sha }}
           restore-keys: astro-${{ matrix.locale }}-
 
-      - run: npm ci
+      - run: npm ci --omit=optional
 
       - name: Build locale ${{ matrix.locale }}
         env:
@@ -228,6 +229,9 @@ jobs:
   deploy-translations:
     needs: build-locale-only
     runs-on: ubuntu-latest
+    concurrency:
+      group: deploy-translations-${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: false
     permissions:
       contents: write
     environment: production

.github/workflows/translate.yml

@@ -10,9 +10,16 @@ on:
       - 'src/api-reference/specs/*.yaml'
       - 'src/locales/dictionary.json'
 
+# Queue concurrent runs (do not cancel) so an in-flight Anthropic batch isn't
+# killed mid-call and two pushes don't race on the translation commit.
+concurrency:
+  group: translate-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
   translate:
     runs-on: ubuntu-latest
+    timeout-minutes: 60
     permissions:
       contents: write
 
@@ -39,7 +46,7 @@ jobs:
           cache: 'npm'
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci --omit=optional
 
       # Split the diff into added/modified files (to translate) and deleted files (to clean up).
       - name: Get changed translatable files

package.json

@@ -52,9 +52,11 @@
     "eslint": "^10.1.0",
     "eslint-plugin-astro": "^1.6.0",
     "globals": "^17.4.0",
-    "puppeteer": "^24.0.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.57.2"
   },
+  "optionalDependencies": {
+    "puppeteer": "^24.0.0"
+  },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }