Redis

Kết nối cơ sở dữ liệu Redis của bạn để Tony (Database Engineer) có thể kiểm tra keyspace, phân tích các pattern lệnh và giám sát sức khỏe cơ sở dữ liệu.

Nền tảng được hỗ trợ

Nền tảng	Hỗ trợ
Redis tự host	6.x, 7.x (vanilla và Redis Stack)
Upstash Redis	Tất cả gói
Redis Cloud	Tất cả gói

Điều kiện tiên quyết

Một instance Redis có thể tiếp cận từ CloudThinker qua mạng.
Quyền admin để tạo người dùng ACL (tự host) hoặc người dùng RBAC (Upstash/Redis Cloud).
Connection string REDIS_URL kèm thông tin xác thực.

Thiết lập

Chọn nền tảng Redis của bạn để xem hướng dẫn kết nối cụ thể.

Redis tự host
Upstash Redis
Redis Cloud

Hai hình thức triển khai phổ biến được hỗ trợ:

Vanilla Redis — image tối giản, không có module. Dùng khi bạn chỉ cần các lệnh Redis cơ bản.
Redis Stack — tích hợp RediSearch, RedisJSON, RedisTimeSeries và Bloom. Dùng khi Tony cần các lệnh FT.*, JSON.*, TS.* hoặc BF.*. Vanilla sẽ báo lỗi nhẹ khi gặp các lệnh đó.

Khởi động Redis

Vanilla Redis (không có module):

docker run -d --name redis-min \
  -p 6379:6379 \
  redis:7-alpine \
  redis-server --requirepass <admin-password> --appendonly yes

Mật khẩu admin được đặt qua flag server --requirepass. --appendonly yes bật AOF để dữ liệu bền vững qua các lần khởi động lại.Redis Stack (có module và RedisInsight UI trên cổng 8001):

docker run -d --name redis-stack \
  -p 6379:6379 -p 8001:8001 \
  -e REDIS_ARGS="--requirepass <admin-password>" \
  redis/redis-stack:latest

Xác minh instance:

redis-cli -a <admin-password> ping
# PONG

Tạo người dùng ACL chỉ đọc

Tạo người dùng riêng cho CloudThinker. Username ACL Redis cho phép [A-Za-z0-9_-]; dùng cloudthinker-readonly.

redis-cli -a <admin-password> ACL SETUSER cloudthinker-readonly on \
  '><readonly-password>' \
  '~*' \
  '+@read' '-@write' '-@dangerous' '-@admin'

on — bật người dùng
><readonly-password> — đặt mật khẩu (tiền tố > là cú pháp ACL)
~* — khớp tất cả key; thu hẹp thành ~app:* để phạm vi hóa chặt hơn
+@read -@write -@dangerous -@admin — chỉ đọc; chặn ghi, FLUSHALL/CONFIG/DEBUG/SHUTDOWN và replication
Tùy chọn: thêm -@slow để chặn KEYS, SMEMBERS, HGETALL trên collection lớn

Lưu ACL bền vững qua khởi động lại

Mount file users.acl để ACL tồn tại sau khi container khởi động lại:

user default on ><admin-password> ~* &* +@all
user cloudthinker-readonly on ><readonly-password> ~* +@read -@write -@dangerous -@admin

Khởi động Redis với file được mount:

-v $PWD/users.acl:/data/users.acl

và thêm --aclfile /data/users.acl vào lệnh server.

Xác minh người dùng chỉ đọc

redis-cli -u redis://cloudthinker-readonly:<readonly-password>@localhost:6379 SET foo bar
# (error) NOPERM ... has no permissions to run the 'set' command

redis-cli -u redis://cloudthinker-readonly:<readonly-password>@localhost:6379 GET foo
# works

Cấu hình truy cập mạng

Đảm bảo CloudThinker có thể tiếp cận cơ sở dữ liệu:

Thêm IP CloudThinker vào firewall hoặc security group
Đảm bảo Redis được bind tới interface có thể truy cập (tránh chỉ dùng bind 127.0.0.1)

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Redis và nhập connection string của bạn làm REDIS_URL:

redis://cloudthinker-readonly:<readonly-password>@<your-host>:6379

Dùng rediss:// (lưu ý chữ s thứ hai) nếu triển khai của bạn terminate TLS. Nhấn Connect. CloudThinker hiển thị trạng thái Connected khi thành công.

Tạo cơ sở dữ liệu

Mở Upstash Redis console và nhấn Create Database. Trong modal:

Nhập Database Name
Chọn Primary Region và Cloud Provider
Bật Eviction (khuyến nghị)
Nhấn Next, chọn gói và xác nhận

Sao chép TCP connection URL

Trên trang cơ sở dữ liệu, cuộn xuống phần Connection. Tab mặc định là REST — chuyển sang tab TCP và sao chép URL:

rediss://<username>:<password>@<hash>.upstash.io:<port>

<hash> là duy nhất cho cơ sở dữ liệu của bạn; <port> thường là 6379. Upstash bắt buộc TLS, nên scheme là rediss://.

Tạo người dùng chỉ đọc (tùy chọn)

Upstash hỗ trợ RBAC trong tab RBAC trên trang cơ sở dữ liệu. Kích hoạt RBAC, sau đó tạo tài khoản tên cloudthinker-readonly với quyền chỉ đọc. Mô hình ACL giống như thiết lập tự host — cấp +@read và từ chối -@write, -@dangerous, -@admin.Xem tài liệu Upstash RBAC để biết luồng UI chi tiết.

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Redis và dán URL làm REDIS_URL. Nhấn Connect. CloudThinker hiển thị trạng thái Connected khi thành công.

Tạo cơ sở dữ liệu

