Cloudflare gần đây phát hành Upstash Integration cho Cloudflare Workers. Điều này làm cho việc dùng sản phẩm Upstash trên Workers dễ dàng hơn nữa. Trong bài viết này, dùng Upstash Redis integration xây dựng URL shortener serverless.
Bắt Đầu
Các bước xây dựng dự án:
- Thiết lập database Upstash
- Tạo Worker trên Cloudflare
- Tích hợp Cloudflare Workers với Upstash
- Triển khai thuật toán dự án.
- Deploy ứng dụng
Tạo Database
Điều hướng Upstash console, tạo Redis database nhấn nút Create database ở section Redis.

Chỉ như vậy, database sẵn sàng!
Tạo Cloudflare Worker
Dùng Cloudflare CLI tool generate Worker. Quy trình đơn giản. Mở terminal gõ lệnh:
npm create cloudflare@latest
Lệnh này dẫn dắt qua options và config ứng dụng. Cuối cùng yêu cầu đăng nhập Cloudflare. Dưới đây config ví dụ và output:
Đã tạo và deploy ứng dụng bằng một lệnh. Lệnh nên khởi tạo folder kiểu:
/url-shortener
src
└── worker.ts
node_modules
package-lock.json
package.json
tsconfig.json
wrangler.toml
Bật Upstash integration cũng đơn giản như vậy.
Tích Hợp Cloudflare - Upstash
Truy cập Cloudflare Dashboard đăng nhập cùng tài khoản tạo ứng dụng url-shortener. Điều hướng Workers & Pages > Overview sidebar. Tìm ứng dụng url-shortener.

Click ứng dụng đến trang chi tiết, nơi thực hiện tích hợp. Chuyển tab Settings, tiến đến section Integrations. Thấy các Worker integration liệt kê. Tiến hành, nhấn nút Add Integration liên kết Upstash Redis.

Trang Integration, kết nối tài khoản Upstash. Chọn database url-shortener từ dropdown. Hoàn tất nhấn Save button.
Lưu ý: Đừng thay đổi secret names ở bước Configure secrets. Credentials này tự động được nhặt bởi dòng Redis.fromEnv(env) trong code như UPSTASH_REDIS_REST_URL và UPSTASH_REDIS_REST_TOKEN.

Triển Khai URL Shortener
Triển khai khá đơn giản. Hai chức năng:
-
Khi URL gửi qua POST method, key ngẫu nhiên gán cho URL. Key-URL pair lưu Redis để truy xuất. Key append làm path vào Worker URL gửi user format
<YOUR_WORKER_URL>/<KEY>. -
Khi user truy cập Worker URL với key đã thêm làm path, value tương ứng key lấy từ Redis. User redirect đến URL này với response code
307.
Triển khai trong file src/worker.ts. Dưới đây implement cơ bản URL Shortener:
import { Redis } from "@upstash/redis/cloudflare";
export interface Env {
UPSTASH_REDIS_REST_URL: string;
UPSTASH_REDIS_REST_TOKEN: string;
}
export default {
async fetch(
request: Request,
env: Env,
ctx: ExecutionContext,
): Promise<Response> {
const redis = Redis.fromEnv(env);
/* generateRandomKey function trả về key 7 ký tự alphanumeric.
Nếu key trùng tồn tại trong Redis, tạo key mới. */
async function generateRandomKey(): Promise<string> {
const key: string = btoa(
crypto.getRandomValues(new Uint8Array(2)).toString(),
).replaceAll("=", "");
if (await redis.exists(key)) {
return generateRandomKey();
}
return key;
}
/* Nếu request method là POST, field "longUrl" extract từ request body
và key mới sinh cho url này. Key-value pair persist vào Redis. */
if (request.method === "POST") {
const requestUrl = request.url;
const body = await request.text();
const { longUrl } = JSON.parse(body);
const key = await generateRandomKey();
redis.set(key, longUrl);
const responseUrl = requestUrl + key;
return new Response(responseUrl);
}
const slug: string = request.url.split("/").pop() || "";
const url = (await redis.get(slug)) as string;
/* Nếu slug tồn tại trong Redis DB như key, user redirect đến URL trong value.
Nếu slug không tồn tại trong Redis, hoặc không tồn tại, trả về lỗi. */
if (url) {
return Response.redirect(url, 307);
} else {
const errorText = !slug ? "Please provide a slug." : `Slug ${slug} not found. `;
return new Response(errorText, { status: 404 });
}
},
};
Thuật toán sẵn sàng, bước cuối: deploy ứng dụng. Điều hướng folder url-shortener từ terminal, chạy:
npm run deploy
Cloudflare Worker giờ up và running! Test ở application dashboard hoặc qua curl request. Ví dụ request. Thay URL bằng Worker URL bạn, hoặc test với implementation của tôi:
curl -X POST https://url-shortener.fahreddin.workers.dev \
-d '{ "longUrl" : "https://google.com" }'
Click response URL redirect bạn đến https://google.com.
Kết Luận
Cảm ơn bạn đã follow tutorial!
Như bạn khám phá, sự kết hợp serverless functions và sức mạnh Upstash Redis mở ra thế giới khả năng cho dự án. Sự linh hoạt và hiệu quả của cặp đôi này trao quyền tạo giải pháp không chỉ innovative mà còn remarkably responsive.
Nhớ rằng, guide này chỉ khởi đầu. Không giới hạn cách bạn mở rộng và cải tiến dự án.
Nếu có câu hỏi hoặc vấn đề, liên hệ fahreddin@upstash.com.
Happy coding!