[wrangler] add validation to redirected configs in regards to environments

[dario-piotrowicz]

Fixes #8359

This PR adds the following validation behaviors to wrangler deploy commands, that relate
to redirected configs (i.e. config files specified by .wrangler/deploy/config.json files):

• redirected configs are supposed to be already flattened configurations without any
  environment (i.e. a build tool should generate redirected configs already targeting specific
  environments), so if wrangler encounters a redirected config with some environments defined
  it should error
• given the point above, specifying an environment (--env=my-env) when using redirected
  configs is incorrect, so these environments should be ignored and a warning should be
  presented to the user

---

• Tests
  • TODO (before merge)
  • Tests included
  • Tests not necessary because:
• Wrangler E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  • I don't know
  • Required
  • Not required because:
• Public documentation
  • TODO (before merge)
  • Cloudflare docs PR(s): add note about environments in generated wrangler configuration section cloudflare-docs#21119
  • Documentation not necessary because:
• Wrangler V3 Backport
  • TODO (before merge)
  • Wrangler PR: Backport #8596 to Wrangler v3 #8600
  • Not necessary because:

[changeset-bot]

🦋 Changeset detected

Latest commit: 8cbe58d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
wrangler	Patch
@cloudflare/vitest-pool-workers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

A wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-wrangler-8596

You can reference the automatically updated head of this PR with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/prs/8596/npm-package-wrangler-8596

Or you can use npx with this latest build directly:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-wrangler-8596 dev path/to/script.js

Additional artifacts:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-workers-bindings-extension-8596 -O ./cloudflare-workers-bindings-extension.0.0.0-v9b064942a.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-v9b064942a.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-create-cloudflare-8596 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-kv-asset-handler-8596

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-miniflare-8596

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-pages-shared-8596

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-unenv-preset-8596

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-vite-plugin-8596

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-vitest-pool-workers-8596

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-workers-editor-shared-8596

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-workers-shared-8596

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14058778816/npm-package-cloudflare-workflows-shared-8596

Note that these links will no longer work once the GitHub Actions artifact expires.

---

[email protected] includes the following runtime dependencies:

Package	Constraint	Resolved
miniflare	workspace:*	4.20250320.0
workerd	1.20250321.0	1.20250321.0
workerd --version	1.20250321.0	2025-03-21

Please ensure constraints are pinned, and miniflare/workerd minor versions match.

[dario-piotrowicz]

Pages doesn't really support environments and even shows errors when they are used:

workers-sdk/packages/wrangler/src/pages/deploy.ts

Line 118 in ad774e4

"Pages does not support targeting an environment with the --env flag. Use the --branch flag to target your production or preview branch",

So I don't think that adding tests for this for the pages commands is necessary here 🤔