安装 Red Hat Advanced Developer Suite - 软件供应链

1. 创建 GitHub 个人访问令牌。
2. 创建 GitHub 应用程序。

流程

1. 进入 GitHub 上的 Developer 设置页面。
2. 在左侧导航面板中，在 Personal access token 下，单击 Tokens (classic)。
3. 在 Generate new token 下拉菜单中选择 Generate new token (classic)。如果出现提示，请进行身份验证。
4. 输入名称，选择过期日期，并在 Select scopes 下选择 repo。这自动包括来自 repo:status 到 security_events 的所有范围。
5. 点 Generate token。GitHub 将您重定向到显示令牌的新页面。
6. （可选）将令牌保存到文件中，如 values.txt，以便在后续步骤中重复使用。

流程

1. 运行以下命令来创建 GitHub 应用程序：

   bash-5.1$ tssc integration github-app \
     --create \
     --token="$GH_TOKEN" \
     --org="$GH_ORG_NAME" \
     $GH_APP_NAME

   替换以下变量：

   • $GH_TOKEN ：GitHub 个人访问令牌
   • $GH_ORG_NAME: GitHub 组织名称
   • $GH_APP_NAME ：GitHub 应用程序的名称
2. 复制命令输出中的 URL，并在浏览器中打开该 URL。
3. 点 Create your GitHub App。
4. 如有提示，向 GitHub 进行身份验证。
5. 点 Create GitHub App for <your organization>。
6. 创建应用程序时，点成功消息中的链接在 GitHub 机构中安装应用程序。
7. 在重定向的 GitHub 页面上，单击 Install。
8. 选择您用于 RHADS - SSC 的 GitHub 组织。

9. 出现提示时，选择 All repositories，然后单击 Install。

   注意

   您可能需要保持此 GitHub 页面处于打开状态。横幅包含一个链接（使用 https://backstage-developer-hub-rhtap…​）在安装后访问 RHADS - SSC。

流程

1. 在集成 RHACS 前，获取 API 令牌和中央端点 URL。URL 必须包含协议、主机名和端口。例如： https://central-rhacs.example.com:443。

   1. 按照 创建 RHACS API 令牌 中的说明来生成令牌。
   2. 将令牌保存到文件中，如 values.txt，以便在后续步骤中重复使用。
   3. 按照 Configure the Central 端点 URL 中的说明，找到您的 ACS Central 端点。
   4. 将端点 URL 保存到文件中，如 values.txt，以便在后续步骤中重复使用。

2. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration acs \
     --endpoint="$ACS_ENDPOINT" \
     --token="$ACS_TOKEN"

   替换以下变量：

   • $ACS_ENDPOINT ：您的 RHACS Central 端点的 URL
   • $ACS_TOKEN ：RHAC API 令牌

流程

1. 在 Web 浏览器中，登录您的 Quay 帐户。

   1. 浏览到您组织的机器人帐户。
   2. 选择适当的机器人帐户。例如，具有写入权限的机器人帐户。
   3. 在弹出窗口中，选择 Docker Configuration > View [username-robotaccount]-auth.json。
   4. 复制遵循 "auth": 的字符串值（没有引号）。
   5. 将 auth 值和 Quay 用户名保存到文件中，如 values.txt，以便在构建 Docker 配置时使用它们。
   6. 对机器人帐户具有读取权限，重复执行 1b 到 1e 的步骤。
2. 在单独的浏览器选项卡中，前往 Repositories 页面。
3. 在 Users and Organizations 下，单击您要与 RHADS - SSC 搭配使用的组织的名称。
4. 在左侧导航中，单击 Applications。
5. 点 Create New Application 并输入名称。
6. 点您创建的应用程序的名称。
7. 在左侧导航中，单击 Generate Token。
8. 在权限列表中，选择 View all visible repositories。
9. 单击 Generate Access Token。
10. 单击 授权应用程序。Quay 显示访问令牌。复制此令牌。

1. 在 tssc 容器中，运行以下命令将 Quay 与 RHADS - SSC 集成，传递所有所需的值内联：

   # Docker configuration JSON string for the read/write robot account
   bash-5.1$ tssc integration quay \
     --dockerconfigjson='{"auths":{"quay.io":{"auth":"<auth_token_write_permission>","email":""}}}' \
     --dockerconfigjsonreadonly='{"auths":{"quay.io":{"auth":"<auth_token_read_permission>","email":""}}}'
     --token="<quay_access_token>" \
     --url="https://quay.io"

   替换以下值：

   • <auth_token_write_permission > ：在 "auth": for read and write robot account 下的 auth.json 文件中的值。
   • <auth_token_read_permission > ：在 "auth": for read only robot account 下的 auth.json 文件中的值。
   • <quay_access_token > : 通过 OAuth 应用程序生成的访问令牌
   • https://quay.io: Quay 实例 URL （如果自托管则使用您的自定义 URL）

流程

1. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration bitbucket \
     --username="$BB_USERNAME" \
     --app-password="$BB_TOKEN" \
     --host="$BB_URL"

   替换以下变量：

   • $BB_USERNAME: 您的 Bitbucket 用户名
   • $BB_TOKEN ：您的 Bitbucket 应用程序密码

   • $BB_URL ：您的 Bitbucket 主机 URL （可选）

     注意

     如果您使用默认的 Bitbucket 云主机(bitbucket.org)，您可以省略 the- host 选项。

