Application Delivery Management

从 GitHub 存储库导入和同步样书

假设您使用 CI/CD 进程进行开发的场景。或者,您正在管理 GitHub 中的所有应用程序源代码和部署对象的场景。

在 GitHub 存储库中,您可能已经创建了几本用于部署 Citrix ADC 配置和管理这些样本的样书。Citrix 应用程序和交付管理 (ADM) 也需要这些样书。现在,您可以直接将这些样本导入到 Citrix ADM 中。您无需手动将它们从 GitHub 复制然后上载到 Citrix ADM,也不需要手动同步 ADM 和 GitHub 中的文件。

现在,您可以在 Citrix ADM 中定义代表 GitHub 存储库的存储库。提供 GitHub 存储库 URL 以及您在 GitHub 中创建的用户名和密码(或 API 令牌)。这意味着,只有在 GitHub 中拥有有效帐户的授权用户才能导入和同步样书。

创建存储库后,您可以将 Citrix ADM 与您的 GitHub 存储库同步。Citrix ADM 连接到 GitHub 并导入在该存储库中找到的样本。然后,ADM 验证样本并将其添加到 Citrix ADM 中的样本列表中。如果样本无法验证,则不会添加到 Citrix ADM 中。更正错误并将更新版本提交到您的 GitHub 存储库。稍后,您可以尝试将它们导入或将它们再次同步到 Citrix ADM 中。

注意

  • 样书文件可以从 GitHub 存储库的任何分支导入和同步。

  • 您也可以导入和同步具有关联的依赖样书的样书。

  • 必须从 Citrix ADM GUI 或 API 手动启动来自 GitHub 存储库的样书的同步。也就是说,目前,样本的导入和同步不会基于 GitHub 提交活动自动进行。

添加存储库并从 GitHub 存储库导入样书

在开始之前,请确保您在 GitHub 中有一个有效的帐户。

您可以从 GitHub 存储库中的任何文件夹将样书文件导入 ADM。

  1. 在 Citrix ADM 中,导航到 应用程序 > 样本 > 存储库

  2. 单击添加。在 添加存储库 窗口中,输入以下参数:

    • 名称。键入存储库的名称。此名称可以与 GitHub 中的存储库名称相同,也可以与其他名称相同。

    • 存储库 URL。键入 GitHub 存储库的 URL。

    • 用户名和密码。键入用于访问 GitHub 帐户的用户名和密码。

    注意

    您也可以提供 API 令牌代替密码。API 令牌可以通过 HTTPS 使用代替 GitHub 的密码。有关如何为您的 GitHub 仓库创建 API 令牌的信息,请参阅有关 创建个人访问令牌的 GitHub 文档。

  3. 单击创建

    添加 GIT 存储库

    在 Citrix ADM 中创建存储库。

  4. 要导入或同步 样书,请在“存储库”页面中选择 存储库 ,然后单击“同步”。

您可以在此处使用的其他操作是:

  • 编辑。您可以编辑存储库 URL、用户名和密码(或 API 令牌)。

  • 删除。您可以删除存储库以及 Citrix ADM 中存在的所有样本,这些样本是之前从该 GitHub 存储库导入的。

    注意

    如果某个存储库具有与其关联的 ConfigPack 的任何样本,则无法从 Citrix ADM 中删除该存储库。首先,删除这些样书的所有配置包。稍后可以从 Citrix ADM 中删除存储库以清理该存储库中的样书。

  • 重置。您可以删除 Citrix ADM 中从该存储库同步的所有样本,而无需实际删除 Citrix ADM 中的存储库条目。

  • 列出文件。您可以看到 Citrix ADM 中源自 GitHub 存储库的所有样本的列表。

从 GitHub 存储库导入和同步样书