nhile-portal-cli

CLI tạo và quản lý portal cho hệ sinh thái NhiLe Holdings.

Cài đặt

Sử dụng trực tiếp không cài đặt (khuyến nghị)

npx nhile-portal-cli

Cài đặt global

npm install -g nhile-portal-cli

⚠️ Lưu ý tên package

Tên package trên npm là nhile-portal-cli (có chữ portal). KHÔNG dùng các biến thể sai sau — chúng sẽ fail:

• ❌ npx nhile-pipeline-cli — sai tên, không tồn tại trên npm
• ❌ npm install nhile-pipeline-cli — sai tên
• ❌ git clone github.com/vanductan-NLT/nhile-pipeline-cli — repo source private

Tương tự, trước đây CLI có bin alias nhile-pipeline — alias này đã bị xoá từ v1.0.3. Chỉ dùng nhile-portal-cli hoặc create-nhile-portal.

Sử dụng

Tạo portal mới

nhile-portal-cli create
# hoặc chạy trực tiếp (không cần gõ create)
nhile-portal-cli
# hoặc
create-nhile-portal

Lệnh này sẽ chạy wizard tương tác, hỏi lần lượt:

1. Tên portal – định dạng kebab-case (chữ thường, số, dấu gạch ngang)
2. Architecture URL – đường dẫn HTTPS tới file kiến trúc
3. Cluster – chọn nquoc hoặc nedu
4. GitHub OAuth – tự động mở trình duyệt để xác thực tài khoản GitHub

Sau khi xác thực thành công, CLI sẽ:

1. Tạo scaffold trên GitHub (repo cá nhân + fork org).
2. Clone repo cá nhân về ./<portalName>.
3. Thêm remote org trỏ về fork của org (có sẵn PAT để push được ngay).
4. Ghi orgRemoteUrl, portalName, architectureUrl, scaffoldedAt vào nhile.config.json trong thư mục đã clone.

Sau đó chỉ cần:

cd <portalName>
git push origin main              # push lên repo cá nhân
git push org main:incoming        # sync lên org/incoming để IT review

Nếu thư mục ./<portalName> đã tồn tại, CLI sẽ skip phần clone — repo trên GitHub vẫn được tạo bình thường.

Kiểm tra phiên bản template

nhile-portal-cli doctor

Lệnh này so sánh phiên bản template đang dùng trong thư mục hiện tại với phiên bản mới nhất trên server.

• Yêu cầu: file NHILE_TEMPLATE_VERSION phải tồn tại trong thư mục gốc của portal.
• Exit code 0 – template đang dùng phiên bản mới nhất.
• Exit code 1 – có bản cập nhật mới.

Biến môi trường

| Biến | Mô tả | Mặc định | |------|--------|----------| | NHILE_BOT_URL | URL Bot API | https://nhile-pipeline.vercel.app |

Phát triển

# Cài dependencies
npm install

# Build
npm run build

# Build ở chế độ watch
npm run dev

Yêu cầu

• Node.js 18 trở lên
• git có sẵn trong PATH (CLI shell-out để clone + add remote)
• Kết nối internet
• Tài khoản GitHub (cho OAuth device flow)

License

Proprietary © NhiLe Holdings