Skip to content
This repository has been archived by the owner on Aug 3, 2023. It is now read-only.

v1.6.0-rc.0
Compare
Choose a tag to compare
@ashleygwilliams ashleygwilliams released this 11 Nov 20:26
v1.6.0-rc.0
4353c81

Testing Guide

Thank you so much for offering to test our upcoming release of Wrangler 1.6.0!

This release includes some fun new features, like

Setup

Prerequisites:

To install Wrangler, you will need to have Node.js installed. To install Node.js, we recommend a Node.js version manager:

OSX/Linux: https://github.com/nvm-sh/nvm#install--update-script

Windows: https://github.com/nullivex/nodist#installation

If you already have Wrangler installed, run:

cargo uninstall wrangler
npm i @cloudflare/[email protected] -g

Install the Wrangler release candidate:

Run this command in your terminal:

npm i @cloudflare/[email protected] -g

To test that you have installed the right version run:

wrangler --version

You should see this output:

👷 ✨  wrangler 1.6.0-rc.0

Configure Wrangler (using ✨API Tokens!✨)

Even if you previously had Wrangler installed, you should still do this step in order to test our new API tokens feature. API Tokens are more secure than Global API keys and provide more granular control to your account.

Run this in your terminal:

wrangler config

Wrangler will prompt you to enter an API token, which you can create here. Make sure you select the "Edit Cloudflare Workers" token template, otherwise some operations may not work as expected.

Tasks

We'd like you to test scenarios containing a few tasks each. Please try to use the documentation we've provided. If you find the documentation is incomplete or that you need to ask a question, please note that for us! We'd like the documentation to be as self-serve as possible.

1. Register a subdomain/get your subdomain

Run wrangler subdomain and see if you like the new output - try running wrangler subdomain <name> to register a subdomain (even if you already have) and note the output and if it makes sense.

NOTE: If you are creating a subdomain, your API token will need to also have #organization:edit permissions. You can add this permission to the token you generate via the API token UI.

2. Start a Workers Site from scratch

Beginning with nothing, let's build a Workers Site. Some HTML knowledge may be helpful for testers!

Docs: https://developers.cloudflare.com/workers/sites/start-from-scratch/

Tasks:

  • Preview your site using wrangler preview
  • Publish your site to workers.dev or to your zone using wrangler publish

3. Deploy a worker with a custom webpack build (optional)

If you're already deploying a worker with a custom webpack build, you will need to update your wrangler.toml to point to your configuration. Wrangler will no longer assume that you want to build your worker when the webpack.config.js at the root of your project.

See bugs?

If you run into bugs or think docs can be improved, please file a ticket at https://github.com/cloudflare/wrangler/issues :) Thank you so much for helping us prep our upcoming Wrangler release!

