文档AEM as a Cloud Service用户指南

在 Cloud Manager 中添加专用存储库 private-repositories

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined
  • undefined

通过将 Cloud Manager 配置为使用您自己的专用 GitHub 存储库，您可以通过 Cloud Manager 直接在 GitHub 存储库中验证代码，而无需始终将代码与 Adobe 存储库同步。

NOTE
此功能为公共 GitHub 所独有。不支持自托管 GitHub。

配置 configuration

配置包含两个主要步骤：

  1. 添加存储库
  2. 专用存储库所有权验证

添加存储库 add-repo

  1. 在Cloud Manager中，从​ 项目概述 ​页面，选择​ 存储库 ​选项卡以切换到​ 存储库 ​页面，然后单击​ 添加存储库。

  2. 在​ 添加存储库 ​对话框中，选择​ 专用存储库 ​作为存储库类型。

  3. 提供您的存储库的详细信息

    • 存储库名称 - 一个富有表现力的名称
    • 存储库 URL - 存储库的 URL，它必须以 .git 结尾
    • 描述（可选）- 存储库的更详细描述（如有必要）

    添加自己的存储库

  4. 选择​ 保存。

TIP
有关在Cloud Manager中管理存储库的详细信息，请参阅Cloud Manager存储库。

专用存储库所有权验证 validate-ownership

Cloud Manager 现已知道您的 GitHub 存储库，但它仍需要其访问权限。要授予访问权限，您需要安装 Adobe GitHub 应用程序并验证您是否拥有指定的存储库。

  1. 添加您自己的存储库后，私有存储库所有权验证 ​对话框打开。

    专用存储库所有权验证

  2. Cloud Manager 使用 GitHub 应用程序与您的存储库安全地交互。

    • 您的 GitHub 组织的所有者必须安装位于 https://github.com/apps/cloud-manager-for-aem 的应用程序并授予对存储库的访问权限。
    • 有关如何完成此操作的详细信息，请参阅GitHub的文档。

  3. 为了增强安全性，您必须在存储库的默认分支中创建秘密文件。选择​ 生成。

  4. 通过点按或单击​ 确认 ​以确认秘密文件的生成。

    确认密码生成

  5. 返回​ 专用存储库所有权验证 ​窗口中，Cloud Manager 已在​ 秘密文件内容 ​字段中生成私有文件内容。复制该字段中的内容。

    • 秘密文件的内容仅显示一次。如果在关闭此窗口之前未复制内容，请重新生成密码。

    复制秘密文件内容

  6. 在 GitHub 存储库的默认分支中创建一个名为 .well-known/adobe/cloud-manager-challenge 的新文件，将秘密文件内容粘贴到该文件中并进行保存。

  7. 安装应用且存储库中存在机密文件后，您可以在​ 私有存储库所有权验证 ​对话框中选择​ 验证。

可以按任意顺序安装应用程序并创建秘密文件。但必须先完成这两个步骤，之后才能进行验证。

在验证之前，存储库将以红色图标列出，表示它尚未验证且尚无法使用。

未经验证的存储库

Type ​列可轻松识别Adobe提供的存储库(Adobe)和您自己的GitHub存储库(GitHub)。

如果您以后需要返回到存储库以完成验证，请在​ 存储库 ​页面上，选择代表您刚刚添加的GitHub存储库的行中的省略号按钮，然后从下拉菜单中选择​ 所有权验证。

将专用存储库与 Cloud Manager 结合使用 using

在 Cloud Manager 中验证 GitHub 存储库后，便已完成集成，您可以在 Cloud Manager 中使用该存储库。

  1. 在创建提取请求时，GitHub 检查将自动启动。

    GitHub 检查

  2. 对于每个提取请求，将自动创建全栈代码质量管道。每次更新提取请求时，此管道将启动。

  3. GitHub 检查保持正在运行状态，直到代码质量检查完成。之后，代码质量结果将传播到 GitHub 检查。

    GitHub 代码质量检查

在关闭或合并提取请求时，将自动删除创建的全栈代码质量管道。

TIP
有关运行拉取请求检查时通过 GitHub 提供信息的详细信息，请参阅文档 GitHub 检查批注。
TIP
您可以控制自动创建的管道，验证对专用存储库的每个拉取请求。请参阅文档 GitHub 检查专用存储库的配置，了解更多信息。

将私有存储库与管道关联 pipelines

经过验证的专用存储库可以与全栈和前端管道相关联。

NOTE
专用存储库不支持 Web 层和配置管道。

限制 limitations

在 Cloud Manager 中使用专用存储库时会受到某些限制。

  • 使用Cloud Manager中的GitHub检查，无法暂停拉取请求验证。
    • 如果在 Cloud Manager 中验证 GitHub 存储库，则 Cloud Manager 将始终尝试验证为该存储库创建的提取请求。
  • 如果从您的 GitHb 组织中删除 Adobe GitHub 应用程序，这将删除所有存储库的提取请求验证功能。
  • 专用存储库不支持 Web 层和配置管道。
  • 在生产全栈管道上使用专用存储库时，不会创建和推送任何 Git 标记。
  • 当新的提交被推送到选定的分支时，使用专用存储库和提交构建触发器的管道不会自动启动。
  • 工件重用功能不适用于专用存储库。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab