Hướng dẫn nhanh
Hướng dẫn này sẽ dẫn dắt bạn qua con đường ngắn nhất từ lúc cài đặt đến khi có một dự án Govard hoạt động ở local.
Thử trước khi có dự án của riêng bạn
govard tryLệnh này tạo một dự án Mage-OS tạm, khởi động nó và in ra URL. Trên máy đã ấm, lần chạy đầu mất vài phút, phần lớn là lượt kéo image đầu tiên và cài Composer. Không có gì được ghi vào thư mục hiện tại, và bản thử được xoá khi bạn thoát, trừ khi bạn truyền --keep.
1. Khởi tạo một dự án
Di chuyển tới thư mục gốc của dự án và chạy:
cd /path/to/your/project
govard initGovard sẽ kiểm tra file composer.json hoặc package.json, nhận diện framework và tạo cấu hình .govard.yml.
Các framework được tự động nhận diện
| Framework | Cách nhận diện |
|---|---|
| Magento 2 | composer.json có magento/product-community-edition, magento/product-enterprise-edition hoặc magento/framework |
| Mage-OS | composer.json có mage-os/product-community-edition hoặc mage-os/project-community-edition |
| Magento 1 / OpenMage | composer.json có magento-hackathon/magento-composer-installer, openmage/magento-lts hoặc colinmollenhour/modman |
| Laravel | Có file artisan + composer.json với laravel/framework |
| Next.js | package.json có dependency next |
| Emdash | Dấu hiệu scaffold Emdash (src/app + config Emdash) |
| Drupal | composer.json có drupal/core hoặc drupal/core-recommended |
| Symfony | Có symfony/framework-bundle |
| Shopware | Có shopware/core |
| CakePHP | Có cakephp/cakephp |
| PrestaShop | config/defines.inc.php hoặc composer.json có prestashop/prestashop |
| WordPress | Có wp-config.php hoặc wp-login.php |
| Django | manage.py ở thư mục gốc |
| Dagster | workspace.yaml hoặc dagster.yaml ở thư mục gốc |
| Custom (Tùy chỉnh) | Chọn stack qua prompt tương tác (govard init --framework custom) |
Ép buộc nhận diện một Framework cụ thể
govard init --framework magento2
govard init --framework customDi chuyển từ các công cụ khác
Nếu bạn đang chuyển từ Warden hoặc DDEV, Govard có thể tự động phát hiện cấu hình và sao chép volume database local của bạn mà không làm mất dữ liệu:
govard init --migrate-from warden
govard init --migrate-from ddev2. Khởi động môi trường
govard env upLệnh này sẽ render một file compose cho từng dự án tại thư mục ~/.govard/compose/ và khởi động stack tương ứng.
Các lệnh phổ biến
govard up --quickstart # Alias của: govard env up
govard env up --pull # Tải (pull) image mới nhất trước khi khởi động
govard env up --fallback-local-build # Tự động build image local nếu pull thất bạiQuy trình khởi động
- Nhận diện ngữ cảnh framework.
- Xác thực cấu hình, Docker, các port và điều kiện tiên quyết.
- Render file compose vào thư mục
~/.govard/compose/. - Khởi động các container ở chế độ chạy ngầm (detached mode).
- Xác minh proxy và host routing.
Các phím tắt gốc (Root Shortcuts)
| Phím tắt | Lệnh tương đương |
|---|---|
govard up | govard env up |
govard down | govard env down |
govard restart | govard env restart |
govard ps | govard env ps |
govard logs | govard env logs |
3. Cấu hình ứng dụng
Dự án Magento 2
Tự động cấu hình kết nối container vào file app/etc/env.php:
govard config autoXem cấu hình hiện tại
govard config get php_version
govard config get stack.services.db4. Đi vào Workspace (Shell)
govard shell- PHP frameworks (Magento, Laravel, v.v.): Mở terminal trong container
phptại/var/www/html - Node-first frameworks (Next.js, Emdash): Mở terminal trong container
webtại/app
5. Truy cập Ứng dụng và Dịch vụ toàn cục
Govard định tuyến các domain dự án qua Caddy proxy dùng chung và cung cấp các dịch vụ tích hợp sẵn cho việc phát triển:
Các URL của dự án
| Mục tiêu | URL | Lệnh |
|---|---|---|
| App URL | https://<project>.test | Mở trực tiếp trên trình duyệt |
| Admin panel | https://<project>.test/admin | govard open admin |
| Kiểm thử Mail (Mailpit) | https://mail.govard.test | govard open mail |
| Quản lý Database (PHPMyAdmin) | https://pma.govard.test | govard open db |
| Quản lý Docker (Portainer) | https://portainer.govard.test | govard open portainer |
Thông tin đăng nhập các Dịch vụ toàn cục
| Dịch vụ | URL | Credentials |
|---|---|---|
| Portainer | https://portainer.govard.test | admin / AdminGovard123$ |
| PHPMyAdmin | https://pma.govard.test | Sử dụng thông tin DB của dự án |
| Mailpit | https://mail.govard.test | Không yêu cầu đăng nhập |
Tài khoản quản trị ứng dụng
Govard tạo cùng một tài khoản admin ở mọi nơi, và bảng URL dự án ở trên mở đúng tài khoản đó:
| Đích | Thông tin đăng nhập |
|---|---|
| Trang quản trị dự án | admin / AdminGovard123$ |
| Portainer | admin / AdminGovard123$ |
Tài khoản được tạo trong lúc chạy govard bootstrap, cho cả cài mới và clone, và banner kết thúc sẽ in ra khi tài khoản thực sự được áp dụng. Ba trường hợp làm thay đổi kết quả:
- Database Magento 2 hoặc Mage-OS clone về thường đã có sẵn user tên
admin. Govard giữ nguyên user đó cùng mật khẩu của server nguồn, banner chỉ in URL quản trị, và output của bootstrap in ra lệnh để đặt lại về thông tin dùng chung. - Dự án đã bootstrap trước khi có thông tin dùng chung này vẫn giữ mật khẩu cũ. Không có bước nào ghi đè database đã tồn tại.
govard bootstrap --no-adminchỉ bỏ qua tài khoản mà Govard tạo cho một bản clone Magento 2 hoặc Mage-OS. Cài mới vẫn tạo tài khoản quasetup:install, còn Magento 1, OpenMage, WordPress và Drupal luôn tạo tài khoản.
Banner in route mặc định của framework (/admin cho Magento, /wp-admin cho WordPress). Magento 2 và Mage-OS tự dò route đã đổi trong database khi bạn mở bằng govard open admin; riêng Magento 1 hoặc OpenMage đã đổi admin route trong app/etc/local.xml thì banner vẫn hiện route mặc định.
Lệnh nhanh (Quick Commands)
# Mở dịch vụ trên trình duyệt
govard open mail # Mailpit
govard open db # PHPMyAdmin
govard open admin # Project admin panel
# Quản lý dịch vụ toàn cục (global services)
govard svc up # Khởi động các dịch vụ toàn cục
govard svc down # Dừng các dịch vụ toàn cục
govard svc ps # Xem trạng thái dịch vụ🔁 Quy trình làm việc hàng ngày
# Bắt đầu làm việc
govard up
# Theo dõi logs
govard logs php -f
# Bật Xdebug
govard debug on
# Vào shell container
govard shell
# Dừng làm việc
govard down🌐 Bootstrap dự án từ Remote (Clone)
Để clone một môi trường có sẵn từ một remote server:
govard bootstrap --clone -e staging --no-pii --no-noiseĐối với việc cài đặt mới hoàn toàn một framework:
govard bootstrap --framework magento2 --fresh --framework-version 2.4.9
govard env up
govard open admin🩺 Khắc phục sự cố bước đầu
govard doctor
govard doctor trust # Sửa lỗi cảnh báo SSL trên trình duyệtNếu trình duyệt của bạn hiển thị cảnh báo HTTPS trust sau khi setup, chạy govard doctor trust để import lại Root CA.
📋 Đọc thêm gì tiếp theo
| Chủ đề | Đường dẫn |
|---|---|
| Danh sách các lệnh CLI | Lệnh CLI |
| Các tùy chọn cấu hình | Cấu hình |
| Ghi chú về từng framework | Frameworks |
| Cấu hình SSL và DNS | SSL và Tên miền |
| Môi trường Remote | Remote & Đồng bộ |
| Ứng dụng Desktop | Ứng dụng Desktop |