Redis (Valkey) cho app: cache, session và hàng đợi trên cloud
Để có Redis cho app trên ZoCloud, bạn bấm Thêm → Redis (Valkey) trong project, rồi gắn biến REDIS_URL=${{cache.REDIS_URL}} cho service và deploy lại. Valkey tương thích Redis, nên thư viện Redis quen thuộc (ioredis, redis-py, phpredis…) chạy bình thường cho cache, session, rate limit, pub/sub và hàng đợi: BullMQ, Celery, Laravel queue driver redis đều chạy được.
Bài này giải thích Redis dùng vào việc gì, vì sao ZoCloud chọn Valkey, cách tạo và kết nối, kèm ví dụ Node.js, Python và PHP.
Redis dùng để làm gì trong một app?
Redis (và Valkey) là kho dữ liệu dạng khoá–giá trị nằm trong RAM, trả lời trong khoảng dưới một mili giây. App web thường dùng nó cho:
| Việc | Ví dụ |
|---|---|
| Cache | Lưu kết quả truy vấn nặng, trang sản phẩm, gọi API bên ngoài trong vài phút |
| Session | Lưu phiên đăng nhập để nhiều bản chạy của app dùng chung |
| Rate limit | Đếm số request của một IP hay một tài khoản trong mỗi phút |
| Pub/sub | Phát sự kiện giữa các bản chạy (chat, thông báo realtime, Socket.IO adapter) |
| Hàng đợi | Đẩy việc chậm (gửi e-mail, xử lý ảnh) sang worker chạy nền |
Database chính (PostgreSQL, MySQL) vẫn là nơi lưu dữ liệu thật. Redis là lớp nhanh đứng cạnh, giúp database đỡ tải và app phản hồi nhanh hơn.
Valkey là gì, vì sao không phải Redis?
Năm 2024, Redis đổi giấy phép từ BSD sang các giấy phép hạn chế việc chạy Redis như một dịch vụ cho người khác. Cộng đồng tách nhánh từ phiên bản BSD cuối cùng và đặt tên Valkey, nay do Linux Foundation bảo trợ, giữ giấy phép BSD.
Với lập trình viên, khác biệt gần như không có:
- Cùng giao thức (RESP), cùng lệnh
GET,SET,EXPIRE,INCR,LPUSH,XADD,PUBLISH… - Thư viện Redis kết nối được ngay, không cần đổi code.
valkey-clivàredis-clidùng thay nhau được.
ZoCloud chọn Valkey để chạy dịch vụ cho khách hàng mà không vướng điều khoản giấy phép. Trên portal, loại database này có tên Redis (Valkey).
Tạo Redis (Valkey) trên ZoCloud
- Mở project, trên canvas bấm Thêm → chọn Redis (Valkey) dưới mục Database.
- Nhập Tên, ví dụ
cache(chữ thường, số,-). Tên này dùng trong biến tham chiếu. - Bấm Tạo. Database sẵn sàng sau vài giây; RAM của nó hiện ở đầu trang database.
Từ terminal:
zo db create cache -engine valkey
zo vars set 'REDIS_URL=${{cache.REDIS_URL}}'
zo deploy
Dùng dấu nháy đơn để shell không hiểu ${{…}} là biến của shell. Mỗi Valkey tính là một database trong giới hạn gói (gói Dùng thử có 1 database, Hobby 2, Pro 5, Team 20; xem Thanh toán).
Kết nối từ app
Tab Kết nối của database hiện biến tham chiếu. Thêm vào Biến môi trường của service rồi deploy lại:
REDIS_URL=${{cache.REDIS_URL}}
Các biến có sẵn: REDIS_URL, VALKEY_URL, REDISHOST, REDISPORT, REDISUSER, REDISPASSWORD. Giá trị tự cập nhật nếu database đổi máy chủ hay mật khẩu, nên bạn không chép mật khẩu vào code. Nếu chưa quen biến tham chiếu, xem bài biến môi trường và file .env.
Valkey chạy trong mạng riêng của ZoCloud: chỉ app trong cùng environment kết nối được, và nó không mở ra Internet. Muốn xem dữ liệu, đọc bằng code trong app hoặc tải bản backup .rdb ở tab Sao lưu.
Node.js (ioredis)
import Redis from "ioredis";
const redis = new Redis(process.env.REDIS_URL);
export async function getProduct(id) {
const key = `product:${id}`;
const cached = await redis.get(key);
if (cached) return JSON.parse(cached);
const product = await db.findProduct(id); // truy vấn PostgreSQL
await redis.set(key, JSON.stringify(product), "EX", 300); // giữ 5 phút
return product;
}
Tạo một kết nối khi app khởi động và dùng lại; đừng mở kết nối mới cho mỗi request.
Python (redis-py)
import json, os
import redis
r = redis.Redis.from_url(os.environ["REDIS_URL"], decode_responses=True)
def get_product(pid):
key = f"product:{pid}"
if (cached := r.get(key)) is not None:
return json.loads(cached)
product = load_from_db(pid)
r.set(key, json.dumps(product), ex=300)
return product
Với Django 4 trở lên, dùng backend có sẵn:
CACHES = {
"default": {
"BACKEND": "django.core.cache.backends.redis.RedisCache",
"LOCATION": os.environ["REDIS_URL"],
}
}
SESSION_ENGINE = "django.contrib.sessions.backends.cache"
PHP (Laravel)
Laravel đọc sẵn REDIS_URL trong config/database.php. Đặt các biến:
REDIS_URL=${{cache.REDIS_URL}}
REDIS_CLIENT=phpredis
CACHE_STORE=redis
SESSION_DRIVER=redis
(Bản Laravel cũ dùng CACHE_DRIVER thay cho CACHE_STORE.) Nếu image không có extension phpredis, đặt REDIS_CLIENT=predis và cài predis/predis bằng Composer. Xem thêm bài deploy Laravel PHP.
Cache đúng cách: luôn có TTL
Valkey trên ZoCloud chạy với chính sách không tự xoá khoá khi đầy bộ nhớ. Khi chạm giới hạn RAM, lệnh ghi mới báo lỗi kiểu OOM command not allowed thay vì âm thầm xoá dữ liệu của bạn. Điều này an toàn cho session và hàng đợi, nhưng nghĩa là với cache bạn phải tự giữ gọn:
- Mọi khoá cache đều có thời hạn (
EXhoặcEXPIRE). Khoá không có TTL sẽ nằm mãi. - Đặt tiền tố theo loại dữ liệu (
product:,session:,rl:) để dễ dọn và dễ đếm. - Không cache đối tượng lớn (file, ảnh): file thuộc về object storage S3.
- Xoá cache khi dữ liệu đổi: sau khi cập nhật sản phẩm, gọi
DEL product:<id>. - Theo dõi RAM ở đầu trang database; nếu hay gần đầy, giảm TTL hoặc xem lại thứ đang được cache.
App cũng nên chịu được khi cache lỗi: bắt lỗi khi đọc Valkey và rơi về database, thay vì trả lỗi 500 cho khách.
Session dùng chung giữa nhiều bản chạy
Khi bạn tăng Số bản chạy lên 2 trở lên (nên làm cho production), request của cùng một người có thể rơi vào bản chạy khác nhau. Session lưu trong RAM của từng tiến trình sẽ bị mất; lưu session trong Valkey thì mọi bản chạy đọc chung.
Node.js với Express:
import session from "express-session";
import { RedisStore } from "connect-redis";
import { createClient } from "redis";
const client = createClient({ url: process.env.REDIS_URL });
await client.connect();
app.use(session({
store: new RedisStore({ client, prefix: "session:" }),
secret: process.env.SESSION_SECRET,
resave: false,
saveUninitialized: false,
cookie: { secure: true, maxAge: 7 * 24 * 3600 * 1000 },
}));
app.set("trust proxy", 1);
trust proxy cần thiết vì app đứng sau router HTTPS của ZoCloud; thiếu nó, cookie secure không được gửi. Session cũng tự hết hạn theo maxAge, nên không chiếm RAM mãi.
Hàng đợi: chọn thư viện phù hợp
Valkey trên ZoCloud chạy được script Lua (EVAL, EVALSHA, SCRIPT), nên các thư viện hàng đợi và khoá phổ biến dùng được ngay. Mỗi Valkey chạy trong tiến trình riêng với tài khoản hệ thống riêng và sandbox riêng, nên script của bạn chỉ chạm tới dữ liệu của bạn. Một số lệnh quản trị bị tắt: CONFIG, ACL, DEBUG, MODULE, cùng FUNCTION/FCALL (thư viện hàm lưu trong dữ liệu).
| Thư viện | Trên Valkey của ZoCloud | Ghi chú |
|---|---|---|
| BullMQ / Bull (Node.js) | Chạy được | new Queue("email", { connection: { url: process.env.REDIS_URL } }) |
| Celery (Python), broker Redis | Chạy được | Đặt CELERY_BROKER_URL=${{cache.REDIS_URL}} |
Laravel queue, driver redis |
Chạy được | QUEUE_CONNECTION=redis, REDIS_URL=${{cache.REDIS_URL}} |
Cache::lock của Laravel |
Chạy được | Cache store redis |
| Sidekiq (Ruby) | Chạy được | REDIS_URL |
Valkey chạy với maxmemory-policy noeviction: hết RAM thì lệnh ghi bị từ chối thay vì xoá khoá. Với hàng đợi, đó là điều bạn muốn (việc không bị mất); hãy theo dõi RAM và dọn việc đã xong (BullMQ: removeOnComplete).
Celery với Valkey
# config/celery.py
import os
from celery import Celery
app = Celery("config", broker=os.environ["REDIS_URL"], backend=os.environ["REDIS_URL"])
app.autodiscover_tasks()
Worker là một service riêng từ cùng repo, Loại service là Worker, Lệnh chạy là celery -A config worker --loglevel=info. Cách tạo worker và cron chi tiết ở bài cron job và worker nền.
Hàng đợi đơn giản bằng list (Node.js)
Nếu chỉ cần đẩy việc sang worker mà không muốn thêm thư viện, list của Valkey là đủ:
// web: đẩy việc
await redis.lpush("jobs:email", JSON.stringify({ to, subject }));
// worker: lấy việc, chờ tối đa 5 giây mỗi vòng
while (true) {
const item = await redis.brpop("jobs:email", 5);
if (!item) continue;
const job = JSON.parse(item[1]);
try { await sendEmail(job); }
catch (e) { await redis.lpush("jobs:email:failed", item[1]); }
}
Cần thử lại, hẹn giờ, ưu tiên… thì dùng BullMQ (ở trên), hoặc một hàng đợi trên PostgreSQL như pg-boss nếu muốn dữ liệu việc nằm cùng database có backup. Xem PostgreSQL cloud tại Việt Nam.
Sao lưu và độ bền dữ liệu
Valkey trên ZoCloud ghi dữ liệu xuống đĩa liên tục (append-only file), nên khởi động lại không làm mất session hay hàng đợi. Tab Sao lưu có:
- Backup tự động mỗi đêm, mã hoá, bản chính lưu tại Việt Nam.
- Backup ngay trước khi làm thay đổi lớn.
- Tải về file
.rdbđể mở bằng công cụ Redis trên máy. - Khôi phục luôn vào một database mới, database cũ vẫn chạy.
Dù vậy, hãy coi Valkey là nơi lưu dữ liệu tạm hoặc dựng lại được. Đơn hàng, tài khoản, thanh toán thuộc về PostgreSQL hoặc MySQL (xem MySQL hosting).
Checklist trước khi lên production
- Valkey cùng environment với service, biến
REDIS_URLlà biến tham chiếu. - Mọi khoá cache có TTL, có tiền tố.
- Session lưu trong Valkey nếu chạy từ 2 bản trở lên.
- Hàng đợi dọn việc đã xong (không để RAM đầy).
- App bắt lỗi khi cache không trả lời và rơi về database.
- Theo dõi RAM ở đầu trang database.
Tài liệu đầy đủ về database: Database và App.
Câu hỏi thường gặp
Valkey có dùng được thư viện Redis không?
Được. Valkey nói cùng giao thức với Redis, nên ioredis, node-redis, redis-py, phpredis hay Predis kết nối bằng REDIS_URL như với Redis.
Vì sao ZoCloud dùng Valkey thay cho Redis? Valkey là bản tiếp nối mã nguồn mở của Redis, giữ giấy phép BSD và được Linux Foundation bảo trợ. Nhà cung cấp dịch vụ chạy nó cho khách hàng mà không vướng các điều khoản giấy phép mới của Redis.
BullMQ có chạy trên Valkey của ZoCloud không? Có. Valkey trên ZoCloud chạy được script Lua (EVAL, EVALSHA, SCRIPT) mà BullMQ cần, cũng như Laravel queue driver redis và Cache::lock. Chỉ FUNCTION/FCALL và các lệnh quản trị như CONFIG, ACL bị tắt.
Valkey đầy bộ nhớ thì sao? Valkey trên ZoCloud không tự xoá khoá khi đầy, nên lệnh ghi mới sẽ báo lỗi. Hãy đặt thời hạn (TTL) cho mọi khoá cache và theo dõi RAM ở đầu trang database.