Triển khai với Zinnector®: liên kết, kiểm tra, đẩy

Khi một dự án chạy cục bộ, bốn lệnh sẽ đưa nó lên trang web trực tiếp trên dịch vụ lưu trữ của Zinn Digital®: đăng nhập, liên kết dự án với một ô lưu trữ, đọc kiểm tra trước chuyến bay và đẩy. Bài viết này hướng dẫn từng lệnh, kết quả hiển thị của chúng và các lệnh bạn sử dụng sau đó — triển khai lại, lịch sử triển khai và nhật ký bản dựng.

Đăng nhập bằng khóa API

Tạo khóa trong bảng điều khiển tại Cài đặt → Khóa API, sau đó:

zinnector login

Khóa được nhập tại dấu nhắc lệnh — khóa này không bao giờ được chấp nhận trên dòng lệnh, do đó khóa không thể bị lưu vào lịch sử shell hoặc danh sách tiến trình. Trong CI, hãy chuyển ống dẫn vào: echo "$ZINN_API_KEY" | zinnector login --profile ci, hoặc đặt ZINNECTOR_TOKEN và bỏ qua hoàn toàn lệnh login. Khóa được xác minh trước khi được lưu trữ và được lưu với chế độ tệp 600. zinnector whoami --scopes hiển thị tổ chức bạn đã đăng nhập và các quyền mà khóa mang theo; khóa hộp cát được dán nhãn là khóa hộp cát.

Liên kết dự án với một ô lưu trữ

zinnector link                                   # chọn một trang web từ danh sách
zinnector link example.com --repo acme/site --branch main

link ghi id của trang web vào zinnector.json và, trừ khi bạn truyền --no-repo, kết nối remote git của dự án với trang web trên nền tảng để thao tác đẩy sẽ triển khai trang web đó. Hãy commit tệp zinnector.json: một đồng nghiệp sao chép kho lưu trữ sau đó có thể triển khai đến cùng một vị trí mà không cần phải hướng dẫn. Tệp này không chứa thông tin bí mật.

Đọc kiểm tra trước chuyến bay

zinnector check

Đây là lệnh mà CLI tồn tại vì nó. Lệnh này so sánh dự án của bạn với ô lưu trữ chuẩn bị được triển khai và in ra mọi điểm không khớp — và mọi so sánh không thể thực hiện được:

• Phiên bản PHP, với khoảng cách phiên bản chính được đánh giá là cao vì nó chắc chắn làm hỏng trang web và khoảng cách phiên bản phụ được đánh giá thấp hơn, bởi vì việc đánh giá mọi thứ là quan trọng sẽ dạy mọi người cách bỏ qua cảnh báo.
• Liệu ô lưu trữ có thể chuyển đổi sang phiên bản bạn đã xây dựng hay không, liệu PHP của ô lưu trữ đã hết vòng đời hay chưa và liệu máy tính đã áp dụng phiên bản đó hay mới chỉ nhận được thông báo.
• Kích thước và số lượng tệp của dự án của bạn so với dung lượng đĩa và không gian inode thực sự còn lại trên ô lưu trữ — một cây WordPress có thể hết tệp trong khi vẫn ở dưới mức giới hạn đĩa của nó.
• Các phiên bản WordPress ở mỗi bên, liệu ô lưu trữ đã hoàn tất việc cung cấp hay chưa và liệu kho lưu trữ đã được kết nối để đẩy lên hay chưa.

Lệnh này cảnh báo; không bao giờ chặn. Mọi phát hiện đều có thể được ghi đè bằng zinnector push --force, bởi vì bạn hiểu rõ về trang web của chính mình hơn là trình kiểm tra. Một phép so sánh không thể thực hiện được sẽ được báo cáo là không xác định, không bao giờ là đạt, và phần tóm tắt luôn cho biết có bao nhiêu mục. Theo mặc định, phiên bản PHP cục bộ là phiên bản được khai báo trong zinnector.json; --probe khởi động thời gian chạy cục bộ và đo lường thay vào đó. --strict cũng sẽ thoát với mã lỗi khác không đối với các giá trị không xác định, đó là điều mà một cổng CI mong muốn.

Đẩy

zinnector push

push chạy kiểm tra trước chuyến bay, đẩy các commit của bạn, kích hoạt quá trình triển khai và theo dõi cho đến khi hoàn thành, in trạng thái cuối cùng và commit đã được triển khai. --dry-run thực hiện mọi thứ ngoại trừ việc triển khai; --no-wait kích hoạt quá trình và thoát; --no-git triển khai bất kỳ nội dung nào nền tảng đã có mà không cần đẩy. Nếu commit được triển khai không phải là commit vừa được đẩy, lệnh sẽ thông báo điều đó.

Khi xảy ra sự cố

zinnector deploys example.com        # lịch sử triển khai — trạng thái, commit, trình kích hoạt, thông điệp
zinnector logs example.com --build   # nhật ký bản dựng của lần triển khai gần đây nhất
zinnector logs example.com --error   # nhật ký lỗi của trang web
zinnector deploy example.com         # triển khai lại nội dung nền tảng đã có
zinnector ai "why is my deploy failing?"

zinnector ai chạy trên nền tảng với tài khoản của chính bạn, do đó công cụ này có thể nhìn thấy lịch sử triển khai và nhật ký tương tự. Từ bên trong một dự án, công cụ này gửi hình dạng của dự án — tên thư mục, phiên bản và id trang web — và không bao giờ gửi nội dung tệp.

Liên quan

• Bắt đầu · Phát triển cục bộ · Tham khảo lệnh · Khắc phục sự cố