安装 Red Hat Trusted Application Pipeline

流程

1. 进入 GitHub 中的 Developer Settings 页面。
2. 在左侧面板中，在 个人访问令牌 下选择 Tokens (classic)。
3. 在页面横幅下的 Generate new token 下拉菜单中选择 Generate new token (classic)。您可能需要进行身份验证才能继续。
4. 输入名称，选择过期日期，并在 Select scopes 下选择 repo （这应该自动包含 repo: status 的所有范围到 security_events）。

5. 选择 Generate token。GitHub 将您重定向到一个新页面，其中您的令牌可见。创建一个名为 private.env 的新文件，并将此令牌保存到该文件中。

   注意

   private.env 对于安装成功至关重要。请确定您创建此文件并将其保存在安全位置。

流程

1. 在 CLI 中，向 registry.redhat.io 进行身份验证。

   $ podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

2. 拉取安装程序镜像。

   $ podman pull registry.redhat.io/rhtap-cli/rhtap-cli-rhel9:latest

   Copy to Clipboard Toggle word wrap

3. 启动 rhtap-cli 容器镜像。

   $ podman run \
           -it \
           --entrypoint=bash \
           --publish 8228:8228 \
           --rm \
           rhtap-cli:latest

   Copy to Clipboard Toggle word wrap

4. 在运行的容器中，以 ClusterAdmin 用户身份登录 OpenShift 集群。

   bash-5.1$ oc login https://api.<input omitted>.openshiftapps.com:443 --username cluster-admin --password <input omitted>

   Copy to Clipboard Toggle word wrap

5. 运行以下命令以开始创建 GitHub 应用。将 $GH_TOKEN 替换为您在上一步中创建的令牌。将 $GH_ORG_NAME 替换为您要用于 RHTAP 的 GitHub 组织的名称。将 $GH_APP_NAME 替换为您要用于应用程序的名称。

   bash-5.1$ rhtap-cli integration github-app --create --token="$GH_TOKEN" --org="$GH_ORG_NAME" $GH_APP_NAME

   Copy to Clipboard Toggle word wrap
6. 此命令的输出包括 URL。在工作站上使用 Web 浏览器来导航到此地址。出现提示时，单击 Create your GitHub App。
7. 按钮将您重定向到 GitHub。如有必要，在 GitHub 中进行身份验证以确认访问。然后，单击 Create GitHub App for <your organization name>。
8. 您的浏览器中会显示一条新消息，告诉您已成功创建该应用。单击超链接文本，在您的 GitHub 组织中安装新应用。
9. 该链接会将您重定向到 GitHub。单击绿色 安装 按钮。
10. 选择您用于 RHTAP 的组织。

11. 出现提示时，选择 All repositories，以便 RHTAP 可以在您的机构中创建新存储库。单击绿色 安装 按钮。

    注意

    您可能希望将此 GitHub 页面保持打开，但您可以在不中断安装的情况下关闭它。在页面横幅中，您可以在安装后使用链接来访问 RHTAP （以 https://backstage-developer-hub-rhtap…​开始）。

流程

1. 在 Web 浏览器中，导航到 RHTAP 软件目录存储库。

2. 在页面标题下，选择 Fork 并分叉存储库。

   1. 取消选中"仅复制 主分支 "的框。
3. fork 就绪后，复制其地址。标签，并将它保存到 private.env 中。

4. 在新分叉中，在横幅下，单击 main 来打开下拉菜单。在 Tags 下，选择与您正在使用的 RHTAP 版本对应的版本。

   注意

   务必不时更新您的分叉，因此来自上游存储库的更新可以让您的 RHTAP 实例受益。

流程

1. 在集成 ACS 实例前，您需要 API 令牌和中央端点 URL。

   1. 按照 此处 前提条件的说明创建 API 令牌。将令牌保存到 private.env 中。
   2. 按照 这里 的说明来配置您的端点。将 URL 保存到 private.env 中。

