Trong bài viết trước, chúng ta đã thảo luận về cách chúng ta có thể sử dụng Redis để lưu trữ trạng thái quota của người dùng trên ứng dụng Next.js full-stack. Việc này cho phép chúng ta cải thiện hiệu suất ứng dụng, vì Redis nói chung nhanh hơn database nhiều.
Upstash Redis đặc biệt là lựa chọn tuyệt vời cho trường hợp sử dụng này, vì nó là cơ sở dữ liệu Redis được quản lý hoàn toàn và truy cập được qua HTTP. Điều này có nghĩa là chúng ta thậm chí có thể sử dụng edge runtimes như Vercel để chạy code của mình gần người dùng với độ trễ tối thiểu.
QStash là gì?
QStash là giải pháp nhắn tin và lịch trình dựa trên HTTP cho serverless và edge runtimes. Nói cách khác, nó cho phép bạn chạy CRON jobs bằng cách gửi yêu cầu HTTP.
CRON jobs là cách tuyệt vời để lên lịch tác vụ chạy tại một thời điểm cụ thể. CRON job này có thể mất bao nhiêu thời gian tùy ý để chạy mà không ảnh hưởng đến hiệu suất ứng dụng hoặc người dùng cuối.
Mục tiêu của CRON job trong bài viết này là đồng bộ hóa trạng thái quota của người dùng từ Redis sang database. Chúng ta sẽ làm cho tác vụ này chạy mỗi giờ.
Tạo endpoint CRON job với QStash
Đây là tóm tắt nhanh của bài viết trước, về cách chúng ta xử lý trạng thái quota của người dùng trong Redis:
// Key stored in Redis. A key is created for each user, and made unique by their ID.
const quotaKey = `user:${userId}:quota`;
// Call the INCR command to increment the value of the key by 1.
const quota = await redis.incr(quotaKey);
// If the value of the key is 1, it means the key has been created.
// We can set an expiration date of 24 hours to this key by using the EXPIRE command.
if (quota === 1) {
await redis.expire(quotaKey, 60 * 60 * 24);
}
Đoạn mã này, chúng ta bây giờ có thể tạo endpoint CRON job sử dụng QStash. Endpoint CRON job của chúng ta sẽ được kích hoạt tại URL /api/cron/update-usage.
Hãy tạo tệp mới cho endpoint Next.js của chúng ta:
touch pages/api/cron/update-usage.ts
Sau đó, chúng ta muốn đảm bảo chỉ QStash mới có thể kích hoạt endpoint này, đây là những gì @upstash/qstash xử lý cho chúng ta. Nếu chúng ta không làm điều này, bất kỳ ai cũng có thể kích hoạt endpoint CRON job, điều này có thể dẫn đến vấn đề bảo mật.
Hãy cài đặt @upstash/qstash:
npm install @upstash/qstash
Chúng ta bây giờ có thể tập trung vào mã của endpoint CRON job.
Đây là tóm tắt nhanh những gì chúng ta sẽ làm:
- Lấy tất cả khóa quota của người dùng từ Redis sử dụng
SCAN(phân trang dựa trên con trỏ hiệu suất cao). - Với mỗi khóa tìm thấy từ
SCAN, tạo mảnguserscác đối tượng chứa ID người dùng và quota của họ. - Tạo transaction cho mỗi user trong mảng
usersđể cập nhật quota của họ trong database. Điều này được thực hiện bằng Prisma. - Xuất hàm endpoint với hàm
verifySignaturetừ@upstash/qstash/nextjsđể đảm bảo chỉ QStash mới có thể kích hoạt endpoint.
Mã endpoint đầy đủ ở đây, tôi đã đảm bảo comment mọi khía cạnh của mã:
// /pages/api/cron/update-usage.ts
import type { NextApiRequest, NextApiResponse } from "next";
import { verifySignature } from "@upstash/qstash/nextjs";
import prisma from "@/lib/prisma";
// Generate an Upstash Redis instance using environment variables.
// Make sure those are defined in your .env file.
const redis = new Redis({
url: process.env.UPSTASH_REDIS_REST_URL!,
token: process.env.UPSTASH_REDIS_REST_TOKEN!,
});
// Required by `@upstash/qstash`.
export const config = {
api: {
bodyParser: false
}
};
// Update the usage of every user by pulling the data from the Redis database into the Prisma database.
async function handler(req: NextApiRequest, res: NextApiResponse) {
// Contains all the keys found during the `SCAN`.
const keys: string[] = [];
// Current position of the cursor, updated after each `SCAN`.
let cursor = 0;
// Execute the cursor-based pagination using the `SCAN` command.
// Redis return `0` when the cursor is at the end of the pagination.
do {
const [nextCursor, newKeys] = await redis.scan(cursor, {
// Match the pattern of the keys we want to find, where `*` is a wildcard.
match: "user:*:quota",
// Limit the number of keys returned by the `SCAN` command.
count: 10,
});
cursor = nextCursor;
keys.push(...newKeys);
} while (cursor !== 0);
// Array of objects containing the user's ID and their quota.
const users: { id: number; quota: number }[] = [];
// Get the usage of each user from Redis based on the keys found.
for (const key of keys) {
// A key should be in the format `user:${id}:quota`. Split the key to get the ID.
const id = key.split(":")[1];
// Get the current quota of the user using the `GET` command.
const quota = await redis.get(`user:${id}:quota`);
users.push({ id: parseInt(id, 10), quota });
}
// Create a transaction for each user to update their quota in the database.
const promises = users.map((user) =>
prisma.user.update({
where: { id: user.id },
data: { quota: user.quota },
}),
);
// Run all transactions.
await Promise.all(promises);
return res.status(200).json({ message: "OK" });
}
// Export the handler with the `verifySignature` function to make sure only
// QStash can authenticate to trigger the CRON job.
export default verifySignature(handler);
Phần khó khăn nhất đã xong!
Thiết lập QStash
Bây giờ trước khi đẩy code, chúng ta cần thiết lập QStash. QStash cung cấp cấp miễn phí hào phóng, chúng ta có thể sử dụng lên đến 500 yêu cầu mỗi ngày.
Đăng nhập vào Upstash Console và nhấp vào tab QStash.
Sau đó, hãy tạo CRON job được lên lịch mới sử dụng Request Builder. Nó rất đơn giản nhờ UI trực quan:

