Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Cờ toàn cục

Các cờ có sẵn trên mọi lệnh con của aggrega.

--workspace-root <path>

Dùng <path> làm thư mục gốc của workspace, bỏ qua hoàn toàn bước dò tìm. Khi không có cờ này, aggrega dò tìm thư mục gốc bằng cách đi ngược lên từ thư mục hiện tại — hoặc, khi lần đi đó không tìm thấy gì và lệnh chỉ định Release hay tài liệu của nó bằng một đường dẫn tuyệt đối, thì đi ngược lên từ thư mục chứa tệp đó; xem Cấu hình để biết điều gì neo một thư mục gốc, theo thứ tự nào, và những lệnh nào chỉ định một tệp như vậy.

AGGREGA_WORKSPACE_ROOT là biến môi trường tương ứng: khi không có --workspace-root, biến này cung cấp thư mục gốc. Khi được đặt, cờ được ưu tiên.

Thư mục gốc là thư mục gốc ở bất cứ đâu nó được cung cấp, kể cả các máy chủ: một yêu cầu gửi tới aggrega mcp không chỉ định workspace riêng sẽ được trả lời trong thư mục đó, không tìm kiếm gì ở phía trên. Một thư mục gốc không phải là thư mục đang tồn tại — một đường dẫn không trỏ tới gì, hoặc trỏ tới một tệp — sẽ bị từ chối bởi mọi lệnh đọc workspace của nó, trước khi lệnh làm bất cứ việc gì khác; aggrega serve và một listener aggrega mcp từ chối khởi động với thư mục gốc đó, còn aggrega mcp qua đầu vào và đầu ra chuẩn vẫn khởi động bình thường và trả lời mọi lời gọi hoạt động trong workspace đó bằng lời từ chối. Lời từ chối nêu tên nguồn đã cung cấp giá trị, --workspace-root hoặc AGGREGA_WORKSPACE_ROOT, cùng giá trị đúng như đã được cung cấp. Một lệnh không đọc workspace nào, chẳng hạn aggrega version, cũng không đọc thư mục gốc và không bị từ chối vì nó.

Khi không có cả hai và bước dò tìm không neo được gì, thư mục mà lệnh chạy trong đó là thư mục gốc, và một lệnh đọc workspace của nó sẽ thông báo điều này bằng một dòng trên standard error, nêu tên thư mục đó và cờ này; xem Cấu hình, nơi cũng giải thích vì sao không có gì được ghi vào bộ nhớ đệm artifact trong một thư mục như vậy.

Tệp cấu hình toàn cục

--config <path> chỉ định tường minh tệp cấu hình toàn cục cho một lần gọi. Nó được ưu tiên hơn biến môi trường AGGREGA_CONFIG, và biến này lại được ưu tiên hơn vị trí mặc định — và vì cả hai đều chủ ý chỉ định một tệp, một đường dẫn không tồn tại sẽ là một lỗi được báo rõ ràng thay vì một phương án dự phòng âm thầm. Khác với các biến thiết lập AGGREGA_*, không cái nào trong hai cái này ghi đè một thiết lập riêng lẻ; chúng chọn tệp nào được áp dụng. Dù tệp nào được xác định, các tệp cấu hình riêng của dự án vẫn được xếp lớp lên trên nó. Configuration trình bày thứ tự xác định và những gì nên có trong tệp đó.

--config và biến môi trường AGGREGA_CONFIG chọn đích ghi cũng như nguồn đọc: một lệnh chạy với --config <path> đọc cấu hình từ tệp đó và áp dụng thay đổi của nó vào chính tệp đó, nên những gì một lệnh ghi ra là những gì lệnh tiếp theo có cùng dạng gọi sẽ đọc lại.

Các lệnh thay đổi cấu hình chọn tệp để ghi dựa trên bản chất của thiết lập: cấu hình công cụ cho toàn máy (một registry) mặc định ghi vào tệp toàn cục, còn cấu hình tham gia vào quá trình build (một liên kết provider hoặc một gắn kết socket governance/linter/importer) mặc định ghi vào tệp dự án được commit. Truyền --global hoặc --workspace để ghi đè, và lệnh sẽ in ra nơi nó đã ghi.

Để khởi tạo cấu hình toàn cục trên một máy mới — đăng ký một registry và chính sách tin cậy chữ ký của nó để các artifact đã ký được pull và xác minh mà không cần sửa YAML thủ công — hãy chạy aggrega config init. Để xem những gì đang được áp dụng ngay lúc này, và với --origin là lớp nào đã quyết định từng thiết lập, hãy chạy aggrega config show.

--offline

Từ chối mọi truy cập mạng trong lần chạy này.

Ngoại tuyến là một trạng thái của workspace chứ không phải chế độ của một lệnh, và có thể bật nó từ ba nơi: cờ này, AGGREGA_OFFLINE, và khóa offline ở cấp cao nhất trong một tệp cấu hình. Chúng mang cùng một ý nghĩa và tuân theo thứ tự thông thường — cờ thắng biến môi trường, và biến môi trường thắng tệp.

Hướng tắt cũng là việc của cờ này không kém gì hướng bật. --offline=false cho phép truy cập mạng cho một lệnh khi một tệp cấu hình đã commit hoặc một biến đã export đã bật trạng thái này. Điều đó quan trọng khi bạn không có quyền sửa tệp: một dự án có .aggrega-config.yaml chứa offline: true sẽ từ chối việc xuất bản đối với mọi người clone nó, và truyền --offline=false là cách duy nhất không cần commit và không cần biến đã export.

Những gì bị từ chối và những gì không

Ranh giới nằm ở việc công việc cần gì chứ không phải lệnh nào được gõ.