2. 在 rhtap-cli 容器中，运行 integration 命令。将 $ACS_ENDPOINT 替换为您的 ACS 中央端点 URL，将 $ACS_TOKEN 替换为您的 ACS API 令牌。

   bash-5.1$ rhtap-cli integration acs --endpoint="$ACS_ENDPOINT" --token="$ACS_TOKEN"

   Copy to Clipboard Toggle word wrap

流程

1. 在您的 Web 浏览器中，登录 Quay。在横幅右侧，选择您的用户名并从下拉菜单中选择 帐户设置。
2. 在您的用户设置页面中，在 Docker CLI Password 下选择 Generate Encrypted Password。在弹出窗口中输入您的密码进行验证。
3. 接下来，仍在弹出窗口中，选择 Docker Configuration > View [username]-auth.json。复制字符串，但不使用引号，如下所示 "auth":。
4. 在 private.env 文件中，使用以下格式的标签并创建 Docker 配置值，使用您的用户名和 auth 令牌，其中 appropriate: {"auths": {"quay.io": {"auth": "[auth token]","email": ""}}}
5. 返回到 Quay UI，返回到 默认的 Repositories 页面。在右侧，在 Users 和 Organizations 下选择您要用于 RHTAP 的 Quay 组织。
6. 在左侧的标签页中，选择 Applications。
7. 单击 Create New Application。将您的应用程序命名为。
8. 点应用程序的名称。
9. 在左侧的选项卡中，选择 Generate Token。
10. 从令牌权限选项中，选择 View all visible repositories。
11. 点 Generate Access Token。
12. 单击 Authorize Applicaiton。
13. UI 显示访问令牌。另外，标记此令牌并将其保存到 private.env 中。

14. 在 rhtap-cli 容器中，运行以下命令来集成 Quay 实例。将 $QUAY_DOCKERCONFIGJSON 替换为 Docker 配置值。将 $QUAY_TOKEN 替换为您刚才生成的令牌。将 $QUAY_URL 替换为 Quay 实例的地址（如果您还没有在集群中安装 Quay，则为 https://quay.io）。https://quay.io

    bash-5.1$ rhtap-cli integration quay --dockerconfigjson='$QUAY_DOCKERCONFIGJSON' --token="$QUAY_TOKEN" --url="$QUAY_URL"

    Copy to Clipboard Toggle word wrap

流程

1. 在 rhtap-cli 容器中，运行 integration 命令。将 $BB_USERNAME 替换为您的 Bitbucket 用户名，将 $BB_TOKEN 替换为您的 Bitbucket 访问令牌。如果您要与自定义 Bitbucket 主机集成，请将 $BB_URL 替换为您的 Bitbucket 主机 URL。如果使用默认的 bitbucket.org 主机，您可以删除 the- host 选项。

   bash-5.1$ rhtap-cli integration bitbucket --username="$BB_USERNAME" --app-password="$BB_TOKEN" --host="$BB_URL"

   Copy to Clipboard Toggle word wrap

流程

1. 在 rhtap-cli 容器中，运行 integration 命令。将 $GL_API_TOKEN 替换为 GitLab API 令牌。如果您要与自定义 GitLab 主机集成，请将 $GL_URL 替换为 GitLab 主机 URL。如果使用默认的 gitlab.com 主机，您可以删除 the- host 选项。

   bash-5.1$ rhtap-cli integration gitlab --token="$GL_API_TOKEN" --host="$GL_URL"

   Copy to Clipboard Toggle word wrap

流程

1. 在 rhtap-cli 容器中，运行 integration 命令。将 $JK_API_TOKEN 替换为您的 Jenkins API 令牌，将 $JK_URL 替换为 Jenkins 实例 URL，$JK_USERNAME 替换为您的 Jenkins 用户 ID。

   bash-5.1$ rhtap-cli integration jenkins --token="$JK_API_TOKEN" --url="$JK_URL" --username="$JK_USERNAME"

   Copy to Clipboard Toggle word wrap

流程

1. 在 Artifactory UI 中，点您要使用的存储库旁边的绿色 设置客户端/CI Tool 按钮。
2. 选择 Docker Client

