跳至主要內容

查看目錄

私人註冊

私人註冊通常用於公司內部,以控管對套件存取權,例如確保只使用經過核准的套件。JSR 能整合 NPM 私人註冊,這樣你就能在必須使用 NPM 私人註冊的公司中使用 JSR 套件。

注意:JSR 目前不提供私人註冊功能。這表示目前無法在 JSR 中發布私人套件。這項功能已追蹤於 議題 #203

將 JSR 用作 NPM 私人註冊的上游

當 JSR 被用作 NPM 私人註冊的上游時,私人註冊會將請求代理至 JSR,以取得私人註冊中找不到的套件。這允許私人註冊用作 JSR 套件的快取,並強制執行公司內部可使用的套件規則。

要將 JSR 作為 NPM 私有註冊表的上游程式,您需要將私有註冊表組態為將要求代理至 JSR。確切的步驟依照您使用的私有註冊表軟體而定。以下說明一些熱門私有註冊表軟體如何將 JSR 作為上游程式的組態方式。

將 JSR 組態為 Azure DevOps Artifacts 的上游程式

若要將 JSR 用作 Azure DevOps Artifacts 的上游程式,您需要在 Azure DevOps Artifacts 中建立一個新的上游來源,指向 JSR。您可以執行下列步驟,執行此操作

  1. 移至 Azure DevOps 專案的「Artifact」區段。
  2. 建立新的 Feed 或選取現有的 Feed。在建立新 Feed 時,預設選項會正常運作。
  3. 按一下 Feed 頁面右上角的「Feed 設定」按鈕。它會顯示為齒輪圖示。
  4. 按一下 Feed 設定中的「上游來源」標籤。
  5. 按一下「新增上游程式」按鈕。
  6. 在詢問上游來源類型時,選取「公共來源」。
  7. 在「公共來源」下拉式選單中,選取「自訂註冊表」。
  8. 在「自訂註冊表 URL」欄位中,輸入 JSR 註冊表的 URL。JSR 註冊表的 URL 是 https://npm.jsr.io
  9. 選取「npm」作為「套件類型」。
  10. 輸入「JSR」作為「上游來源名稱」。
  11. 按一下「儲存」以儲存上游來源。
  12. 在「上游來源」清單中選取「JSR」上游來源,然後按一下「向上移動」按鈕,直到位於「npmjs」上游來源的上方。這會確保在公用 npm 註冊表之前,會先檢查 JSR。
  13. 按一下上游來源頁面右上角的「儲存」,以儲存對上游來源所做的變更。

在您將 JSR 組態為 Azure DevOps Artifacts 的上游程式之後,您可以在 Azure DevOps Artifacts 中將套件從 JSR 新增至您的 Feed。當套件已新增至 Feed 時,Feed 的使用者便可以存取該套件。要執行此操作,請執行下列步驟

  1. 移至 Azure DevOps 專案的「Artifact」區段。
  2. 選取您要將套件新增至其中的 Feed。此 Feed 必須已將 JSR 組態為上游程式(請參閱以上說明)。
  3. 按一下 Feed 頁面中的「搜尋上游來源」。
  4. 選取「npm」作為套件類型。
  5. 以以下格式輸入您想要新增至 feed 的套件名稱:@jsr/scope__package。例如,若要新增 @luca/cases,請輸入 @jsr/luca__cases
  6. 按一下「搜尋」。
  7. 選取您想要新增至 feed 的套件和版本,然後在下拉式選單中選取「新增至 feed」(套件旁的三个垂直省略號)。

將套件新增至 feed 後,其將對 feed 使用者開放。使用者可以使用 npm install 指令安裝套件,且將從 JSR 擷取該套件。使用者不須在其 .npmrc 檔案中將 JSR 設定為上游,因為 JSR 套件現已從 Azure DevOps Artifacts feed 取得。

將 JSR 上游設定為 Google Artifact Registry

目前無法使用 JSR 作為 Google Artifact Registry 的上游,因為 JSR 和 Google Artifact Registry 預期的套件 tarball URL 佈局不同。

關於將 JSR 的套件 tarball URL 與 NPM 上游對齊,請參閱 議題 #405 來追蹤狀態。

將 JSR 上游設定為 JFrog Artifactory

目前無法使用 JSR 作為 JFrog Artifactory 的上游,因為 JSR 和 JFrog Artifactory 預期的套件 tarball URL 佈局不同。

關於將 JSR 的套件 tarball URL 與 NPM 上游對齊,請參閱 議題 #405 來追蹤狀態。

在 GitHub 上編輯此頁面