Bị từ chối, vì không thể đúng nếu không truy cập registry:

  • --upgrade, ở bất cứ đâu nó xuất hiện. Nó phân giải lại mọi phụ thuộc và nâng từng phụ thuộc lên phiên bản cao nhất mà registry hiện cung cấp, và “cao nhất hiện có” là một khẳng định về những gì registry đang phục vụ ngay lúc này. Chạy nó trên một cache sẵn có sẽ ghim bất cứ thứ gì tình cờ nằm trong cache trong khi báo rằng đã nâng lên bản mới nhất, điều này còn tệ hơn việc dừng lại.
  • Các lệnh mà bản thân công việc của chúng là một lượt khứ hồi qua mạng: aggrega push, aggrega push-artifact, và aggrega registry update. Các lệnh này báo điều đó trước khi đọc entity của bạn hoặc duyệt các repository của bạn, và thông báo từ chối nêu rõ nơi nào trong ba nơi đã bật trạng thái này, để người không gõ cờ nào biết cần tìm ở đâu.

Không bị từ chối, vì máy có thể đã đáp ứng được:

  • Một lệnh aggrega pull thông thường, và aggrega build --auto-pull. Cả hai đều tôn trọng các ghim đã được ghi lại và chỉ phân giải những gì chưa có ghim, nên một workspace có mọi tham chiếu đều đã nằm trong cache hoặc có mặt trong một catalog catalog_dirs sẽ hoàn tất mà không cần truy cập ra ngoài. Khi một lần chạy như vậy thực sự cần tải một thứ gì đó, nó bị từ chối tại thời điểm đó và được cho biết tham chiếu nào không thể đáp ứng.
  • aggrega build với một lockfile đã đầy đủ, lệnh này đọc toàn bộ closure của nó từ cache. Lần truy cập duy nhất nó có là để sửa chữa: khi bản sao trong kho của một đầu vào bên ngoài đã ghim bị mất, đầu vào đó được tải lại theo digest mà lockfile đã ghi. Dưới trạng thái ngoại tuyến, ngay cả việc đó cũng không có kênh truyền, nên bản sao bị mất sẽ làm dừng bản build, kèm theo việc nêu rõ trạng thái này.
  • Một lần xuất bản --dry-run. Toàn bộ hành vi của nó là báo cáo những gì nó sẽ xuất bản và không gọi gì cả, điều này khiến nó trở thành hình thức xuất bản an toàn khi ngoại tuyến chứ không mâu thuẫn với trạng thái này.

Một máy cách ly mạng giữ bản sao cục bộ của catalog và các artifact của nó chính là trường hợp mà sự phân chia này tồn tại để duy trì hoạt động: một workspace như vậy ở trạng thái ngoại tuyến, và hầu như mọi việc nó làm vẫn có thể được đáp ứng.

Thứ tự ưu tiên cấu hình

Một cờ thắng mọi thứ: thắng biến môi trường, thắng các tệp cấu hình và thắng giá trị mặc định tích hợp sẵn. Cấu hình trình bày toàn bộ thang ưu tiên, còn environment-variables.md liệt kê các biến có tiền tố AGGREGA_.

aggrega config show --origin cho biết lớp nào trong các lớp đó đã quyết định từng thiết lập, và một cờ bạn đã gõ được báo cáo là cờ — vì vậy khi một lệnh từ chối nêu tên một lớp mà bạn không ngờ tới, lệnh đó là nơi bạn xác nhận điều này.

Xem thêm

  • configuration.md — một thiết lập thuộc về tệp nào, và toàn bộ mô hình thứ tự ưu tiên.
  • environment-variables.md — tài liệu tham khảo đầy đủ về các biến AGGREGA_*.
  • aggrega-serve.md — daemon phân giải workspace của nó qua cùng đường dẫn khám phá thư mục gốc.
CờMặc địnhMô tả
--config—đường dẫn đến tệp cấu hình toàn cục, ghi đè biến môi trường AGGREGA_CONFIG và vị trí mặc định. Các tệp cấu hình trong cây workspace vẫn được xếp lớp lên trên
--no-colorfalseTắt màu ANSI trong mọi đầu ra. Cũng được áp dụng thông qua biến môi trường NO_COLOR
--offlinefalseTừ chối mọi truy cập mạng cho riêng lần chạy này: chế độ ngoại tuyến, được bật mà không cần sửa cấu hình. Truyền —offline=false để tắt nó cho một lần chạy khi tệp cấu hình hoặc AGGREGA_OFFLINE đã bật nó. Những gì bị từ chối là những gì không thể đúng nếu không có registry: —upgrade, vốn có nhiệm vụ đưa từng phụ thuộc lên phiên bản cao nhất mà registry hiện cung cấp, và các lệnh mà công việc của chính chúng là một lượt khứ hồi qua mạng — push, push-artifact và registry update. Những gì vẫn chạy là bất cứ thứ gì máy đã có thể đáp ứng: một lần build dựa trên lockfile đã được điền đầy đủ, —auto-pull trên các tham chiếu đã được lưu trong bộ nhớ đệm hoặc có trong một catalog cục bộ, và một lần chạy thử (dry run), vốn báo cáo những gì nó sẽ xuất bản và không gọi gì cả
--plainfalseChế độ trợ năng: tắt màu và vẽ các dòng tiến trình tĩnh, đơn giản, không có hoạt ảnh spinner hay vẽ lại con trỏ, ngay cả trên terminal. Dành cho trình đọc màn hình
--workspace-root—đường dẫn tuyệt đối dùng làm thư mục gốc của workspace (bỏ qua bước khám phá)