3. 按照 UI 说明在 CLI 中进行身份验证。

   1. UI 生成令牌以用作密码。确保将其保存在 private.env 中。
   2. 当您在 CLI 中登录 JFrog 时，您应该会收到一条消息，指出您的密码已存储在一个位置，如 ~/.docker/config.json。如果没有看到此消息，则此流程中的后续步骤解释了什么操作。

4. 在 rhtap-cli 容器中，运行 integration 命令。将 AF_URL 的值设置为实例的 URL （如 "https://myusername.jfrog.io"）。将 AF_DOCKERCONFIGJSON 的值设置为存储您的密码的文件内容。将 AF_API_TOKEN 的值设置为 JFrog 生成的令牌。

   bash-5.1$ rhtap-cli integration artifactory --url="$AF_URL" --dockerconfigjson='$AF_DOCKERCONFIGJSON' --token="$AF_API_TOKEN"

   Copy to Clipboard Toggle word wrap

流程

1. 在 rhatp-cli 容器中，创建 config.yaml 文件的副本：

   bash-5.1$ cp config.yaml my-config.yaml

   Copy to Clipboard Toggle word wrap

2. 使用 vi 文本编辑器，根据您已完成的可选步骤更改 /rhtap-cli/config.yaml 的内容：

   bash-5.1$ vi my-config.yaml

   Copy to Clipboard Toggle word wrap

   1. 如果您分叉了软件目录，请将 catalogURL 更改为 fork 的 URL，如下例所示。

      redHatDeveloperHub:
            enabled: &rhdhEnabled true
            namespace: *installerNamespace
            properties:
              catalogURL: https://github.com/<your username>/tssc-sample-templates/blob/release/all.yaml

      Copy to Clipboard Toggle word wrap

   2. 如果您运行 rhtap-cli 集成 命令，请将相关 启用字段的值 更改为 false。如果您将替代主机用于源代码，则不需要此项。但是，您所做的 任何其他 集成都需要在此文件中进行更改。以下示例显示集成预先存在的 ACS 实例所需的更改。

      redHatAdvancedClusterSecurity:
            enabled: &rhacsEnabled false
            namespace: rhtap-acs

      Copy to Clipboard Toggle word wrap
      注意

      如果您试图在产品外集成或预先存在的实例，但没有自定义 config.yaml，RHTAP 仍然安装和使用其默认产品。您必须 自定义 config.yaml 才能使 rhtap-cli 集成 命令生效。

3. 进行适当的更改后，保存新的 my-config.yaml 文件。

流程

1. 在 rhatp-cli 容器中，运行安装命令。如果您没有对 config.yaml 进行任何更改，只需运行 rhtap-cli deploy 即可。但是，如果您 确实 自定义该文件，请运行以下命令，并将 $CONFIG 变量替换为自定义文件的路径。

   注意

   完成安装需要大约十五分钟。

   bash-5.1$ rhtap-cli deploy --config=$CONFIG

   Copy to Clipboard Toggle word wrap
2. 安装完成后，请确保将 rhtap-cli deploy 命令的输出保存到 private.env 文件中。通过这个输出，您可以访问已安装的新产品实例。

3. 现在，您可以访问 RHTAP 实例！

   1. 创建 GitHub 应用程序后，您可能已打开新的 GitHub 应用程序页面，如我们的备注所建议。在这种情况下，您可以使用该页面的横幅中的链接访问 RHTAP。
   2. 否则，导航到 Applications 页面上的 Authorized GitHub Apps 选项卡。单击您为 RHTAP 创建的应用程序的名称。同样，在此页面的横幅中，您可以找到访问 RHTAP 的链接，该链接以 https://backstage-developer-hub-rhtap…​ 开始。

流程

1. 进入您的 ACS 实例。如果在安装 RHTAP 之前没有 ACS，您可以在 rhtap-cli deploy 命令的输出中找到访问详情，您可以在安装过程结束时将其保存到 ~/install_values.txt 中。
2. 按照 Red Hat Advanced Cluster Security for Kubernetes 4.6 文档中的说明将 Quay 集成到 ACS 中。