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

如要存取及下載 Assured Open Source Software (Assured OSS) 套件，您可以設定 JFrog Artifactory 或 Sonatype Nexus 遠端存放區。這項設定可讓您透過現有的構件管理工具，代理及下載 Assured OSS 套件。如要進一步瞭解存放區選項，請參閱「Assured OSS 存放區選項」。

本文適用於免費方案。如需進階級，請參閱「使用遠端存放區下載 Assured OSS 套件」。

事前準備

  1. 啟用 Assured OSS。

  2. 驗證所要求服務帳戶與 Assured OSS 的連線能力。

使用 JFrog Artifactory 設定遠端存放區

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

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

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

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

      • 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. 在「Repository Key」(存放區金鑰) 欄位中，輸入遠端存放區的專屬名稱或 ID。例如：assured-oss-java-repo。

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

      • 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. 在「使用者名稱」欄位中輸入 _json_key_base64。

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

    5. 僅限 Python：在「Registry URL」(登錄檔網址) 欄位中輸入：

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

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

  6. 按一下「建立遠端存放區」。

    如果是 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 Build Tool 或 pip)，以便使用這個新的遠端存放區。

已知問題

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

使用 Sonatype Nexus 設定遠端存放區

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

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

    1. 在「Name」(名稱) 欄位中，輸入遠端存放區的專屬名稱或 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. 在「Password」(密碼) 欄位中，提供服務帳戶 JSON 金鑰檔案的 Base64 編碼字串。請將整個 Base64 編碼字串做為密碼，並寫在同一行。如要取得 Base64 編碼字串，請執行 cat key-filename.json | base64 指令。

  7. 點選「Create Repository」。

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

後續步驟