Website (Beta)

Để Agent xây dựng và phát hành website; việc đưa lên mạng, khôi phục bản trước và xóa đều do người xác nhận.

Website là gì

Website là trang web do Syfo lưu trữ: Agent phụ trách dựng, triển khai và kiểm tra trong kênh, còn bạn quyết định khi nào đưa lên mạng và ai được mở. Trong thanh điều hướng của tổ chức, mục này tên là “Websites”; trên thẻ phê duyệt xuất hiện khi triển khai thì ghi “Hosted App”, cũng là chỉ website.

Phù hợp để làm gì

Trang đích (landing page), website tiếp thị, trang sự kiện
Trang tài liệu, portfolio, blog, trang giới thiệu
Công cụ nội bộ hoặc ứng dụng nhỏ: khi cần lưu dữ liệu, có thể thêm cơ sở dữ liệu đám mây cho website, ví dụ thu thập biểu mẫu, trang quản trị đơn giản

Website có ba mẫu: trang tĩnh, Next.js và website full-stack. Website mới mặc định không có cơ sở dữ liệu. Khi website cần lưu dữ liệu, Agent sẽ hỏi bạn trước có đồng ý bật cơ sở dữ liệu đám mây cho nó không, chứ không tự bật. Cơ sở dữ liệu được tạo sau lần triển khai thành công đầu tiên; sau đó bạn có thể duyệt các bảng, sửa bản ghi, xuất CSV trong thẻ “Database” ở trang chi tiết website.

Phát hành một website

Nêu yêu cầu. Trong kênh, cho Agent biết website dành cho ai, cần những trang và nội dung nào, ai được mở, và có cần lưu dữ liệu không.

@research-assistant làm một trang đăng ký cho sự kiện offline tháng sau: giới thiệu sự kiện, lịch trình, biểu mẫu đăng ký; thông tin đăng ký cần được lưu lại, chỉ người trong tổ chức này xem được.

Xem thử trước. Trong lúc Agent xây dựng và kiểm tra, hãy xem trước bản chạy cục bộ hoặc bản xem trước mà nó đưa ra.
Phê duyệt đưa lên mạng. Khi Agent sẵn sàng triển khai, trong kênh sẽ xuất hiện một thẻ phê duyệt “Deploy Hosted App”, ghi rõ sau khi triển khai ai được mở website. Kiểm tra không có gì sai thì bấm “Approve deployment”; không đồng ý thì từ chối. Khi thẻ hết hạn hoặc bị từ chối, lần triển khai này sẽ bị hủy.
Kiểm tra bản trên mạng. Sau khi triển khai thành công, thẻ sẽ hiện “Open website” và “View site details”. Mở địa chỉ trên mạng, kiểm tra điều hướng, bố cục trên điện thoại, tài nguyên hình ảnh và trang 404.

Đưa lên mạng cần Owner của website hoặc quản trị viên tổ chức phê duyệt. Hướng dẫn chung về thẻ phê duyệt xem tại Phê duyệt.

Tìm website ở đâu

Bấm “Websites” trong thanh điều hướng của tổ chức để xem các website bạn sở hữu, tham gia hoặc được chia sẻ, và lọc theo “Owned”, “Developing”, “Shared with me”. Mở một website sẽ có các thẻ sau:

“Basic info”: bản xem trước, địa chỉ trên mạng, phiên bản hiện tại
“Deployments”: trạng thái, nhật ký của từng lần triển khai và lối vào khôi phục bản trước (rollback)
“Database”: chỉ có ở website có cơ sở dữ liệu
“Billing”: credit mà website này đã tiêu hao
“Settings”: phạm vi truy cập, tên miền, quyền thành viên, biến môi trường

Vai trò trên website

Vai trò	Làm được gì
Owner	Toàn quyền: xác nhận triển khai, khôi phục bản trước và xóa; quản lý phạm vi truy cập và thành viên; chịu chi phí của website này
Quản trị viên tổ chức	Như Owner, có thể triển khai, khôi phục bản trước, xóa, và quản lý phạm vi truy cập cùng nhà phát triển
Developer	Phát triển và bảo trì website, không được triển khai, khôi phục bản trước hay xóa. Agent trong kênh nguồn sẽ tự động trở thành nhà phát triển
Viewer	Thấy website này trong danh sách “Websites”; có mở được hay không vẫn do phạm vi truy cập quyết định

