本页介绍了如何设置远程代码库以访问和下载 Assured OSS 软件包。您可以通过两种方式设置远程代码库:JFrog Artifactory 或 Sonatype Nexus。如需详细了解代码库选项,请参阅可信 OSS 代码库选项。
本文档仅适用于 Assured OSS 高级层级。对于免费层级,请参阅使用远程仓库下载 Assured OSS 软件包。
准备工作
使用 JFrog Artifactory 设置远程仓库
- 登录 JFrog Artifactory 仓库管理器。确保您拥有创建新的远程代码库所需的权限。
- 在代码库管理器中,选择用于创建新远程代码库的选项。
- 选择适当的代码库类型(例如,对于 Java 选择
Maven
,对于 Python 选择PyPi
)。 (可选)按照以下步骤测试与 Java、Python 或 JavaScript 代码库的连接:
- 在 Repository Key(代码库密钥)字段中,输入远程代码库的唯一名称或标识符。
在网址字段中,输入以下任一网址:
- Java:
https://us-maven.pkg.dev
- Python:
https://us-python.pkg.dev
- JavaScript:
https://us-npm.pkg.dev
请勿输入完整域名,因为这可能会返回 HTTP
404
或 HTTP405
状态代码。- Java:
将其余字段留空。
点击测试。当您看到以下输出时,表示连接成功:
Successfully connected to server
如需创建新的远程代码库,请输入以下信息:
- 在代码库密钥字段中,输入远程代码库的唯一名称或标识符。例如
assured-oss-java-repo
。 在网址字段中,输入以下任一网址:
- Java:
https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
- Python:
https://us-python.pkg.dev/
- JavaScript:
https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm
将
PROJECT_ID
替换为您在设置 Assured OSS 时选择的项目的 ID。- Java:
在用户名字段中,输入
_json_key_base64
。在密码字段中,提供服务账号 JSON 密钥文件的 base64 编码字符串。将整个 base64 编码的字符串用作密码。如需获取 base64 编码的字符串,请运行命令
cat key-filename.json | base64 -w 0
。对于仅限 Python 的项目,在 Registry 网址 字段中,输入
。https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
- 在代码库密钥字段中,输入远程代码库的唯一名称或标识符。例如
点击创建远程代码库。
对于 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)以使用此新的远程代码库。
已知问题
使用测试按钮测试连接时,即使连接配置正确无误,也可能会返回错误。我们建议您创建远程代码库,无论测试按钮的行为如何。如需了解确认连接的另一种方法,请参阅验证连接。
使用 Sonatype Nexus 设置远程代码库
- 登录您的 Sonatype Nexus 代码库管理器。确保您拥有创建新的远程代码库所需的权限。
- 选择用于创建新代码库的选项。
- 选择适当的代码库类型(例如,对于 Java 选择
Maven
,对于 Python 选择PyPi
)。 为新代码库输入以下详细信息:
- 在名称字段中,输入远程代码库的唯一名称或标识符。
在远程存储空间字段中,从以下选项中进行选择:
Java:
https://us-maven.pkg.dev/PROJECT_ID/assuredoss-java
Python:
https://us-python.pkg.dev/PROJECT_ID/assuredoss-python
JavaScript:
https://us-npm.pkg.dev/PROJECT_ID/assuredoss-npm
将
PROJECT_ID
替换为您在设置 Assured OSS 时选择的项目的 ID。
在 HTTP 下,选择 Authentication。
指定下列内容:
- 在身份验证类型字段中,输入
Username
。 - 在用户名字段中,输入
_json_key_base64
。 - 在密码字段中,提供服务账号 JSON 密钥文件的 base64 编码字符串。将单行中的整个 base64 编码字符串用作密码。如需获取 base64 编码的字符串,请运行命令
base64 key-filename.json
。
- 在身份验证类型字段中,输入
点击创建代码库。
设置新的远程仓库后,将构建工具(例如 Apache Maven、Gradle Build Tool 或 pip)指向此新的远程仓库。