安装 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 将您重定向到一个新页面，其中您的令牌可见。确保在您的文件中标记并保存此令牌。

   注意

   如果您计划完成任何可选流程，我们建议创建一个文件（如 ~/install_values.txt），您可以在其中存储这些程序生成的所有值以及此访问令牌。

流程

1. 在 Web UI 或 CLI 中，登录到您要安装 RHTAP 的 OpenShift 集群。

2. 在 CLI 中，运行以下命令来开始创建 GitHub 应用程序。将 $TOKEN 替换为您在上一步中创建的令牌。将 $ORG_NAME 替换为您要用于 RHTAP 的 GitHub 组织的名称。将 $APP_NAME 替换为您要用于应用程序的名称。

   $ rhtap-cli integration github-app --create --token="$TOKEN" --org="$ORG_NAME" $APP_NAME

   Copy to Clipboard Toggle word wrap
3. 此时应打开一个 Web 浏览器窗口。在该窗口中，单击 Create your GitHub App。
4. 按钮将您重定向到 GitHub。如有必要，在 GitHub 中进行身份验证以确认访问。然后，单击 Create GitHub App for <your organization name>。
5. 这时会显示一条新消息，告诉您已成功创建该应用。单击超链接文本，在您的 GitHub 组织中安装新应用。
6. 该链接会将您重定向到 GitHub。单击绿色 安装 按钮。
7. 选择您用于 RHTAP 的组织。

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

   注意

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

流程

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

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

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

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

   注意

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

流程

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

   1. 按照 此处 前提条件的说明创建 API 令牌。将令牌保存到 ~/install_values.txt 中。
   2. 按照 这里 的说明来配置您的端点。将 URL 保存到 ~/install_values.txt 中。
2. 在 CLI 中，登录到您要安装 RHTAP 的 OpenShift 集群。

3. 运行 integration 命令。将 $ENDPOINT 替换为您的 ACS 中央端点 URL，将 $TOKEN 替换为您的 ACS API 令牌。

   rhtap-cli integration acs --endpoint="$ENDPOINT" --token="$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. 在 ~/install_values.txt 文件中，使用以下格式的标签和创建 Docker 配置值，使用您的用户名和 auth 令牌的适当： {"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 显示访问令牌。还要标记此令牌并将其保存到 ~/install_values.txt 中。

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

    $ rhtap-cli integration quay --dockerconfigjson="$DOCKERCONFIGJSON" --token="$API_TOKEN" --url="$URL"

    Copy to Clipboard Toggle word wrap

流程

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

   $ rhtap-cli integration gitlab --token="$API_TOKEN" --host="$URL"

   Copy to Clipboard Toggle word wrap

流程

1. 在 CLI 中，运行 integration 命令。将 $API_TOKEN 替换为您的 Jenkins API 令牌，将 $URL 替换为 Jenkins 实例 URL，$USERNAME 替换为您的 Jenkins 用户 ID。

   $ rhtap-cli integration jenkins --token="$API_TOKEN" --url="$URL" --username="$USERNAME"

   Copy to Clipboard Toggle word wrap

流程

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

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

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

4. 在 CLI 中，运行 integration 命令。将 ARTIFACTORY_URL 的值设置为实例的 URL （如 "https://myusername.jfrog.io"）。将 ARTIFACTORY_DOCKERCONFIGJSON 的值设置为存储您的密码的文件内容。将 ARTIFACTORY_API_TOKEN 的值设置为 JFrog 生成的令牌。

   $ rhtap-cli integration artifactory --url="$ARTIFACTORY_URL" --dockerconfigjson="$ARTIFACTORY_DOCKERCONFIGJSON" --token="$ARTIFACTORY_API_TOKEN"

   Copy to Clipboard Toggle word wrap

流程

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

   $ rhtap-cli integration bitbucket --username="$username" --app-password="$access_token" --host="$URL"

   Copy to Clipboard Toggle word wrap

流程

1. 在 CLI 中，创建一个新目录。

   $ mkdir tmp

   Copy to Clipboard Toggle word wrap

2. 将安装图表提取到新目录中。

   $ rhtap-cli installer --extract=tmp

   Copy to Clipboard Toggle word wrap

3. 创建该目录中现在存在的 config.yaml 的副本。

   $ cp tmp/config.yaml tmp/my-config.yaml

   Copy to Clipboard Toggle word wrap

4. 使用您的首选文本编辑器，根据您完成的可选步骤更改文件内容：

   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. 如果您集成了 ACS 或 Quay，请将相关 启用字段的值 更改为 false。以下示例显示您需要对 ACS 所做的更改。

      redHatAdvancedClusterSecurity:
            enabled: false
            namespace: rhtap-acs

      Copy to Clipboard Toggle word wrap
      注意

      如果您尝试集成 ACS 或 Quay，但没有自定义 config.yaml，RHTAP 仍会安装和使用这些产品的新实例。您必须 自定义 config.yaml 才能使 rhtap-cli 集成 命令生效。

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

流程

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

   注意

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

   $ rhtap-cli deploy --config=$CONFIG

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

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.5 文档中的说明将 Quay 集成到 ACS 中。