Bazel 註冊資料庫

回報問題查看原始碼。。。。夜間。。。 7.3 。。 7.2 。。 7.1 。。 7.0 。。 6.5 。。

Bzlmod 透過 Bazel 要求其資訊來探索依附元件 registries：Bazel 模組的資料庫。目前 Bzlmod 僅支援 索引註冊資料庫 - 本機目錄或靜態 HTTP 伺服器且在特定格式中

索引註冊資料庫

索引註冊資料庫是本機目錄或含有模組清單的相關資訊，包括其首頁、維護人員、每個版本的 MODULE.bazel 檔案，以及如何擷取各個版本的原始碼版本。值得注意的是，「不需要」提供來源封存。

索引註冊資料庫必須採用以下格式：

/bazel_registry.json：含有登錄檔中繼資料的 JSON 檔案例如：
- mirrors：指定用於來源封存的鏡像清單
- module_base_path：指定含有 source.json 檔案中的 local_repository 類型
/modules：包含子目錄中每個模組的子目錄註冊資料庫
/modules/$MODULE：包含每個版本的子目錄的目錄其他詳細資訊
- metadata.json：包含模組相關資訊的 JSON 檔案。包含下列欄位：
  - homepage：專案的首頁網址
  - maintainers：JSON 物件清單，每個物件都對應至 登錄檔中模組維護人員的資訊。請注意，此指示不一定等於文件的作者專案
  - versions：可顯示此模組的所有版本這個登錄檔
  - yanked_versions：「yanked」的地圖個版本。重要應為 yank 的版本，而值應該是版本為何為「女用」形，最好附上更多連結資訊
/modules/$MODULE/$VERSION：包含下列檔案的目錄：
- MODULE.bazel：此模組版本的 MODULE.bazel 檔案
- source.json：JSON 檔案，內含如何擷取這個模組版本的原始碼
  - 預設類型為「Archive」，代表 http_archive 存放區。包含下列欄位：
    - url：來源封存網址
    - integrity：子資源誠信封存檔總和檢查碼
    - strip_prefix：擷取來源封存
    - patches：包含要套用至擷取的封存檔。修補程式檔案位於 /modules/$MODULE/$VERSION/patches 目錄內。關鍵在於更新修補程式檔案名稱，而其值為修補型檔案
    - patch_strip：與 Unix patch 的 --strip 引數相同。
    - archive_type：下載檔案的封存類型 (與 http_archive 上的 type 相同)。根據預設，封存類型取決於網址的副檔名。如果檔案如果是沒有副檔名，您可以明確指定下列其中一項："zip"、"jar"、"war"、"aar"、 "tar"、"tar.gz"、"tgz"、"tar.xz"、"txz"、"tar.zst"、"tzst"、tar.bz2、"ar" 或 "deb"。
  - 透過以下欄位，您可以將類型變更為使用 Git 存放區：
    - type：git_repository
    - https://bazel.build/rules/lib/repo/git 說明下列欄位：
      - remote
      - commit
      - shallow_since
      - tag
      - init_submodules
      - verbose
      - strip_prefix
  - 可以將類型變更為使用本機路徑，代表 local_repository 存放區，包含以下欄位：
    - type：local_path
    - path：存放區的本機路徑，計算方式如下：
      - 如果 path 是絕對路徑，則保持不變
      - 如果 path 是相對路徑，且 module_base_path 是絕對路徑，該路徑會解析為 <module_base_path>/<path>
      - 如果 path 和 module_base_path 都是相對路徑，則解析為 <registry_path>/<module_base_path>/<path>。註冊資料庫必須在本機託管，並由 --registry=file://<registry_path>。否則 Bazel 才會擲回錯誤
- patches/：包含修補檔案的選用目錄，只在下列情況使用 source.json含有「封存」類型

Bazel Central Registry

位於 https://bcr.bazel.build/ 的 Bazel Central Registry (BCR) 是索引含有 GitHub 存放區所支援內容的註冊資料庫 bazelbuild/bazel-central-registry。您可以透過下列網路前端瀏覽內容： https://registry.bazel.build/.

Bazel 社群負責維護 BCR，歡迎您提交參與人員提取要求查看 BCR 貢獻指南。

除了遵循一般索引註冊資料庫的格式之外，BCR 也規定每個模組版本都有一個 presubmit.yml 檔案 (/modules/$MODULE/$VERSION/presubmit.yml).這個檔案指出一些建構和測試目標，供您檢查此模組的有效性版本。BCR 的 CI 管道也會使用這項資訊來確保互通性不同模組之間的互動

選取登錄檔

可重複的 Bazel 標記 --registry 可用來指定向其要求模組的註冊資料庫，因此您可以設定專案安裝自第三方或內部註冊資料庫早期的註冊資料庫優先順序。為了方便起見，您可以在--registry .bazelrc 檔案。

如果您的註冊資料庫是由 GitHub 代管 (例如 bazelbuild/bazel-central-registry)，則 --registry 值需要原始值 raw.githubusercontent.com 底下的 GitHub 位址。例如，在 main my-org 分支的分支，應將 --registry=https://raw.githubusercontent.com/my-org/bazel-central-registry/main/。

使用 --registry 標記可讓 Bazel Central Registry 停止由但您可以加上 --registry=https://bcr.bazel.build 將其加回。