Cloudflare Workers

Database Setup

Create a Redis database using Upstash Console or Upstash CLI.

Project Setup

We will use C3 (create-cloudflare-cli) command-line tool to create our application. You can open a new terminal window and run C3 using the prompt below.

npm create cloudflare@latest -- upstash-redis-worker

yarn create cloudflare upstash-redis-worker

pnpm create cloudflare upstash-redis-worker

This will create a new Cloudflare Workers project:

➜  npm create cloudflare@latest -- upstash-redis-worker> npx> create-cloudflare upstash-redis-worker─────────────────────────────────────────────────────────────────────────────────────────────────👋 Welcome to create-cloudflare vX.Y.Z!🧡 Let's get started.📊 Cloudflare collects telemetry about your usage of Create-Cloudflare.Learn more at: https://github.com/cloudflare/workers-sdk/blob/main/packages/create-cloudflare/telemetry.md─────────────────────────────────────────────────────────────────────────────────────────────────╭ Create an application with Cloudflare Step 1 of 3│├ In which directory do you want to create your application?│ dir ./upstash-redis-worker│├ What would you like to start with?│ category Hello World example│├ Which template would you like to use?│ type Worker only│├ Which language do you want to use?│ lang TypeScript│├ Copying template files│ files copied to project directory│├ Updating name in `package.json`│ updated `package.json`│├ Installing dependencies│ installed via `npm install`│╰ Application created ...────────────────────────────────────────────────────────────🎉  SUCCESS  Application created successfully!

We will also install the Upstash Redis SDK to connect to Redis.

npm install @upstash/redis

The Code

Here is a Worker template to configure and test Upstash Redis connection.

import { Redis } from "@upstash/redis/cloudflare";export interface Env {  UPSTASH_REDIS_REST_URL: string;  UPSTASH_REDIS_REST_TOKEN: string;}export default {  async fetch(request, env, ctx): Promise<Response> {    const redis = Redis.fromEnv(env);    const count = await redis.incr("counter");    return new Response(JSON.stringify({ count }));  },} satisfies ExportedHandler<Env>;

import { Redis } from "@upstash/redis/cloudflare";export default {  async fetch(request, env, ctx) {    const redis = Redis.fromEnv(env);    const count = await redis.incr("counter");    return new Response(JSON.stringify({ count }));  },};

Configure Credentials

There are two methods for setting up the credentials for Redis. One for worker level, the other for account level.

Using Cloudflare Secrets (Worker Level Secrets)

This is the common way of creating secrets for your worker, see Workers Secrets

The recommended method is the Wrangler CLI, since secrets added this way persist across deployments. Navigate to Upstash Console, get your Redis credentials and run in your project directory:

npx wrangler secret put UPSTASH_REDIS_REST_URLnpx wrangler secret put UPSTASH_REDIS_REST_TOKEN

Each command prompts you for the secret value.

Alternatively, you can add the secrets from the dashboard:

• Navigate to Upstash Console and get your Redis credentials.

• In Cloudflare Dashboard, Go to Compute (Workers) > Workers & Pages.

• Select your worker and go to Settings > Variables and Secrets.

• Add your Redis credentials as secrets here:

Using Cloudflare Secrets Store (Account Level Secrets)

This method requires a few modifications in the worker code, see Access to Secret on Env Object

import { Redis } from "@upstash/redis/cloudflare";export interface Env {  UPSTASH_REDIS_REST_URL: SecretsStoreSecret;  UPSTASH_REDIS_REST_TOKEN: SecretsStoreSecret;}export default {  async fetch(request, env, ctx): Promise<Response> {    const redis = Redis.fromEnv({      UPSTASH_REDIS_REST_URL: await env.UPSTASH_REDIS_REST_URL.get(),      UPSTASH_REDIS_REST_TOKEN: await env.UPSTASH_REDIS_REST_TOKEN.get(),    });    const count = await redis.incr("counter");    return new Response(JSON.stringify({ count }));  },} satisfies ExportedHandler<Env>;

After doing these modifications, you can deploy the worker to Cloudflare with npx wrangler deploy, and follow the steps below to define the secrets:

• Navigate to Upstash Console and get your Redis credentials.

• In Cloudflare Dashboard, Go to Secrets Store and add Redis credentials as secrets.

• Under Compute (Workers) > Workers & Pages, find your worker and add these secrets as bindings.

Deployment

Deploy your function to Cloudflare with npx wrangler deploy

The endpoint of the function will be provided to you, once the deployment is done.

Testing

Open a different terminal and test the endpoint. Note the destination url is the same that was printed in the previous deploy step.

curl https://<your-worker-name>.<account-name>.workers.dev

The response will be in the format of {"count":20}

In the logs you should see something like this:

$ npx wrangler tail⛅️ wrangler X.Y.Z--------------------Successfully created tail, expires at <expiry-date>Connected to <your-worker-name>, waiting for logs...GET https://<your-worker-name>.<account-name>.workers.dev/ - Ok @ <timestamp>

Repositories

Javascript: https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers

Typescript: https://github.com/upstash/upstash-redis/tree/main/examples/cloudflare-workers-with-typescript