Yêu cầu cấu hình server Ubuntu 24.04 tối thiểu
Đảm bảo phần cứng và hệ điều hành
Để triển khai môi trường Dev/Test cho Neon, bạn cần một máy chủ Ubuntu 24.04 với cấu hình tối thiểu 1 vCPU và 1GB RAM. Neon là dịch vụ Serverless nên phần lớn tải xử lý nằm ở phía đám mây, server Ubuntu của bạn chỉ đóng vai trò làm client để tương tác.
Trước khi bắt đầu, hãy kiểm tra phiên bản hệ điều hành và nâng cấp các gói hệ thống để đảm bảo tính tương thích.
Chạy lệnh cập nhật repository và nâng cấp gói hiện có:
sudo apt update && sudo apt upgrade -y
Kết quả mong đợi: Quá trình cập nhật hoàn tất mà không báo lỗi, phiên bản Ubuntu được xác nhận là 24.04.
Cài đặt các công cụ mạng cơ bản
Bạn cần các công cụ như curl, wget và git để tải xuống các tiện ích và chứng chỉ SSL cần thiết cho kết nối an toàn.
Cài đặt các gói tiện ích cần thiết:
sudo apt install -y curl wget git ca-certificates gnupg
Kết quả mong đợi: Các gói phần mềm được cài đặt thành công, sẵn sàng để thực hiện các bước tải xuống sau này.
Tạo tài khoản miễn phí và Project đầu tiên trên Neon
Đăng ký tài khoản Neon
Truy cập trang web chính thức của Neon tại neon.tech. Nhấn vào nút "Sign up" ở góc phải màn hình. Bạn có thể đăng ký nhanh bằng tài khoản GitHub hoặc Google để tiết kiệm thời gian.
Điền thông tin cá nhân hoặc doanh nghiệp nếu cần. Sau khi đăng ký, hệ thống sẽ chuyển bạn vào Dashboard mặc định.
Kết quả mong đợi: Tài khoản được tạo thành công, bạn thấy giao diện Dashboard với mục "Projects" rỗng hoặc có 1 project mẫu.
Tạo Project và Branch mặc định
Trong Dashboard, nhấn vào nút "New project". Đặt tên project là "dev-test-project" để dễ quản lý. Chọn môi trường là "Free" (Miễn phí) và khu vực (Region) gần với server Ubuntu của bạn nhất, ví dụ: "ap-southeast-1" (Singapore) hoặc "us-east-1" (Ohio) để giảm độ trễ.
Sau khi tạo, Neon sẽ tự động sinh ra một Branch mặc định tên là "main". Đây là nơi chứa dữ liệu chính.
Chuyển đến tab "Connection Details" trong project vừa tạo. Nhấn vào nút "Copy" để sao chép chuỗi kết nối (Connection String). Chuỗi này có dạng: `postgresql://user:password@ep-xxx-xxx-xxx-xxx.us-east-1.aws.neon.tech/dev-test-project?sslmode=require`.
Kết quả mong đợi: Bạn đã có Project "dev-test-project" với Branch "main" và chuỗi kết nối đã được sao chép vào clipboard.
Verify kết quả tài khoản
Để xác nhận tài khoản đã hoạt động, hãy thử truy cập vào trang quản lý trong trình duyệt và đảm bảo bạn có thể thấy thông tin giới hạn (limits) của gói Free, ví dụ: 0.5GB lưu trữ và 1000 compute hours/tháng.
Cài đặt và cấu hình công cụ CLI psql và Neon CLI
Cài đặt PostgreSQL Client (psql)
Để tương tác trực tiếp với cơ sở dữ liệu Neon qua dòng lệnh, bạn cần cài đặt gói `postgresql-client`. Đây là công cụ tiêu chuẩn của PostgreSQL, tương thích hoàn toàn với Neon.
Cài đặt gói psql trên Ubuntu 24.04:
sudo apt install -y postgresql-client
Kết quả mong đợi: Lệnh `psql --version` trả về phiên bản của client (thường là 16.x hoặc 17.x), xác nhận cài đặt thành công.
Cấu hình file .pgpass để tự động hóa mật khẩu
Thay vì nhập mật khẩu mỗi lần chạy lệnh psql, bạn nên cấu hình file `.pgpass` để lưu thông tin xác thực. File này sẽ nằm trong thư mục home của user hiện tại.
Tạo thư mục .postgresql nếu chưa có và tạo file .pgpass:
mkdir -p ~/.postgresql && touch ~/.postgresql/pgpass
Sửa quyền truy cập file .pgpass để chỉ owner mới được đọc (bắt buộc để psql hoạt động):
chmod 600 ~/.postgresql/pgpass
Sử dụng nano hoặc vi để thêm dòng cấu hình vào file. Thay thế `YOUR_HOST`, `YOUR_PORT`, `YOUR_DB`, `YOUR_USER`, `YOUR_PASSWORD` bằng thông tin thực tế từ Connection String bạn đã copy ở phần trước. Lưu ý: Port mặc định của Neon là 5432.
Nội dung file ~/.postgresql/pgpass:
YOUR_HOST:5432:YOUR_DB:YOUR_USER:YOUR_PASSWORD
Kết quả mong đợi: File .pgpass được tạo với quyền 600. Khi chạy psql, bạn không cần nhập mật khẩu nữa.
Kiểm tra kết nối bằng psql
Sử dụng psql để kết nối tới Neon. Thay thế `YOUR_HOST` và `YOUR_DB` bằng thông tin thực tế.
psql -h YOUR_HOST -p 5432 -d YOUR_DB -U YOUR_USER
Trong shell của psql, chạy lệnh SQL đơn giản để kiểm tra:
SELECT version();
Kết quả mong đợi: Bạn thấy thông tin phiên bản PostgreSQL (ví dụ: "PostgreSQL 16.x (Neon) on x86_64-pc-linux-gnu...") và có thể thoát bằng lệnh `\q`.
Cài đặt Neon CLI
Neon CLI là công cụ dòng lệnh chính thức để quản lý project, branch và cấu hình trực tiếp từ server Ubuntu, giúp tự động hóa quy trình.
Cài đặt Neon CLI bằng cách tải xuống binary từ GitHub và đưa vào PATH hệ thống:
curl -fsSL https://neon.tech/install.sh | sudo bash
Hoặc nếu script trên không chạy, hãy tải trực tiếp binary cho Linux (amd64):
curl -L https://github.com/neondatabase/neon-cli/releases/latest/download/neon-cli-linux-amd64 -o /usr/local/bin/neon && chmod +x /usr/local/bin/neon
Kết quả mong đợi: Lệnh `neon --version` trả về phiên bản hiện tại của Neon CLI.
Đăng nhập và liên kết tài khoản với Neon CLI
Để CLI có thể thao tác với project của bạn, bạn cần đăng nhập. Lệnh này sẽ mở trình duyệt hoặc yêu cầu nhập mã xác thực.
Chạy lệnh đăng nhập:
neon login
Neon CLI sẽ in ra một URL và yêu cầu bạn mở trình duyệt để xác thực. Sau khi đăng nhập trên web, nó sẽ tự động đồng bộ token vào local.
Kết quả mong đợi: Thông báo "Logged in successfully" xuất hiện. Bạn có thể chạy `neon project list` để xem danh sách project đã tạo.
Verify kết quả cài đặt công cụ
Chạy lệnh liệt kê project để xác nhận cả psql và Neon CLI đều hoạt động và có quyền truy cập đúng:
neon project list
Kết quả mong đợi: Danh sách hiển thị project "dev-test-project" cùng với trạng thái và branch mặc định "main".
Điều hướng series:
Mục lục: Series: Triển khai Database Serverless với Neon và Ubuntu 24.04
Phần 2: Khám phá kiến trúc Serverless và kết nối cơ sở dữ liệu đầu tiên »