Tải và cài đặt Turso CLI trên Ubuntu 24.04
Bước đầu tiên là tải binary file mới nhất của Turso CLI từ kho GitHub releases chính thức. Chúng ta sử dụng lệnh curl để tải file và tar để giải nén, sau đó di chuyển file vào thư mục hệ thống /usr/local/bin để truy cập toàn cục.
Thực hiện các lệnh sau để tải, giải nén và cài đặt phiên bản ổn định nhất (v0.44.0 hoặc cao hơn):
# Tải binary file từ GitHub releases
curl -fsSL https://github.com/tursodatabase/turso/releases/latest/download/turso_linux_x86_64.tar.gz -o turso.tar.gz
# Giải nén file vừa tải
tar -xvf turso.tar.gz
# Di chuyển file turso vào thư mục hệ thống và cấp quyền thực thi
sudo mv turso /usr/local/bin/turso
sudo chmod +x /usr/local/bin/turso
# Xóa file tar.gz để dọn dẹp
rm turso.tar.gz
Kết quả mong đợi: Không có lỗi hiển thị trên terminal. File turso đã nằm trong /usr/local/bin và có thể chạy từ bất kỳ thư mục nào trên hệ thống.
Verify kết quả cài đặt
Chạy lệnh kiểm tra phiên bản để xác nhận CLI đã được cài đặt thành công và liên kết đúng với thư mục hệ thống.
turso --version
Kết quả mong đợi: Hiển thị dòng chữ dạng turso 0.xx.x (commit: ...). Nếu thấy lỗi command not found, hãy kiểm tra lại biến môi trường $PATH hoặc chạy lại bước chmod và mv.
Cấu hình xác thực (Authentication) với Token
Để CLI có thể giao tiếp với dịch vụ Turso Cloud, bạn cần xác thực bằng Access Token. Thay vì chạy lệnh interactive, chúng ta sẽ cấu hình file token thủ công để đảm bảo tính ổn định cho các kịch bản tự động hóa (CI/CD).
Tạo file cấu hình ~/.turso/config
Trước hết, hãy truy cập vào Dashboard của Turso (cloud.turso.tech), vào mục Settings -> Tokens và tạo một token mới (ví dụ: my-turso-token). Sao chép token này.
Tiếp theo, tạo thư mục cấu hình và file config với nội dung chứa token của bạn:
# Tạo thư mục cấu hình ~/.turso nếu chưa tồn tại
mkdir -p ~/.turso
# Tạo và chỉnh sửa file config
nano ~/.turso/config
Sau khi file mở ra trong trình soạn thảo, dán nội dung chính xác như sau (thay thế YOUR_TURSO_ACCESS_TOKEN bằng token thực tế của bạn):
token = "YOUR_TURSO_ACCESS_TOKEN"
Lưu file và thoát (Ctrl+O, Enter, Ctrl+X).
Cấp quyền riêng tư cho file config để tránh bị lộ token:
chmod 600 ~/.turso/config
Kết quả mong đợi: File ~/.turso/config được tạo thành công, quyền truy cập chỉ dành cho chủ sở hữu (owner).
Xác thực lại CLI (Verify Authentication)
Sau khi cấu hình file, hãy chạy lệnh xác thực để CLI đọc token và thiết lập session. Lệnh này sẽ kiểm tra tính hợp lệ của token và hiển thị thông tin tài khoản.
turso auth login
Kết quả mong đợi: CLI sẽ không yêu cầu nhập token mà hiển thị thông báo thành công dạng Logged in as hoặc Authentication successful. Nếu thấy lỗi unauthorized, hãy kiểm tra lại nội dung file ~/.turso/config xem có thiếu dấu ngoặc kép hay sai token không.
Kiểm tra quyền truy cập và danh sách tổ chức
Bước cuối cùng là xác minh CLI có thể truy cập vào các tài nguyên của bạn (Organization) hay không. Điều này chứng minh toàn bộ quy trình cài đặt và cấu hình đã hoàn tất.
Chạy lệnh để liệt kê các tổ chức (Organization) mà tài khoản của bạn đang sở hữu hoặc có quyền truy cập:
turso organization list
Kết quả mong đợi: Hiển thị bảng danh sách các organization với các cột NAME và ID. Nếu bạn mới tạo tài khoản, sẽ hiển thị mặc định tên organization của bạn.
Để chắc chắn 100%, hãy chạy lệnh hiển thị trạng thái hệ thống của CLI:
turso status
Kết quả mong đợi: Hiển thị trạng thái Authenticated cùng với thông tin email người dùng. Nếu thấy Not authenticated, hãy quay lại bước cấu hình file ~/.turso/config.
Điều hướng series:
Mục lục: Series: Triển khai Database Serverless với Turso và SQLite trên Ubuntu 24.04
« Phần 1: Chuẩn bị môi trường và yêu cầu hệ thống trên Ubuntu 24.04
Phần 3: Khởi tạo Database và tạo Branch đầu tiên »