Owner có thể chuyển giao website cho thành viên khác trong phần cài đặt. Bảng đối chiếu quyền đầy đủ xem tại Giải thích về quyền.

Ai được mở

Owner của website hoặc quản trị viên tổ chức có thể đặt ai được mở website qua liên kết trong “Settings → General → Website access scope”. Thiết lập này không ảnh hưởng đến việc ai thấy website trong danh sách. Sau khi thay đổi, cần tối đa 15 phút để có hiệu lực.

“Anyone (no sign-in required)” (bất kỳ ai, không cần đăng nhập)
“Any signed-in Syfo user” (mọi người dùng Syfo đã đăng nhập, kể cả ngoài tổ chức)
“Organization members” (tổ chức này)
“Selected organization members” (một số người trong tổ chức này)
“Only me” (chỉ mình bạn)
“Specific Syfo users” (người dùng Syfo được chỉ định)

Trước khi chia sẻ địa chỉ ra ngoài, hãy xác nhận lại trạng thái triển khai và phạm vi truy cập hiện tại.

Khôi phục bản trước, tạm dừng và xóa

Các thao tác này cũng do Owner của website hoặc quản trị viên tổ chức xác nhận; có thể làm trực tiếp trong trang chi tiết website, hoặc để Agent gửi thẻ phê duyệt:

Khôi phục bản trước (rollback): trong “Deployments”, chọn một phiên bản cũ, bấm “Rollback to this”. Chỉ phiên bản website được khôi phục, cơ sở dữ liệu không khôi phục theo.
Tạm dừng truy cập công khai (“Pause public access”): khách tạm thời không mở được website; phiên bản, cơ sở dữ liệu và tệp đều được giữ, sau này có thể “Resume public access”.
Xóa website (“Delete website”): website bị gỡ khỏi danh sách ngay lập tức; tài nguyên chạy và cơ sở dữ liệu (cùng toàn bộ dữ liệu bên trong) sẽ bị hủy vĩnh viễn ở chế độ nền, còn kho Git được giữ lại. Không thể hoàn tác việc xóa.

Chi phí

Lưu trữ website trừ credit của tổ chức theo mức sử dụng thực tế, gồm hai phần:

Dịch vụ đám mây: số request, lượt thực thi hàm và thời gian tính toán.
Cơ sở dữ liệu: lưu trữ, truy vấn và ghi.

Thẻ “Billing” ở trang chi tiết website hiển thị mức tiêu hao hằng ngày của website này. Tổng hợp ở cấp tổ chức nằm ở “Usage → Websites”.

Khi credit của tổ chức không đủ:

Không thể tạo mới hay triển khai website; lần triển khai sẽ hiện “Insufficient credit”.
Website đang chạy sẽ tiếp tục chạy đến hết thời gian ân hạn, sau đó bị tạm dừng truy cập.
Sau khi nạp tiền, website tự động hoạt động lại, không cần triển khai lại.

Thành viên không quản lý được hóa đơn của tổ chức sẽ thấy “You cannot manage organization billing. Ask an organization Owner or admin to add Credit.”. Nguồn và cách quản lý credit xem tại Mức sử dụng và thanh toán.

Phân công

Bạn không cần thao tác dòng lệnh triển khai. Agent phụ trách xây dựng, kiểm tra, chuẩn bị mã nguồn, theo dõi trạng thái triển khai và kiểm tra bản trên mạng; bạn phụ trách xác nhận đưa lên mạng, phạm vi truy cập và có bật cơ sở dữ liệu hay không.

Khi cần khóa bí mật phía máy chủ, Owner của website hoặc quản trị viên tổ chức cấu hình trong “Settings → Environment variables”; đừng gửi khóa bí mật vào kênh.