Changes:

  • 4353c81 1.6.0-rc.0
  • 4a23cab Merge pull request #839 from cloudflare/avery/route-66
  • a4bcb4d Change failure back to warn
  • 2f14322 Adds error message for site with non-trailing asterisk
  • d35d6ba Add credential checking logic when auth params are provided in wrangler config (#842)
  • 6a7d66b Remove the fixtures directory (#854)
  • c3deb57 Merge pull request #857 from jaredmcdonald/master
  • 9906791 Merge branch 'master' into master
  • cb5d7f3 Merge pull request #851 from cloudflare/alewis/use-entry-point
  • 46d8894 Merge branch 'master' into alewis/use-entry-point
See More
  • 9f61258 Merge branch 'master' into master
  • b6e6360 Refactor cloudflare-rs cli to be called from http.rs (#841)
  • 553c7dc run-wrangler.js: send error to stderr and exit 1 if child process has an error
  • f2b7cb9 Merge branch 'master' into alewis/use-entry-point
  • 158c280 Merge pull request #853 from cloudflare/avery/cleanup-wranglerjs
  • aa7bb4e Merge branch 'master' into avery/cleanup-wranglerjs
  • ad573cd Merge pull request #847 from cloudflare/avery/require-webpack
  • 8721ba6 DRY up message per Avery's comment
  • eb94d00 refactor: use PathBuf for bucket
  • afdd023 Clean up wranglerjs temp file
  • 4c8a1d9 Make preview test pass
  • 6cba9be Fix webpack tests
  • f70826b 💅: log::info!
  • 7a43fb8 refactor: make scaffold_worker a method on site
  • 83e8f49 Site.entry_point: Option -> Option
  • 0bd86ba Update webpack tests
  • be310df Require webpack_config to build with custom configuration
  • 7b97084 Merge pull request #846 from cloudflare/avery/fix-comment-formatting
  • 412079e Webpack -> webpack
  • e6234e6 Update labels in CONTRIBUTING
  • 49dc0fe Replace sven todo with issue link
  • f5fb490 fix spacing in comment
  • aa52099 remove the from comment
  • c217022 FIXME -> TODO
  • cb23be8 Audit comments
  • 0ccf501 Merge pull request #844 from cloudflare/avery/remove-api-token-msg
  • cb4b078 Merge branch 'master' into avery/remove-api-token-msg
  • 1ff00b6 Merge pull request #816 from cloudflare/avery/mario-beats-browser
  • defdb0c Merge branch 'master' into avery/mario-beats-browser
  • 8f5fda2 Add link to API Token creation
  • 0c937ff Merge pull request #838 from cloudflare/victoria/quickfix
  • ceacb4e Merge branch 'master' into victoria/quickfix
  • 639b7f1 Merge pull request #837 from cloudflare/alewis/warn-node-modules
  • 49a6cdd Add help suggestion on webpack failure
  • 588deb2 Introduce enum for GlobalUser to handle distinct authentication methods (token vs global api key) (#835)
  • b58fc6f Fix link in readme
  • 15db829 Merge branch 'master' into avery/mario-beats-browser
  • 42acc7a Merge pull request #836 from cloudflare/avery/update-npm-authors
  • d4d9a07 Update author of npm package to wrangler@
  • e1e08f6 Add API token support (#471)
  • c56805e Merge pull request #832 from pradovic/fix/test-code-warnings
  • 3950282 Merge branch 'master' into fix/test-code-warnings
  • 2fde3f0 Merge branch 'master' into avery/mario-beats-browser
  • 9106cf8 Switch from --terminal to --headless
  • cd58b34 Merge pull request #830 from cloudflare/avery/fix-generate-help
  • fbdbc7c Merge branch 'master' into avery/mario-beats-browser
  • 2c2c4a8 Merge branch 'master' into avery/fix-generate-help
  • 7e694e8 Merge branch 'master' into fix/test-code-warnings
  • 7a3ae83 Merge pull request #822 from cloudflare/alewis/fix#358
  • 2ba8b93 Merge branch 'master' into fix/test-code-warnings
  • 983fa76 cargo fmt
  • d16788d pub mod in tests to avoid unused code warnings
  • 86b4783 Merge branch 'master' into alewis/fix#358
  • 932b1e9 Merge branch 'master' into avery/fix-generate-help
  • e928e22 Merge pull request #831 from cloudflare/avery/to-each-their-own-directory
  • 017781b Merge branch 'master' into avery/to-each-their-own-directory
  • edc49bc Merge pull request #829 from cloudflare/avery/very-sion
  • 1dbfe5e Merge branch 'master' into avery/very-sion
  • 62c9447 Put each subcommand in its own directory
  • dc949a4 Fix default value for wrangler generate template
  • e32448e Remove --version on subcommands
  • daa873a Merge pull request #823 from cloudflare/victoria/docs-move
  • 9817123 Merge branch 'master' into victoria/docs-move
  • 5669baa Match wasm binding name in webpack to rust default
  • d9ca44c Merge pull request #826 from cloudflare/alewis/refactor-uploads
  • f5a12b5 nit: bail message grammar
  • ea7d020 call display on paths in macros
  • 9a0b908 Fix npm links
  • b40bd23 Fix links and other from alews PR
  • ec507cf Merge pull request #828 from cloudflare/alewis/minimal-readme
  • e4b5a81 retain (truncated) command descriptions, add getting started
  • 462e7c6 rename: remove stutter in build upload form
  • 46b5e9e refactor: remove ands! call build independent of constructing upload form
  • f7ac074 Use PathBuf instead of String for paths in build/publish
  • 6eb1a85 Fix links typo
  • c012365 Delete all docs files
  • fa87c12 remove docs content files and fix links to them and Readme
  • d3ed0ec Merge pull request #813 from pradovic/fix/duplicate-error-routes
  • eb5a527 Merge branch 'master' into fix/duplicate-error-routes
  • 9925cde Merge pull request #817 from cloudflare/avery/enpeem
  • cb3b672 Pull version from package.json
  • 05f340f Don't open the browser when testing wrangler preview
  • 6062adf Add the ability to preview without opening the browser
  • 8e52d3b Add TODO for preview docs
  • e6fd0a4 Merge branch 'fix/duplicate-error-routes' of github.com:pradovic/wrangler into fix/duplicate-error-routes
  • a290779 fix duplicate route error message wording
  • c63228e Merge branch 'master' into fix/duplicate-error-routes
  • bb87333 Merge pull request #811 from cloudflare/we-really-should-automate-this
  • 0fd56bf cargo fmt
  • fab680f handle duplicate route error gracefully
  • 49467bc fix(installer): bump version
  • 073640e Merge pull request #801 from cloudflare/1.5.0

This list of changes was auto generated.

Assets 6
Loading