流程

1. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration gitlab \
     --token="$GL_API_TOKEN" \
     --host="$GL_URL" \
     --group="$GL_GROUP"

   替换以下变量：

   • $GL_API_TOKEN ：您的 GitLab 个人访问令牌
   • $GL_URL ：您的 GitLab 主机 URL （如果使用 gitlab.com，则忽略此选项）
   • $GL_GROUP ：包含您的存储库的 GitLab 组名称

流程

1. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration jenkins \
     --token="$JK_API_TOKEN" \
     --url="$JK_URL" \
     --username="$JK_USERNAME"

   替换以下变量：

   • $JK_API_TOKEN ：您的 Jenkins API 令牌
   • $JK_URL ： Jenkins 实例的 URL
   • $JK_USERNAME: 您的 Jenkins 用户 ID

流程

1. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration azure \
     --organization="$AZURE_ORGANIZATION" \
     --host="$AZURE_HOST_URL" \
     --token="$AZURE_API_TOKEN" \
     --tenantID="$AZURE_TENANT_ID" \
     --client-id="$AZURE_CLIENT_ID" \
     --client-secret="$AZURE_CLIENT_SECRET"

   替换以下变量：

   • $AZURE_ORGANIZATION: 您的 Azure DevOps 组织名称
   • $AZURE_HOST_URL ：您的 DevOps 基础 URL （如果使用默认的 dev.azure.com，则忽略此选项。）
   • $AZURE_API_TOKEN ：您的个人访问令牌
   • $AZURE_TENANT_ID: （可选）AAD 租户 ID
   • $AZURE_CLIENT_ID: （可选）AAD 应用程序客户端 ID
   • $AZURE_CLIENT_SECRET ：（可选）AAD 应用程序客户端 secret

流程

1. 在 Artifactory Web UI 中，进入 Administration 视图。
2. 单击您要使用的存储库旁边的绿色 设置客户端/CI 工具 按钮。
3. 选择 Docker Client。

4. 按照 UI 中的说明，通过 CLI 进行身份验证：

   1. UI 生成用作 Docker 密码的令牌。将令牌保存到文件中，如 values.txt，以便后续步骤中重复使用

   2. 通过 CLI 登录 JFrog 后，您应看到一条信息，表示您的密码保存在文件（如 ~/.docker/config.json ）。

      注意

      如果没有看到此消息，您可以在后续步骤中手动生成 config.json 内容。

5. 在 tssc 容器中，运行以下集成命令：

   bash-5.1$ tssc integration artifactory \
     --url="$AF_URL" \
     --dockerconfigjson='$AF_DOCKERCONFIGJSON' \
     --token="$AF_API_TOKEN"

   替换以下变量：

   • $AF_URL: JFrog 实例的 URL （例如 https://myusername.jfrog.io）
   • $AF_DOCKERCONFIGJSON ：存储密码的 config.json 文件的内容

   • $AF_API_TOKEN ：由 JFrog 生成的令牌

     注意

     确保将 $AF_DOCKERCONFIGJSON 值嵌套在单引号中，以保留 JSON 结构。

     如果 CLI 没有生成 config.json 文件，您可以使用以下格式手动创建其内容：

     {
       "auths": {
         "<URL for your JFrog instance>": {
           "auth": "<base64 format of username:password>",
           "email": ""
         }
       }
     }

流程

1. （可选）创建临时环境变量并存储以下值：

   REGISTRY_URL="<url to the nexus container registry>"
   AUTHFILE='auth.json'  # This file will be created in the next step.

   如果您选择不创建这些变量，请记得将代码示例中的变量替换为相关值。

2. 使用 Podman 登录到 Nexus 容器 registry，并生成与 Docker 兼容的身份验证文件：

   podman login --authfile="${AUTHFILE}" "${REGISTRY_URL}"

   此命令登录 Nexus，创建一个 auth.json 文件，并将 Nexus 用户名和密码存储在其中。

3. 在 tssc 容器中，运行以下集成命令：

   tssc integration nexus \
     --url="${REGISTRY_URL}" \
     --dockerconfigjson="$(cat ${AUTHFILE})"

4. 删除本地 auth.json 文件，因为它已不再需要。

   rm "${AUTHFILE}"

流程

1. 使用 RHADS - SSC 登录在同一集群中运行的 Quay 实例。
2. 导航到 rhtap 组织。
3. 选择 Applications > OAuth Applications > Create New Application > Generate Token。
4. 选中 View all visible repositories 选项的复选框。
5. 单击 Generate Access Token。
6. 复制并保存访问令牌。

7. 在终端中运行以下命令来更新 rhtap-quay-integration secret：

   export ACCESS_TOKEN=<generated-Quay-token>
   oc patch secret rhtap-quay-integration \
     -n rhtap \
     --type='merge' \
     -p="{\"data\":{\"token\":\"$(echo -n $ACCESS_TOKEN | base64)\"}}"
   tssc deploy chart/rhtap-dh

   此步骤还应自动更新 developer-hub-rhtap-env secret。