Sau khi nhấp nút Schedule, nếu bạn cuộn xuống, bạn sẽ thấy CRON job của bạn ở phần Scheduled Jobs:

Bước cuối, chúng ta cần thiết lập 2 biến môi trường trong ứng dụng Next.js của chúng ta. Những biến này sẽ được thêm vào nơi ứng dụng Next.js được lưu trữ, trong trường hợp này là Vercel.
Trong phần Request Builder, có 2 biến môi trường sẵn sàng để sao chép:
QSTASH_CURRENT_SIGNING_KEYQSTASH_NEXT_SIGNING_KEY
Chúng cần thiết để xác thực tin nhắn đến. Nếu không, bất kỳ ai cũng có thể gọi endpoint của bạn.

Khi bạn đã có các biến đó, bạn có thể thêm chúng vào dự án Vercel của mình.
Để làm điều này, đi đến dự án Vercel của bạn, nhấp vào Settings và sau đó Environment Variables:

Sau khi thêm 2 biến môi trường, bạn bây giờ có thể đẩy code của mình.
QStash sẽ định kỳ kích hoạt endpoint CRON job và cập nhật usage của mọi người dùng mỗi giờ.
Kết luận
Upstash cung cấp nhiều công cụ cho môi trường serverless. Chúng ta có thể sử dụng QStash và Redis cùng nhau để tạo các ứng dụng hiệu suất cao và có khả năng mở rộng cho nhiều trường hợp sử dụng.
Nếu bạn muốn xem nó hoạt động trực tiếp, cùng hệ thống đã được triển khai trên fastsheet, một công cụ biến spreadsheet của bạn thành API.