Application Delivery Management

从 GitHub 存储库导入和同步 StyleBook

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

在 GitHub 存储库中,您可能已创建了多个 StyleBook,用于部署 NetScaler 配置和管理这些 StyleBook。Citrix Applications and Delivery Management (ADM) 中也需要这些 StyleBook。现在,您可以将这些 StyleBook 直接导入到 NetScaler ADM 中。您无需手动从 GitHub 复制它们,然后将其上传到 NetScaler ADM,也无需手动同步 ADM 和 GitHub 中的文件。

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

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

注意

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

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

  • 从 GitHub 存储库同步 StyleBook 必须从 NetScaler ADM GUI 或 API 手动启动。也就是说,目前 StyleBook 的导入和同步不会根据 GitHub 提交活动自动进行。

添加存储库并从 GitHub 存储库导入 StyleBook

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

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

  1. 在 NetScaler ADM 中,导航到 Applications > StyleBooks > Repositories

  2. 单击 Add。在 Add Repository 窗口中,输入以下参数:

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

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

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

    注意

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

  3. 单击 Create

    添加 GIT 存储库

    存储库在 NetScaler ADM 中创建。

  4. 要导入或同步 StyleBook,请在 Repositories 页面中选择存储库,然后单击 Sync

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

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

  • Delete。您可以删除存储库以及之前从该 GitHub 存储库导入到 NetScaler ADM 中的所有 StyleBook。

    注意

    如果存储库中包含任何具有关联 ConfigPack 的 StyleBook,则无法从 NetScaler ADM 中删除该存储库。首先,删除这些 StyleBook 的所有配置包。稍后,您可以从 NetScaler ADM 中删除该存储库,以清除该存储库中的 StyleBook。

  • Reset。您可以删除从该存储库同步到 NetScaler ADM 中的所有 StyleBook,而无需实际删除 NetScaler ADM 中的存储库条目。

  • List files。您可以查看 NetScaler ADM 中源自 GitHub 存储库的所有 StyleBook 的列表。

从 GitHub 存储库导入和同步 StyleBook