Hướng dẫn sử dụng TDShift PaaS từ A đến Z

TDShift PaaS là nền tảng quản lý project và triển khai Docker Compose qua giao diện web. Hướng dẫn này tổng hợp từ TDShift PaaS Skill và các tài liệu con chính thức của ứng dụng, dành cho người bắt đầu sử dụng TDShift mà không cần tự cấu hình Traefik trên VPS.

Đọc đúng phiên bản: Các thao tác dưới đây dựa trên skill tại ngày 25/10/2026. Giao diện có thể thay đổi khi ứng dụng được cập nhật. Tài liệu nguồn luôn có tại /skill.

1. Tạo tài khoản TDShift

1. Mở app.tdshift.info/register.
2. Nhập email hợp lệ; tạo mật khẩu dài 10–256 ký tự và xác nhận đúng mật khẩu.
3. Gửi form để đăng ký, sau đó vào trang Project của bạn.
4. Đã có tài khoản? Mở Đăng nhập và nhập email, mật khẩu.

2. Tạo Project theo hai bước

1. Tại trang chính nhấn ＋ Tạo project hoặc Bắt đầu project đầu tiên.
2. Nhập Tên project từ 1 đến 60 ký tự rồi nhấn Tạo project.
3. Trang PROJECT SETUP mở ra. Hệ thống sinh mã project-xxxxxxxxxx; lúc này chưa chạy container.
4. Ở mục Loại project, chọn một loại bên dưới rồi nhấn Tiếp tục →.

Loại	Cách hoạt động
PostgreSQL 17	Tạo PostgreSQL + pgAdmin tự động
Odoo 18 Community	Điền sẵn mẫu Compose Odoo + PostgreSQL; cần deploy
WordPress	Điền sẵn mẫu Compose WordPress + MariaDB; cần deploy
Git Compose	Project Compose trống để khai báo image riêng

Mặc định một tài khoản được tạo tối đa 20 project; hệ thống có thể cấu hình lại giới hạn này. Odoo/WordPress là mẫu cho project Compose, không phải giới hạn duy nhất của nền tảng.

3. Deploy Docker Compose từ image có sẵn

1. Mở project loại Compose đang ở trạng thái ready.
2. Ở Docker Compose Editor, dán YAML hoặc chọn Chọn Docker Compose template / Xem tất cả templates ↗.
3. Điền Public web service — tên service xử lý HTTP.
4. Điền Internal HTTP port — cổng HTTP bên trong container.
5. Điền Health path — đường dẫn bắt đầu bằng / và trả mã phản hồi phù hợp.
6. Nhấn Deploy Compose Stack ↗. Khi deploy, project chuyển sang trạng thái updating.
7. Kiểm tra mục Services trong project và thông báo lỗi sau khi deploy hoàn thành.

Lưu ý: Trong luồng này PaaS không tự build Docker image. Mỗi service khai báo image: đã có trên registry. Với ứng dụng tự viết, cần build image chứa sẵn source code qua GitLab CI/CD rồi push lên registry trước khi PaaS pull và chạy.

4. Cấu hình Environment Variables

Ở mục Environment Variables, nhập từng biến theo dạng KEY=value trên một dòng, nhấn Lưu Environment Variables. Ví dụ dùng APP_ENV=production. Các biến mật khẩu/token phải được nhập và lưu qua chức năng quản lý biến môi trường, không commit vào Git.

Muốn giá trị mới có hiệu lực, nhấn Deploy Compose Stack ↗ lại. Đổi biến mật khẩu sau khi database đã khởi tạo không tự đổi mật khẩu thực tế trong database.

5. Dùng image từ GitLab Container Registry

1. Trong repository ứng dụng, tạo Dockerfile và cấu hình GitLab CI/CD để build/push image lên Container Registry.
2. Dùng tag theo commit SHA để truy vết phiên bản; không giả định tag latest phản ánh commit cần deploy.
3. Nếu registry private, vào Private Container Registry trong TDShift.
4. Nhập Registry Host, Username, Access Token có quyền read_registry rồi nhấn Lưu Registry.
5. Cập nhật giá trị image: trong Compose, sau đó deploy.

Đọc chi tiết Build image riêng và GitLab CI/CD.

6. Theo dõi deployment và logs

Tại trang project mở Logs & Diagnostics. Dùng Xem service logs hoặc Logs theo service để phân tích lỗi container. Trạng thái ready một mình không đủ để kết luận website hoạt động; cần kiểm tra service và mở URL thực tế.

7. Kết nối domain riêng

Tính năng domain riêng áp dụng trong chế độ server, cho project Compose đã deploy ít nhất một lần.

1. Ở mục Domain riêng, nhập hostname, không thêm https:// hay đường dẫn.
2. Nhấn Lưu domain & lấy mã xác minh.
3. Tạo DNS A hoặc CNAME cùng bản ghi TXT xác minh đúng như trang TDShift hiển thị; giai đoạn xác minh nên dùng DNS only.
4. Nhấn Xác minh DNS & kích hoạt.
5. Kiểm tra HTTPS và đường dẫn ứng dụng sau khi DNS/chứng chỉ đã sẵn sàng.

Chi tiết về DNS và giới hạn: Skill domain riêng.

8. Backup và Restore dữ liệu

Trong project Compose đang ready, mở Backup & Restore và chọn Tạo backup và tải file .tar.gz. Hệ thống sẽ dừng container trong lúc backup để sao lưu dữ liệu các Docker named volumes. Cất file ở nơi bảo mật.

Restore là thao tác ghi đè dữ liệu hiện tại: chọn file backup dưới 1 GiB, nhập đúng mã project-xxxxxxxxxx, bấm Restore dữ liệu. File phải thuộc chính project đó và có danh sách volume phù hợp; không hỗ trợ restore chéo project. Cần có phương án backup hiện trạng trước restore.

Đọc thêm Skill Backup & Restore hoặc hướng dẫn chi tiết.

9. Tạo Personal API Token cho AI

1. Mở Tài khoản.
2. Tại mục API Token cho AI, nhập Tên gợi nhớ (tùy chọn).
3. Nhấn ＋ Tạo token và sao chép ngay. Token chỉ xuất hiện một lần.
4. Cất token vào trình quản lý secrets hoặc biến môi trường an toàn; không đưa token lên Git, link URL hay chat công khai.

Token có thể cho Agent API quản lý project trong phạm vi tài khoản. Để khóa token bị lộ, dùng nút Thu hồi trên trang tài khoản. Tham khảo Agent API.

10. Câu hỏi thường gặp

Chọn Odoo/WordPress là ứng dụng chạy ngay chưa?

Chưa. Theo skill hiện tại, chọn Odoo hoặc WordPress sẽ điền sẵn Compose preset. Người dùng cần kiểm tra cấu hình và bấm deploy.

Có cần mở port Docker công khai không?

Không. PaaS định tuyến web service qua Traefik. Compose không chấp nhận tùy ý khai báo ports, privileged hoặc bind mount đường dẫn host.

Ứng dụng build ở đâu?

Ứng dụng có source riêng cần build image qua CI/CD, ví dụ GitLab, sau đó PaaS chỉ pull image và deploy. Nền tảng không build ứng dụng trong luồng Deploy Compose theo skill hiện tại.

Có thể dùng AI để tạo và deploy project không?

Có Agent API cho project Compose. Người dùng tạo Personal API Token và cấp cho hệ thống AI theo phương thức bí mật, giới hạn quyền phù hợp. AI không được tự gọi deploy khi người dùng chỉ yêu cầu chuẩn bị cấu hình.

Đọc hướng dẫn mới nhất ở đâu?

Trang TDShift Skill và các skill con: Tạo project, Deploy Compose, Backup, Domain.

Truy cập TDShift PaaS để bắt đầu →