Deploy Docker image hoặc Dockerfile lên cloud, không cần server
Để chạy một Docker image trên ZoCloud, bạn mở project, bấm Thêm → Từ repo GitHub, chọn thẻ Docker image, nhập tên image (ví dụ ghcr.io/congty/api:1.4) và cổng, rồi bấm Tạo và deploy. ZoCloud kéo image, chạy container trên máy chủ tại Việt Nam, cấp địa chỉ HTTPS ….zocloud.app, kiểm tra sức khoẻ và giữ log. Nếu bạn có Dockerfile thay vì image dựng sẵn, chỉ cần deploy repo hoặc thư mục chứa nó: ZoCloud build bằng chính Dockerfile của bạn.
Bạn không cài Docker, không thuê VPS, không lo vá hệ điều hành. Nếu đang phân vân, đọc nên dùng VPS hay PaaS.
Hai cách chạy container trên ZoCloud
| Cách | Khi nào dùng | Build |
|---|---|---|
| Docker image dựng sẵn | CI của bạn đã build và đẩy image lên Docker Hub, GHCR, Quay hay registry công ty; hoặc chạy phần mềm có image chính thức | Không build, chỉ kéo image |
| Dockerfile trong repo/thư mục | Bạn muốn ZoCloud build từ mã nguồn mỗi lần push hoặc zo deploy |
ZoCloud build trên máy build của nó |
Cách 1: Deploy từ Docker image
- Vào project (hoặc Tạo project), trên canvas bấm Thêm → Từ repo GitHub.
- Trong hộp Deploy từ Git, chọn thẻ Docker image.
- Image: ví dụ
ghcr.io/congty/api:1.4hoặcnginx:stable-alpine. - Cổng: để trống thì lấy từ
EXPOSEcủa image; image không khai báo thì mặc định 8080. - Kiểm tra Tên service, bấm Tạo và deploy.
Lúc deploy, ZoCloud ghim tag về digest của image. Nhờ vậy rollback chạy lại đúng các byte cũ, kể cả khi tag latest đã bị ghi đè. Muốn chạy bản mới của cùng tag (ví dụ CI vừa đẩy :main), bấm Deploy ở tab Deploy: lần deploy mới sẽ phân giải lại tag.
AI agent cũng làm được bước này: công cụ deploy_image của MCP server deploy image công khai. Xem MCP server là gì.
Image riêng tư trên registry cần đăng nhập
- Trên canvas, mở Cài đặt project → Registry.
- Nhập Registry (
docker.io,ghcr.io,registry.congty.vn:5000…), Tên đăng nhập, Mật khẩu hoặc token. - Bấm Thêm thông tin đăng nhập. Mỗi project giữ một thông tin đăng nhập cho mỗi registry; nhập lại là thay thế.
- Tạo service từ image như trên. Nếu registry chưa có thông tin đăng nhập, portal báo "cần thông tin đăng nhập".
Một số điểm về bảo mật:
- Mật khẩu được mã hoá khi lưu và không hiện lại. Máy chủ chạy app chỉ dùng nó lúc kéo image; container không thấy.
- GHCR: dùng personal access token có quyền
read:packages. Docker Hub: dùng access token. Nên tạo tài khoản hoặc token chỉ đọc. - Xoá thông tin đăng nhập thì service đang chạy vẫn chạy, nhưng lần deploy sau sẽ lỗi nếu image không công khai.
Cách 2: Build từ Dockerfile
Đặt Dockerfile ở gốc repo (hoặc Thư mục gốc của service), rồi deploy như mọi app:
curl -fsSL https://app.zocloud.io/install.sh | sh
zo login
zo deploy -to myorg/shop/api
Hoặc Thêm → Từ repo GitHub → thẻ GitHub, chọn repo, Tạo và deploy, và bật Tự deploy khi push.
Khi repo có Dockerfile, ZoCloud build bằng nó thay vì tự sinh. Để chắc chắn, hoặc khi Dockerfile nằm chỗ khác, khai báo trong zocloud.json:
{
"build": {
"builder": "dockerfile",
"dockerfile": "docker/Dockerfile.prod"
},
"deploy": {
"port": 3000,
"health_path": "/health"
}
}
Một vài điều nên biết khi build:
zo deploytôn trọng.dockerignore(cùng.gitignore,.zocloudignore) và không gửi file.env*.- Cache build của từng service được giữ lại giữa các lần build. Dockerfile dùng được
RUN --mount=type=cache,target=/root/.npm …; không hỗ trợ--mountkiểusecret,ssh, hayfrom=/source=.
Cổng và kiểm tra sức khoẻ
ZoCloud đặt biến PORT cho container. Với image tự viết, cho app nghe 0.0.0.0:$PORT là chắc nhất. Với image có sẵn nghe cổng cố định (nginx nghe 80, nhiều app nghe 3000), nhập đúng cổng đó vào ô Cổng ở tab Cấu hình → Build và chạy.
| Ô | Ý nghĩa |
|---|---|
| Kiểm tra sức khoẻ | Đường dẫn trả mã < 500 khi app sẵn sàng (ví dụ /health); để trống thì chỉ kiểm tra cổng |
| Thời hạn kiểm tra (giây) | Một lần kiểm tra được chờ tối đa bao lâu, 1–30 |
| Thời hạn khởi động (phút) | Bản mới có bao lâu để qua kiểm tra, 1–15; app Java hay app tải model nặng nên tăng |
Bản đang chạy vẫn phục vụ khi bản mới lỗi; traffic chỉ chuyển khi bản mới khoẻ. Lỗi "không có gì nghe trên cổng N" nghĩa là app chưa nghe đúng cổng trong thời hạn khởi động.
Biến môi trường và nối với database
Tab Biến môi trường → Thêm biến hoặc Sửa dạng .env. Biến được mã hoá khi lưu và có hiệu lực từ lần deploy sau. Database, bucket và service khác trong cùng environment được nối bằng biến tham chiếu:
DATABASE_URL=${{pg.DATABASE_URL}}
REDIS_URL=${{cache.REDIS_URL}}
API_INTERNAL=${{api.PRIVATE_URL}}
Bằng CLI (nháy đơn để shell không đụng ${{…}}):
zo vars set 'DATABASE_URL=${{pg.DATABASE_URL}}' LOG_LEVEL=info
Các service gọi nhau qua mạng nội bộ http://<service>.internal, không ra Internet. Container cần nhận kết nối TCP bất kỳ (ví dụ một server game, một broker) thì đổi Loại service sang Riêng tư (TCP): nó có địa chỉ <service>.internal:<cổng> và không có địa chỉ công khai. Xem biến môi trường và file .env.
Volume: giữ dữ liệu qua các lần deploy
Mỗi lần deploy là một container mới, mọi thứ ghi vào ổ đĩa container sẽ mất. Cần giữ file (upload, SQLite, dữ liệu của phần mềm tự host) thì gắn volume:
- Tab Cấu hình → Volume → Thêm volume.
- Đường dẫn trong container: thư mục image ghi dữ liệu, ví dụ
/datahay/app/storage. - Dung lượng (MB), rồi deploy lại để gắn.
Volume được sao lưu tự động mỗi đêm, thêm các bản dày mỗi vài phút, và có nút Sao lưu ngay. Đổi dung lượng chỉ tăng, không giảm. Service có volume chạy 1 bản và bản cũ dừng trước khi bản mới chạy (gián đoạn vài giây). Nếu chạy database trong container, có thể đặt lệnh chạy trước và sau mỗi lần backup để khoá ghi, nhưng thường nên dùng database được quản lý của ZoCloud.
Với file người dùng tải lên, bucket S3 thường hợp hơn volume vì app scale được nhiều bản: xem object storage S3 tại Việt Nam.
Log, số liệu, scale và rollback
- Tab Log: Output của app,
stderr, Request HTTP (status, method, path, thời gian xử lý), Tường lửa; ô Tìm trong log (Enter) và Theo dõi trực tiếp. - Tab Số liệu: request, lỗi 5xx, độ trễ p95, CPU, RAM, mạng.
- Số bản chạy (0–20) áp dụng ngay; Tự động scale theo CPU thêm bản khi tải tăng (không áp cho service có volume).
zo status # URL, số bản chạy ổn, các deploy gần nhất
zo logs -f # theo dõi log trực tiếp
zo logs -stream http -status 5xx # chỉ request lỗi 5xx
zo scale 2 # chạy 2 bản
zo rollback 7 # quay lại deploy #7, không build lại
Container nên ghi log ra stdout/stderr để log hiện trên portal.
Chạy phần mềm tự host từ image
Nhiều công cụ có image chính thức: n8n, Uptime Kuma, Open WebUI, Flowise… Với những cái phổ biến, Thêm → Từ template tạo sẵn service, database, biến và volume. Xem tự host n8n và tự host Open WebUI, Flowise.
Chi phí
Bạn trả theo gói, bằng ví VND trả trước; giá theo tháng chưa gồm VAT 10%. Gói Dùng thử (0 đ) đủ để chạy thử một image với 512 MB RAM và 0,5 vCPU; Hobby (119.000 đ) có 1 GB RAM, 1 vCPU, 5 service; Pro (499.000 đ) có 4 GB RAM, 2 vCPU, 20 service. Trả theo năm bằng 10 tháng. Chi tiết: hướng dẫn app, zo CLI, thanh toán.
Câu hỏi thường gặp
Deploy Docker image có cần cài Docker hay thuê VPS không?
Không. Bạn chỉ nhập tên image và cổng trên portal, ZoCloud kéo image, chạy container, cấp địa chỉ HTTPS và theo dõi sức khoẻ. Không có server nào để bạn cập nhật hay vá lỗi.
Image nằm trên registry riêng tư thì làm sao?
Thêm thông tin đăng nhập ở Cài đặt project → Registry (tên registry, tên đăng nhập, mật khẩu hoặc token), rồi tạo service từ image như bình thường. Mật khẩu được mã hoá khi lưu và không hiện lại.
Container của tôi nghe cổng 80, có cần sửa không?
Không bắt buộc. Để trống ô Cổng thì ZoCloud lấy cổng từ EXPOSE của image, hoặc bạn nhập 80. Với image tự viết, nên cho app nghe biến PORT.
Dữ liệu trong container có mất khi deploy lại không?
Có, trừ khi bạn gắn volume. Volume giữ dữ liệu qua các lần deploy và được sao lưu tự động, nhưng service có volume chỉ chạy 1 bản.