Switch from Volta to Mise for installing dependencies (#8058)

Instead of expecting developers to install a Node-specific dev env tool,
expect a more generic one.

This also lets us use the Mise GH action which automatically caches
tools. (Note that this only runs on main, so it might break in a way we
won't see until we merge.)

This PR slightly rolls back the Node version, primarily so that we can
see that Renovate works.

Also, use a separate CircleCI cache for each Node major version.

Author: glasser

.changeset/two-paws-worry.md

@@ -0,0 +1,2 @@
+---
+---

.circleci/config.yml

@@ -4,32 +4,34 @@ orbs:
   node: circleci/[email protected]
   secops: apollo/[email protected]
 
-commands:
-  install-volta:
-    description: Install volta to manage Node/npm versions
-    steps:
-      - run:
-          name: Install volta
-          # Teach the volta installer to update Circle's special env
-          # file instead of the default.
-          command: |
-            curl https://get.volta.sh | PROFILE="$BASH_ENV" bash
+parameters:
+  mise_version:
+    type: string
+    default: "v2025.5.1"
 
+commands:
   setup-node:
     parameters:
       node-version:
         type: string
         default: ''
     steps:
-      - install-volta
       - checkout
+      # We can consider using the CircleCI cache to cache Mise and Node, but it tends
+      # to be pretty fast to install.
+      - run:
+          name: Install Mise
+          command: |
+            curl https://mise.run | MISE_VERSION=<< pipeline.parameters.mise_version >> sh
       - when:
           condition: << parameters.node-version >>
           steps:
-          - run: volta pin node@<< parameters.node-version >>
-      - run: node --version
-      - run: npm --version
-      - node/install-packages
+          - run: mise use node@<< parameters.node-version >>
+      - run:
+          name: Use Mise to configure the environment
+          command: stty cols 80 && ~/.local/bin/mise install --verbose && mise ls && mise env --shell bash >> "$BASH_ENV" && cat "$BASH_ENV"
+      - node/install-packages:
+          cache-version: node-v<< parameters.node-version >>
 
 
 jobs:

.config/mise/config.toml

@@ -0,0 +1,15 @@
+# This is a config file for "mise-en-place": https://mise.jdx.dev/
+# It pins the version of Node and can be used to run other tools as well.
+# It's what we use to set up tools in CI.
+
+[tools]
+# This actually uses the copy of npm that comes with Node to install the version
+# of npm that we want. Since we test on ancient versions of Node like v14, we
+# want to use a slightly more modern npm. Listing it before "node" means we'll
+# actually use it instead of the version that comes with node.
+"npm:npm" = "9.9.4"
+node = "22.13.0"
+
+[env]
+# Put binaries from npm-installed packages on PATH (eg `changeset`).
+_.path = ["{{config_root}}/node_modules/.bin"]

.envrc

@@ -17,13 +17,17 @@ jobs:
           # This makes Actions fetch all Git history so that Changesets can generate changelogs with the correct commits
           fetch-depth: 0
 
+      - name: Install Node with Mise
+        uses: jdx/mise-action@v2
+
+      # Because Mise installs Node, this action mostly just caches node_modules.
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
-          # setup-node knows how to read the `volta.node` field.
-          node-version-file: package.json
+          cache: 'npm'
+
       - name: Install Dependencies
-        run: npm i
+        run: npm ci
 
       - name: Create Release Pull Request / NPM Publish
         uses: changesets/action@v1

.github/workflows/release-pr.yml

@@ -30,9 +30,6 @@ node_modules/
 # Local Netlify folder
 .netlify
 
-# Volta binaries (when using direnv/.envrc)
-.volta
-
 # Generated by the smoke test.
 smoke-test/generated
 
@@ -41,3 +38,6 @@ packages/server/src/generated/packageVersion.ts
 
 # Lets you add more env vars.
 .env
+
+# Symlinks written by the Mise VSCode extension.
+.vscode/mise-tools

.gitignore

@@ -6,5 +6,10 @@
   "files.trimTrailingWhitespace": true,
   "files.insertFinalNewline": true,
   "typescript.tsdk": "./node_modules/typescript/lib",
-  "typescript.enablePromptUseWorkspaceTsdk": true
+  "typescript.enablePromptUseWorkspaceTsdk": true,
+  "mise.configureExtensionsUseSymLinks": true,
+  "python.defaultInterpreterPath": "${workspaceFolder}/.vscode/mise-tools/python",
+  "debug.javascript.defaultRuntimeExecutable": {
+    "pwa-node": "${workspaceFolder}/.vscode/mise-tools/node"
+  },
 }

.vscode/settings.json

@@ -8,7 +8,7 @@ To start development, simply run `npm install` (`npm i` for short). This will in
 
 To run Typescript in watch mode, run `npm run watch`.
 
-If you have [Volta](https://docs.volta.sh/guide/getting-started) installed, your Node and NPM versions will be configured automatically for you.
+If you have [Mise](https://mise.jdx.dev/) installed, your Node and NPM versions will be configured automatically for you.
 
 ## Testing
 

DEVELOPMENT.md

@@ -104,9 +104,5 @@
     "projects": [
       "<rootDir>/packages/*/jest.config.js"
     ]
-  },
-  "volta": {
-    "node": "22.15.0",
-    "npm": "9.9.4"
   }
 }

package.json

@@ -35,8 +35,5 @@
   "homepage": "https://github.com/apollographql/apollo-server#readme",
   "peerDependencies": {
     "graphql": "14.x || 15.x || 16.x"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/cache-control-types/package.json

@@ -33,8 +33,5 @@
   },
   "peerDependencies": {
     "graphql": "14.x || 15.x || 16.x"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/gateway-interface/package.json

@@ -44,8 +44,5 @@
     "@jest/globals": "28.x || 29.x",
     "graphql": "^16.6.0",
     "jest": "28.x || 29.x"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/integration-testsuite/package.json

@@ -38,8 +38,5 @@
   "peerDependencies": {
     "@apollo/server": "^4.0.1",
     "graphql": "^16.6.0"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/plugin-response-cache/package.json

@@ -160,8 +160,5 @@
   },
   "peerDependencies": {
     "graphql": "^16.6.0"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/server/package.json

@@ -45,8 +45,5 @@
   "//": "Don't caret this, we want to be explicit about the version of our fork of protobufjs and update it intentionally if we need to.",
   "dependencies": {
     "@apollo/protobufjs": "1.2.7"
-  },
-  "volta": {
-    "extends": "../../package.json"
   }
 }

packages/usage-reporting-protobuf/package.json

@@ -9,7 +9,7 @@
   // It's nice to be able to see PRs for everything in the Dependency Dashboard.
   prCreation: "immediate",
   // Disable circleci manager; see apollographql/federation's renovate file for details.
-  enabledManagers: ["npm"],
+  enabledManagers: ["npm", "mise"],
   dependencyDashboard: true,
   // It seems like a nice idea to let Renovate use GitHub's native "automerge" since PRs
   // can get merged between Renovate runs. The downsides are:

renovate.json5

@@ -1,7 +1,4 @@
 {
   "type": "module",
-  "module": "./dist/smoke-test.js",
-  "volta": {
-    "extends": "../../package.json"
-  }
+  "module": "./dist/smoke-test.js"
 }

smoke-test/nodenext/package.json

@@ -9,8 +9,5 @@
     "@rollup/plugin-node-resolve": "16.0.1",
     "@types/make-fetch-happen": "10.0.4",
     "rollup": "3.29.5"
-  },
-  "volta": {
-    "extends": "../package.json"
   }
 }