Tổng quan về CLI

ml-cli là giao diện dòng lệnh dành cho httpServer cục bộ của MoreLogin. Nó dịch các đối số CLI thành các yêu cầu HTTP và chuyển tiếp chúng đến các API cục bộ do ứng dụng khách MoreLogin hiển thị.

Nó dành cho ai? Các kỹ sư DevOps, kỹ sư tự động hóa QA và các nhà phát triển thích làm việc trong thiết bị đầu cuối hoặc cần tích hợp MoreLogin vào quy trình CI/CD (chẳng hạn như GitHub Actions, Jenkins hoặc shell script).

Nó có thể làm gì?

• Gọi API cục bộ MoreLogin trực tiếp từ thiết bị đầu cuối mà không cần viết mã yêu cầu HTTP.
• Quản lý môi trường trình duyệt, proxy, điện thoại đám mây và lịch trình từ một giao diện hợp nhất.
• Sử dụng cờ CLI ổn định thay vì xây dựng tải trọng JSON theo cách thủ công.

Bắt đầu như thế nào?

1. Đọc Điều kiện tiên quyết bên dưới.
2. Tải xuống và cài đặt CLI cho nền tảng của bạn.
3. Kiểm tra Bắt đầu nhanh để chạy lệnh đầu tiên của bạn.

Trước khi sử dụng ml-cli, hãy đảm bảo đáp ứng các yêu cầu sau:

• Ứng dụng máy tính để bàn MoreLogin được cài đặt và chạy trên cùng một máy
• Bạn có tài khoản MoreLogin đang hoạt động với thông tin đăng nhập API (ID API + Khóa API)

Tải xuống tệp nhị phân ml-cli mới nhất cho nền tảng của bạn:

1. Tạo thư mục cho CLI, ví dụ C:\Program Files\MoreLogin\:

   New-Item -ItemType Directory -Force -Path "C:\Program Files\MoreLogin"

2. Di chuyển ml-cli.exe đã tải xuống vào thư mục đó.

3. Thêm thư mục vào hệ thống của bạn PATH:

   # Add to the current user's PATH permanently
   $currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
   [Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\MoreLogin", "User")

4. Khởi động lại thiết bị đầu cuối của bạn (hoặc mở một thiết bị mới) để thay đổi có hiệu lực.

5. Xác minh:

   ml-cli --version

1. Làm cho tệp thực thi nhị phân:

   chmod +x ml-cli

2. Di chuyển nó vào một thư mục trong PATH của bạn:

   sudo mv ml-cli /usr/local/bin/

   Nếu /usr/local/bin không tồn tại, hãy tạo nó trước: sudo mkdir -p /usr/local/bin

3. Trên macOS, tệp nhị phân được tải xuống có thể bị Gatekeeper chặn. Xóa thuộc tính cách ly:

   xattr -d com.apple.quarantine /usr/local/bin/ml-cli

4. Xác minh:

   ml-cli --version

1. Làm cho tệp thực thi nhị phân:

   chmod +x ml-cli

2. Di chuyển nó vào một thư mục trong PATH của bạn:

   sudo mv ml-cli /usr/local/bin/

3. Xác minh:

   ml-cli --version

Sau khi cài đặt, hãy xem Bắt đầu nhanh để kết nối với ứng dụng khách MoreLogin và chạy lệnh đầu tiên của bạn.

CLI hiện tại bao gồm các nhóm tài nguyên sau:

• trạng thái dịch vụ và đăng nhập
• quản lý môi trường trình duyệt qua env
• quản lý điện thoại đám mây qua cloudphone
• quản lý nhóm qua group
• quản lý thẻ qua tag
• quản lý proxy qua proxy
• quản lý lịch trình điện thoại đám mây qua schedule

CLI hỗ trợ hai kiểu nhập:

• cờ rõ ràng, chẳng hạn như --env-id hoặc --group-name
• JSON thô qua --json-data

Chúng có thể được kết hợp. Các quy tắc hợp nhất là:

• --json-data cung cấp nội dung yêu cầu cơ sở
• cờ CLI rõ ràng ghi đè các khóa khớp từ --json-data

Điều này hữu ích cho các điểm cuối có nhiều trường hoặc tải trọng lồng nhau trong đó các cờ chuyên dụng sẽ quá nặng.

CLI cần tìm cổng httpServer cục bộ để gửi yêu cầu. Nó kiểm tra theo thứ tự sau:

1. Cờ --port — chuyển cổng một cách rõ ràng trong mỗi cuộc gọi
2. Biến môi trường ML_PORT - đặt một lần mỗi phiên
3. Tự động phát hiện IPC - CLI đọc cổng từ ống IPC cục bộ (không cần cấu hình)

Đường dẫn IPC mặc định:

Nếu bạn thấy lỗi "Không thể phát hiện cổng MoreLogin", hãy kiểm tra:

• Ứng dụng khách máy tính để bàn MoreLogin có đang chạy không?
• Nếu sử dụng --port, số cổng có đúng không?
• Trên Linux / macOS, /tmp/MoreLogin-cli có tồn tại không?

• Bắt đầu nhanh
• Lệnh