Skip to content
Cloudflare Docs

Wrangler

2024-09-12

3.77.0

Minor Changes

  • #6674 831f892 Thanks @andyjessop! - feat: Added new [[pipelines]] bindings. This creates a new binding that allows sending events to the specified pipeline.

    Example:

    [[pipelines]] binding = "MY_PIPELINE" pipeline = "my-pipeline"

  • #6668 88c40be Thanks @zebp! - feature: add observability setting to wrangler.toml

    Adds the observability setting which provides your Worker with automatic persistent logs that can be searched, filtered, and queried directly from the Workers dashboard.

  • #6679 2174127 Thanks @jkoe-cf! - feat: adding option to specify a rule within the config to delete (if no rules are specified, all rules get deleted)

  • #6666 4107f57 Thanks @threepointone! - feat: support analytics engine in local/remote dev

    This adds "support" for analytics engine datasets for wrangler dev. Specifically, it simply mocks the AE bindings so that they exist while developing (and don't throw when accessed).

    This does NOT add support in Pages, though we very well could do so in a similar way in a followup.

  • #6640 8527675 Thanks @petebacondarwin! - feat: experimental workers assets can be ignored by adding a .assetsignore file

    This file can be added to the root of the assets directory that is to be uploaded alongside the Worker when using experimental_assets.

    The file follows the .gitignore syntax, and any matching paths will not be included in the upload.

  • #6652 648cfdd Thanks @bthwaites! - feat: Update R2 Get Event Notification response, display, and actions

  • #6625 8dcd456 Thanks @maxwellpeterson! - feature: Add support for placement hints

    Adds the hint field to smart placement configuration. When set, placement hints will be used to decide where smart-placement-enabled Workers are run.

  • #6631 59a0072 Thanks @emily-shen! - feat: Add config options 'html_handling' and 'not_found_handling' to experimental_asset field in wrangler.toml

Patch Changes

  • #6621 6523db2 Thanks @emily-shen! - fix: Validate routes in wrangler dev and wrangler deploy for Workers with assets

    We want wrangler to error if users are trying to deploy a Worker with assets, and routes with a path component.

    All Workers with assets must have either:

    • custom domain routes
    • pattern routes which have no path component (except for the wildcard splat) "some.domain.com/*"

  • #6687 7bbed63 Thanks @GregBrimble! - fix: Fix asset upload count messaging

  • #6628 33cc0ec Thanks @GregBrimble! - chore: Improves messaging when uploading assets

  • #6671 48eeff4 Thanks @jkoe-cf! - fix: Update R2 Create Event Notification response

  • #6618 67711c2 Thanks @GregBrimble! - fix: Switch to multipart/form-data upload format for Workers Assets

    This has proven to be much more reliable.

  • Updated dependencies [3f5b934, 59a0072]:

2024-09-10

3.76.0

Minor Changes

  • #6126 18c105b Thanks @IRCody! - feature: Add 'cloudchamber curl' command

    Adds a cloudchamber curl command which allows easy access to arbitrary cloudchamber API endpoints.

  • #6649 46a91e7 Thanks @andyjessop! - feature: Integrate the Cloudflare Pipelines product into wrangler.

    Cloudflare Pipelines is a product that handles the ingest of event streams into R2. This feature integrates various forms of managing pipelines.

    Usage: wrangler pipelines create <pipeline>: Create a new pipeline wrangler pipelines list: List current pipelines wrangler pipelines show <pipeline>: Show a pipeline configuration wrangler pipelines update <pipeline>: Update a pipeline wrangler pipelines delete <pipeline>: Delete a pipeline

    Examples: wrangler pipelines create my-pipeline --r2 MY_BUCKET --access-key-id "my-key" --secret-access-key "my-secret" wrangler pipelines show my-pipeline wrangler pipelines delete my-pipline

Patch Changes

  • #6612 6471090 Thanks @dario-piotrowicz! - fix: Add hyperdrive binding support in getPlatformProxy

    example:

    # wrangler.toml
[[hyperdrive]]
binding = "MY_HYPERDRIVE"
id = "000000000000000000000000000000000"
localConnectionString = "postgres://user:pass@127.0.0.1:1234/db"

    // index.mjs

import postgres from "postgres";
import { getPlatformProxy } from "wrangler";

const { env, dispose } = await getPlatformProxy();

try {
  const sql = postgres(
    // Note: connectionString points to `postgres://user:pass@127.0.0.1:1234/db` not to the actual hyperdrive
    //       connection string, for more details see the explanation below
    env.MY_HYPERDRIVE.connectionString,
  );
  const results = await sql`SELECT * FROM pg_tables`;
  await sql.end();
} catch (e) {
  console.error(e);
}

await dispose();

    Note: the returned binding values are no-op/passthrough that can be used inside node.js, meaning that besides direct connections via the connect methods, all the other values point to the same db connection specified in the user configuration

  • #6620 ecdfabe Thanks @petebacondarwin! - fix: don't warn about node:async_hooks if nodejs_als is set

    Fixes #6011

  • Updated dependencies [5936282, 6471090]:

2024-09-06

3.75.0

Minor Changes

  • #6603 a197460 Thanks @taylorlee! - feature: log version preview url when previews exist

    The version upload API returns a field indicating whether a preview exists for that version. If a preview exists and workers.dev is enabled, wrangler will now log the full URL on version upload.

    This does not impact wrangler deploy, which only prints the workers.dev route of the latest deployment.

  • #6550 8d1d464 Thanks @Pedr0Rocha! - feature: add RateLimit type generation to the ratelimit unsafe binding.

Patch Changes

  • #6615 21a09e0 Thanks @RamIdeas! - chore: avoid potential double-install of create-cloudflare

    When wrangler init delegates to C3, it did so via npm create cloudflare@2.5.0. C3's v2.5.0 was the first to include auto-update support to avoid npx's potentially stale cache. But this also guaranteed a double install for users who do not have 2.5.0 cached. Now, wrangler delegates via npm create cloudflare@^2.5.0 which should use the latest version cached on the user's system or install and use the latest v2.x.x.

  • #6603 a197460 Thanks @taylorlee! - chore: fix version upload log order

    Previously deploy prints: upload timings deploy timings current version id

    while version upload prints: worker version id upload timings

    This change makes version upload more similar to deploy by printing version id after upload, which also makes more sense, as version ID can only be known after upload has finished.

2024-09-03

3.74.0

Minor Changes

Patch Changes

2024-08-30

3.73.0

Minor Changes

  • #6571 a7e1bfe Thanks @penalosa! - feat: Add deployment http targets to wrangler deploy logs, and add url to pages deploy logs

  • #6497 3bd833c Thanks @WalshyDev! - chore: move wrangler versions ..., wrangler deployments ..., wrangler rollback and wrangler triggers ... out of experimental and open beta. These are now available to use without the --x-versions flag, you can continue to pass this however without issue to keep compatibility with all the usage today.

    A few of the commands had an output that wasn't guarded by --x-versions those have been updated to use the newer output, we have tried to keep compatibility where possible (for example: wrangler rollback will continue to output "Worker Version ID:" so users can continue to grab the ID). If you wish to use the old versions of the commands you can pass the --no-x-versions flag. Note, these will be removed in the future so please work on migrating.

  • #6586 72ea742 Thanks @penalosa! - feat: Inject a 404 response for browser requested favicon.ico files when loading the /__scheduled page for scheduled-only Workers

  • #6497 3bd833c Thanks @WalshyDev! - feat: update wrangler deploy to use the new versions and deployments API. This should have zero user-facing impact but sets up the most used command to deploy Workers to use the new recommended APIs and move away from the old ones. We will still call the old upload path where required (e.g. Durable Object migration or Service Worker format).

Patch Changes

2024-08-27

3.72.3

Patch Changes

2024-08-22

3.72.2

Patch Changes

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal