TDShift PaaS giúp triển khai WordPress, Odoo, NestJS, Next.js và các ứng dụng Docker từ image có sẵn. Hướng dẫn được đối chiếu với TDShift PaaS Skill ngày 26/10/2026. Xem Skill để biết thay đổi mới nhất.
1. Đăng ký và tạo project
- Truy cập Đăng ký hoặc Đăng nhập.
- Chọn + Tạo project, đặt tên (1–60 ký tự) rồi chọn PostgreSQL 17, Odoo 18 Community, WordPress hoặc Git Compose.
- Odoo và WordPress tạo project loại
composecó template; vẫn cần bấm deploy. Hệ thống tự cấp mãproject-xxxxxxxxxxvà UUID dự án; không tự đặt hai giá trị này.
2. Chuẩn bị image riêng từ GitLab
Ứng dụng chứa source riêng phải có Dockerfile đưa source, theme, plugin và dependency vào image. GitLab Runner build/push; TDShift chỉ pull và chạy. Không dùng image WordPress/Node/nginx mặc định để thay cho ứng dụng có code riêng. Ưu tiên tag SHA để truy vết/rollback; tag production chỉ nên dùng nếu kiểm soát rõ pipeline.
3. Docker Compose trên PaaS
- Mở project loại Compose ở trạng thái
ready→ Docker Compose Editor. - Dán YAML hoặc chọn Chọn Docker Compose template. Mỗi service phải có
image:. Không dùngbuild:,ports:, bind mount hoặcprivileged. - Chỉ lưu dữ liệu bằng named volumes dạng long syntax:
type: volume,source,target; khai báo volumes ở cấp cao nhất. - Chọn Public web service, Internal HTTP port và Health path (ví dụ
/wp-login.php). Traefik tự cấp URL nên không public port Docker. - Nhấn Deploy Compose Stack ↗. Khi hoàn thành, xem Services trong project và mở URL thật để kiểm tra.
4. Environment Variables và image private
Trong Environment Variables, nhập KEY=value mỗi dòng → Lưu Environment Variables. Trong Private Container Registry, nhập host registry.gitlab.com, username và Deploy Token có quyền read_registry. Thay đổi biến chỉ có hiệu lực sau khi deploy lại. Không lưu mật khẩu hay token trong Git.
5. Tự động build và deploy bằng GitLab CI/CD
- Thêm
.gitlab-ci.ymlvới job build/push image. - Trong Tài khoản → API Token cho AI → + Tạo token; lưu token vào GitLab CI/CD Variables dạng Masked/Protected.
- Trên TDShift, lưu và deploy Compose ít nhất một lần, với đúng image, web service, port, health path và credentials cho registry private.
- Sau khi push image thành công, job CI gọi POST
https://app.tdshift.info/api/v1/projects/<UUID>/deploycùng headerAuthorization: Bearer <TOKEN>. Endpoint/buildlà tên cũ; nên dùng/deploy. - HTTP
202chỉ xác nhận đã nhận lệnh, chưa có nghĩa website đã chạy thành công. Kiểm tra trạng thái project, logs và URL website.
Deployment API có thể nhận JSON {"image":"registry.gitlab.com/group/repo:tag"} để thay image của web service, hoặc thêm "service" để chỉ định service. Nếu không gửi body, PaaS deploy Compose đang lưu. Đọc Skill GitLab CI/CD.
6. Agent API dành cho AI
Base URL https://app.tdshift.info. Dùng Bearer Personal API Token của chủ project. Agent API hỗ trợ GET/POST /api/v1/agent/projects, PUT /api/v1/agent/projects/<UUID>/compose, /env, /registry, /image và POST /api/v1/agent/projects/<UUID>/deploy. Lưu cấu hình không đồng nghĩa đã deploy. Token của tài khoản chỉ truy cập project thuộc chủ token. Xem tham chiếu Agent API.
7. Domain, URL phụ và logs
Để mở thêm HTTP service, dùng URL phụ (tùy chọn) theo hướng dẫn nhiều URL; không dùng ports trong Compose. Với domain riêng, nhập hostname, làm theo bản ghi DNS A/CNAME và TXT xác minh mà dashboard hiển thị. Xem mục Logs & Diagnostics khi deploy lỗi.
8. Backup và Restore
Trong Backup & Restore, chọn Tạo backup và tải file .tar.gz để sao lưu named volumes. Restore ghi đè dữ liệu: chỉ thực hiện khi đã xác minh file backup, mã project và có bản backup an toàn. Theo hướng dẫn Backup/Restore, giới hạn file tải lên 1 GiB.
9. Xử lý lỗi CI/CD
- 401: thiếu hoặc sai token, hoặc token đã bị thu hồi.
- 403: kiểm tra WAF/Cloudflare, reverse proxy và chính sách quyền; không tự kết luận là lỗi token.
- 409: project đang bận hoặc chưa có Compose lưu sẵn; không gửi lặp deploy liên tục.
- 422: image, Compose hoặc service không hợp lệ.
Để biết deploy thành công, ngoài 202 Accepted cần xác nhận project ready, không có lỗi, các service hoạt động và website có thể truy cập.