Mở trang cơ sở dữ liệu Redis Cloud và nhấn New database. Chọn gói, Database Name, Database Version, Cloud Vendor và Region, sau đó nhấn Create Database.Quay lại trang cơ sở dữ liệu — cơ sở dữ liệu mới xuất hiện trong danh sách.

Sao chép connection URL

Trên thẻ cơ sở dữ liệu, tìm thẻ Connection to database và nhấn Connect. Trong panel bên:

Đóng dropdown mặc định Redis SDK clients
Chọn Redis CLI
Sao chép URL

URL theo định dạng:

redis://<username>:<password>@<hash>.cloud.redislabs.com:<port>

Cổng Redis Cloud thường nằm trong dải 13xxx thay vì 6379.

Tạo role và người dùng chỉ đọc

Mở trang Data Access Control roles:

Nhấn New role và đặt tên cloudthinker-readonly
Đặt ACL Rules thành Read-Only
Chọn các cơ sở dữ liệu mà role này có thể truy cập
Nhấn Save role

Sau đó tạo hoặc gán người dùng gắn với role này và sử dụng thông tin xác thực của người dùng đó trong connection URL.

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Redis và dán URL làm REDIS_URL. Nhấn Connect. CloudThinker hiển thị trạng thái Connected khi thành công.

Chi tiết kết nối

Trường	Mô tả	Ví dụ
REDIS_URL	Redis connection URI bao gồm thông tin xác thực	`redis://cloudthinker-readonly:pass@host:6379`
TLS/SSL	Dùng scheme `rediss://` để bắt buộc TLS	`rediss://` cho Upstash; tùy chọn ở nơi khác
Port	Cổng Redis	`6379` (tự host, Upstash); `13xxx` (Redis Cloud)
Database index	Chỉ số DB logic	`0`

Quyền bắt buộc

Các ACL category khuyến nghị cho người dùng CloudThinker:

Category	Cài đặt	Lý do
`+@read`	Cho phép	Đọc key, chạy `INFO`, `CLIENT LIST`, v.v.
`-@write`	Từ chối	Chặn `SET`, `DEL` và các lệnh thay đổi khác
`-@dangerous`	Từ chối	Chặn `FLUSHALL`, `CONFIG`, `DEBUG`, `SHUTDOWN`, replication
`-@admin`	Từ chối	Chặn các lệnh admin
`-@slow` (tùy chọn)	Từ chối	Chặn `KEYS`, `SMEMBERS`, `HGETALL` trên collection lớn

Phạm vi hóa key (~* cho tất cả key, hoặc ~app:* cho prefix) thu hẹp những gì người dùng CloudThinker có thể truy cập. Bắt đầu với ~* và giới hạn dần khi cần.

Khả năng của agent

Sau khi kết nối, Tony có thể:

Khả năng	Mô tả
Phân tích keyspace	Kiểm tra các pattern key, kích thước và phân phối TTL
Thống kê lệnh	Xem xét latency và throughput lệnh qua `INFO commandstats`
Metrics hiệu suất	Giám sát bộ nhớ, kết nối, eviction và replication lag
Thông tin module	Kiểm tra RediSearch index, RedisJSON document và TimeSeries (chỉ Redis Stack)

Xác minh kết nối

@tony #report run Redis INFO and summarize memory usage, connected clients, and keyspace stats

Ví dụ prompt

@tony #report analyze hot keys and memory distribution on the production Redis instance
@tony #report check memory fragmentation ratio and eviction stats
@tony #report review replication lag on the Redis replica

Khắc phục sự cố

Xác thực thất bại (NOAUTH / WRONGPASS)

Xác minh username và password trong connection URL
Với tự host, xác nhận người dùng được bật bằng ACL WHOAMI và ACL LIST
Với Upstash và Redis Cloud, đảm bảo bạn đã sao chép TCP/Redis CLI URL, không phải REST hoặc SDK URL

NOPERM — không có quyền chạy lệnh

Người dùng chỉ đọc đang hoạt động đúng với các lệnh ghi
Nếu đọc cũng bị chặn, kiểm tra lại ACL rules — +@read phải được cấp

Connection refused hoặc timeout

Xác minh host và port có thể tiếp cận từ CloudThinker
Với tự host, đảm bảo Redis không chỉ bind với 127.0.0.1
Thêm IP CloudThinker vào firewall hoặc allowlist của cloud provider

Lệnh module thất bại (FT.*, JSON.*, TS.*, BF.*)

Vanilla Redis không bao gồm module. Chạy Redis Stack (redis/redis-stack) hoặc bản managed tương đương tích hợp các module cần thiết.

Bảo mật

Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

Dùng rediss:// cho TLS — dùng scheme rediss:// khi triển khai hỗ trợ TLS để mã hóa dữ liệu truyền tải.
Lưu ACL bền vững — dùng aclfile cho các triển khai tự host để người dùng chỉ đọc tồn tại qua các lần khởi động lại.

Tổ chức

Agent

Tự động hóa & Tự chủ

Kết nối

Cài đặt nền tảng

Bảo mật

Thanh toán

Nền tảng được hỗ trợ

Điều kiện tiên quyết

Thiết lập

Chi tiết kết nối

Quyền bắt buộc

Khả năng của agent

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan

Tony Agent

Kết nối MongoDB

​Nền tảng được hỗ trợ

​Điều kiện tiên quyết

​Thiết lập

​Chi tiết kết nối

​Quyền bắt buộc

​Khả năng của agent

​Xác minh kết nối

​Ví dụ prompt

​Khắc phục sự cố

​Bảo mật

​Liên quan

Tony Agent

Kết nối MongoDB

Nền tảng được hỗ trợ

Điều kiện tiên quyết

Thiết lập

Chi tiết kết nối

Quyền bắt buộc

Khả năng của agent

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan