使用遠端存放區下載 Assured OSS 套件

本頁說明如何設定遠端存放區，以存取及下載 Assured OSS 套件。設定遠端存放區的方式有兩種：JFrog Artifactory 或 Sonatype Nexus。如要進一步瞭解存放區選項，請參閱「Assured OSS 存放區選項」。

本文適用於免費方案。如要瞭解付費層級，請參閱「使用遠端存放區下載 Assured OSS 套件」。

事前準備

  1. 啟用 Assured OSS。

  2. 驗證連線：為要求的服務帳戶驗證與 Assured OSS 的連線。

使用 JFrog Artifactory 設定遠端存放區

  1. 登入 JFrog Artifactory 存放區管理員。確認您具備建立新遠端存放區的必要權限。
  2. 在存放區管理員中，選取建立新遠端存放區的選項。
  3. 選取適當的存放區類型 (例如，選取 Maven 代表 Java、PyPi 代表 Python，或 Go 代表 Go)。

  4. 您也可以選擇按照下列步驟，測試與 Java 或 Python 存放區的連線：

    1. 在「存放區金鑰」欄位中，輸入遠端存放區的專屬名稱或 ID。

    2. 在「網址」欄位中，輸入下列其中一項：

      • Java：
        https://us-maven.pkg.dev
      • Python：
        https://us-python.pkg.dev
      • JavaScript：
        https://us-npm.pkg.dev
      • Go：
        https://us-go.pkg.dev

      請勿輸入完整的網域名稱，因為這項動作可能會傳回 HTTP 404 或 HTTP 405 狀態碼。

    3. 將剩餘欄位保留空白。

    4. 按一下「測試」。 看到下列輸出內容時，表示連線成功：

      Successfully connected to server

  5. 如要建立新的遠端存放區，請輸入下列資訊：

    1. 在「存放區金鑰」欄位中，輸入遠端存放區的專屬名稱或 ID。例如：assured-oss-java-repo。

    2. 在「網址」欄位中，輸入下列其中一項：

      • Java： 
        https://us-maven.pkg.dev/cloud-aoss/java
      • Python： 
        https://us-python.pkg.dev/cloud-aoss/python
      • Go：
        https://us-go.pkg.dev/cloud-aoss/go

    3. 在「User Name」(使用者名稱) 欄位中輸入 _json_key_base64。

    4. 在「密碼」欄位中，提供服務帳戶 JSON 金鑰檔案的 Base64 編碼字串。將整個 base64 編碼字串當做密碼，放在同一行。如要取得 Base64 編碼字串，請執行 cat key-filename.json | base64 指令。

    5. 如果是 Python，請在「登錄網址」欄位中輸入：

      https://us-python.pkg.dev/cloud-aoss/python
       在「URL」欄位中輸入：
      https://us-python.pkg.dev

    6. 如果是 Go，請在「進階設定」分頁中選取「略過 HEAD 要求」。

  6. 按一下「Create Remote Repository」(建立遠端存放區)。

    如果是 Python 套件，請在取得的網址後方附加 /simple。在 pip install 指令中，使用這個網址做為 index-url，下載必要的 Python 套件。舉例來說，如果取得的存放區網址為 https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo，則對應的 index-url 為 https://a0a87smb7hcda.jfrog.io/artifactory/api/pypi/assured-oss-python-repo/simple。

設定新的遠端存放區後，請設定建構工具 (例如 Apache Maven、Gradle 建構工具或 pip)，以便使用這個新的遠端存放區。

已知問題

即使連線設定正確無誤，使用「測試」按鈕測試連線時，仍可能會傳回錯誤。建議您建立遠端存放區，無論測試按鈕的行為如何。如要瞭解其他確認連線的方式，請參閱「驗證連線」。

使用 Sonatype Nexus 設定遠端存放區

  1. 登入 Sonatype Nexus 存放區管理員。確認您具備建立新遠端存放區的必要權限。
  2. 選取建立新存放區的選項。
  3. 選取適當的存放區類型 (例如，選取 Maven 代表 Java、PyPi 代表 Python，或 Go 代表 Go)。

  4. 輸入新存放區的下列詳細資料：

    1. 在「名稱」欄位中，輸入遠端存放區的專屬名稱或 ID。

    2. 在「Remote Storage」(遠端儲存空間) 欄位中，選擇下列其中一項：

      • Java： 

        https://us-maven.pkg.dev/cloud-aoss/java

      • Python：

        https://us-python.pkg.dev/cloud-aoss/python

      • Go：

        https://us-go.pkg.dev/cloud-aoss/go

  5. 在「HTTP」下方，選取「Authentication」。

  6. 指定下列屬性：

    1. 在「Authentication type」(驗證類型) 欄位中，輸入 Username。
    2. 在「Username」(使用者名稱) 欄位中輸入 _json_key_base64。
    3. 在「密碼」欄位中，提供服務帳戶 JSON 金鑰檔案的 Base64 編碼字串。請使用整行 base64 編碼字串做為密碼。如要取得 Base64 編碼字串，請執行 cat key-filename.json | base64 指令。

  7. 點選「Create Repository」。

設定新的遠端存放區後，請將建構工具 (例如 Apache Maven、Gradle 建構工具或 pip) 指向這個新的遠端存放區。

後續步驟