私人註冊
私人註冊通常用於公司內部,以控管對套件存取權,例如確保只使用經過核准的套件。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。您可以執行下列步驟,執行此操作
- 移至 Azure DevOps 專案的「Artifact」區段。
- 建立新的 Feed 或選取現有的 Feed。在建立新 Feed 時,預設選項會正常運作。
- 按一下 Feed 頁面右上角的「Feed 設定」按鈕。它會顯示為齒輪圖示。
- 按一下 Feed 設定中的「上游來源」標籤。
- 按一下「新增上游程式」按鈕。
- 在詢問上游來源類型時,選取「公共來源」。
- 在「公共來源」下拉式選單中,選取「自訂註冊表」。
- 在「自訂註冊表 URL」欄位中,輸入 JSR 註冊表的 URL。JSR 註冊表的 URL 是
https://npm.jsr.io
。 - 選取「npm」作為「套件類型」。
- 輸入「JSR」作為「上游來源名稱」。
- 按一下「儲存」以儲存上游來源。
- 在「上游來源」清單中選取「JSR」上游來源,然後按一下「向上移動」按鈕,直到位於「npmjs」上游來源的上方。這會確保在公用 npm 註冊表之前,會先檢查 JSR。
- 按一下上游來源頁面右上角的「儲存」,以儲存對上游來源所做的變更。
在您將 JSR 組態為 Azure DevOps Artifacts 的上游程式之後,您可以在 Azure DevOps Artifacts 中將套件從 JSR 新增至您的 Feed。當套件已新增至 Feed 時,Feed 的使用者便可以存取該套件。要執行此操作,請執行下列步驟
- 移至 Azure DevOps 專案的「Artifact」區段。
- 選取您要將套件新增至其中的 Feed。此 Feed 必須已將 JSR 組態為上游程式(請參閱以上說明)。
- 按一下 Feed 頁面中的「搜尋上游來源」。
- 選取「npm」作為套件類型。
- 以以下格式輸入您想要新增至 feed 的套件名稱:
@jsr/scope__package
。例如,若要新增@luca/cases
,請輸入@jsr/luca__cases
。 - 按一下「搜尋」。
- 選取您想要新增至 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 來追蹤狀態。