Yêu cầu phần cứng và môi trường tối thiểu
Turso CLI và SQLite là các công cụ nhẹ, nhưng để đảm bảo hiệu suất khi chạy các lệnh query hoặc build container liên quan, hệ thống cần đáp ứng các thông số cơ bản sau.
CPU tối thiểu: 2 nhân (vì các tác vụ đồng bộ hoặc build có thể chiếm 100% 1 nhân).
RAM tối thiểu: 2GB (SQLite thường dùng RAM để cache, Turso CLI cần bộ nhớ để xử lý JSON response).
Disk: 10GB trống (chủ yếu cho cache của Docker và các file log).
Hệ điều hành: Ubuntu 24.04 LTS (Noble Numbat) với kernel version 6.8 trở lên.
Để kiểm tra cấu hình máy đang dùng, thực hiện lệnh sau:
cat /etc/os-release && lscpu && free -h
Kết quả mong đợi: Dòng đầu tiên hiển thị "VERSION_ID="24.04", số nhân CPU >= 2, và tổng RAM (total) >= 2.0G.
Cập nhật hệ thống Ubuntu 24.04
Trước khi cài đặt bất kỳ công cụ nào, cần đảm bảo hệ thống gói phần mềm (package repository) được đồng bộ hóa mới nhất để tránh xung đột thư viện.
Thực hiện lệnh cập nhật danh sách gói và nâng cấp các gói hiện có lên phiên bản mới nhất.
sudo apt update && sudo apt upgrade -y
Kết quả mong đợi: Terminal hiển thị thông báo "Need to get 0 B of archives" (nếu đã mới nhất) hoặc tiến trình download các bản vá, sau đó kết thúc bằng dòng "Processing triggers for...". Không có lỗi "E: Unable to locate package".
Cài đặt công cụ cốt lõi: Curl, Git và Docker
Turso CLI được tải về qua internet (cần curl), quản lý mã nguồn cần git, và nếu muốn chạy local SQLite trong container để test thì cần Docker.
Bước 1: Cài đặt curl và git từ kho mặc định của Ubuntu.
sudo apt install -y curl git
Kết quả mong đợi: Hệ thống hiển thị danh sách các gói sẽ được cài đặt, sau khi nhấn xác nhận (hoặc tự động do -y), các gói được cài đặt thành công.
Bước 2: Cài đặt Docker Engine trên Ubuntu 24.04 theo chuẩn của Docker Inc để đảm bảo tương thích tốt nhất.
Trước tiên, cần cập nhật các gói hệ thống liên quan đến Docker và cài đặt các dependency cần thiết.
sudo apt install -y ca-certificates curl gnupg lsb-release
Kết quả mong đợi: Các gói ca-certificates, curl, gnupg, lsb-release được cài đặt xong.
Tiếp theo, thêm repository GPG key chính thức của Docker vào hệ thống.
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Kết quả mong đợi: Không có output lỗi, file keyring được tạo tại /usr/share/keyrings/.
Thiết lập repository Docker cho Ubuntu 24.04 (noble).
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Kết quả mong đợi: File docker.list được tạo tại /etc/apt/sources.list.d/.
Cập nhật lại danh sách gói và cài đặt Docker Engine cùng các công cụ hỗ trợ (containerd.io, docker-compose-plugin).
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Kết quả mong đợi: Docker Engine, CLI và containerd được cài đặt thành công.
Bước 3: Kích hoạt và cấu hình Docker chạy tự động khi khởi động máy.
sudo systemctl enable --now docker
Kết quả mong đợi: Docker service đang chạy (active) và được enable để khởi động tự động.
Để kiểm tra Docker đã hoạt động chưa, chạy lệnh test.
docker run --rm hello-world
Kết quả mong đợi: Terminal hiển thị thông báo "Hello from Docker!" và các dòng hướng dẫn về cách Docker hoạt động, kết thúc bằng "Your environment is ready to build and run containers!".
Tạo tài khoản Turso và lấy API Token
Turso yêu cầu xác thực thông qua API Token để thực hiện các lệnh tạo database và quản lý branch. Bạn cần tạo tài khoản trên web trước khi cấu hình CLI.
Bước 1: Truy cập https://turso.tech và đăng ký tài khoản mới hoặc đăng nhập.
Bước 2: Sau khi đăng nhập, vào mục "Profile" hoặc "Settings" trong giao diện web Turso.
Bước 3: Tìm phần "API Tokens" và nhấn nút "Create new token".
Bước 4: Đặt tên cho token (ví dụ: "ubuntu2404-dev") và chọn quyền (scope) là "Read/Write" để có thể tạo database và sửa đổi dữ liệu.
Bước 5: Sao chép chuỗi token dài (bắt đầu bằng "turso_...") ra một nơi an toàn. Token này chỉ hiện một lần.
Bước 6: Lưu token vào biến môi trường (Environment Variable) trên máy Ubuntu để không phải gõ lại mỗi lần chạy lệnh.
Đầu tiên, mở file cấu hình profile của user hiện tại.
echo 'export TURSO_TOKEN="YOUR_ACTUAL_TOKEN_HERE"' >> ~/.bashrc
Thay thế "YOUR_ACTUAL_TOKEN_HERE" bằng chuỗi token bạn đã copy từ bước 5.
Kết quả mong đợi: Dòng lệnh được thêm vào cuối file ~/.bashrc.
Để biến môi trường có hiệu lực ngay lập tức mà không cần logout/login lại, thực hiện lệnh source.
source ~/.bashrc
Kết quả mong đợi: Không có output lỗi.
Bước 7: Verify token đã được lưu đúng chưa.
echo $TURSO_TOKEN
Kết quả mong đợi: Terminal in ra chuỗi token dài, khớp với chuỗi bạn đã tạo trên web.
Verify toàn bộ môi trường
Thực hiện một lần kiểm tra tổng hợp để đảm bảo Ubuntu 24.04 đã sẵn sàng cho các phần tiếp theo của series.
echo "OS: $(cat /etc/os-release | grep PRETTY_NAME)"; echo "Docker: $(docker --version)"; echo "Curl: $(curl --version | head -n1)"; echo "Git: $(git --version)"; echo "Turso Token: $(echo $TURSO_TOKEN | cut -c1-20)..."
Kết quả mong đợi:
- Dòng OS hiển thị "Ubuntu 24.04 LTS".
- Dòng Docker hiển thị phiên bản Docker Engine (ví dụ: Docker version 27.x.x).
- Dòng Curl và Git hiển thị phiên bản tương ứng.
- Dòng Turso Token hiển thị 20 ký tự đầu của token bạn đã lưu, xác nhận biến môi trường đã được thiết lập đúng.
Đ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 2: Cài đặt và cấu hình Turso CLI trên Linux »