从 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 中。
注意
-
StyleBook 文件可以从 GitHub 存储库的任何分支导入和同步。
-
您还可以导入和同步具有关联依赖 StyleBook 的 StyleBook。
-
从 GitHub 存储库同步 StyleBook 必须从 NetScaler ADM GUI 或 API 手动启动。也就是说,目前 StyleBook 的导入和同步不会根据 GitHub 提交活动自动发生。
添加存储库并从 GitHub 存储库导入 StyleBook
在开始之前,请确保您在 GitHub 中拥有一个有效帐户。
您可以将 StyleBook 文件从 GitHub 存储库中的任何文件夹导入到 ADM。
-
在 NetScaler ADM 中,导航到 Applications > StyleBooks > Repositories。
-
单击 Add。在 Add Repository 窗口中,输入以下参数:
-
名称。键入存储库的名称。此名称可以与 GitHub 中的存储库名称相同,也可以不同。
-
存储库 URL。键入 GitHub 存储库 URL。
-
用户名和密码。键入用于访问 GitHub 帐户的用户名和密码。
注意您还可以提供 API 令牌而不是密码。API 令牌可用于代替密码通过 HTTPS 访问 GitHub。有关如何为 GitHub 存储库创建 API 令牌的信息,请参阅 GitHub 文档中关于创建个人访问令牌的内容。 -
-
单击创建。
存储库在 NetScaler ADM 中创建。 -
要导入或同步 StyleBook,请在存储库页面中选择存储库,然后单击同步。
您可以在此处使用的其他操作包括:
-
编辑。您可以编辑存储库 URL、用户名和密码(或 API 令牌)。
-
删除。您可以删除存储库以及 NetScaler ADM 中以前从该 GitHub 存储库导入的所有 StyleBook。注意如果 NetScaler ADM 中的存储库包含任何关联了 ConfigPack 的 StyleBook,则无法删除该存储库。首先,删除这些 StyleBook 的所有配置包。之后,您可以从 NetScaler ADM 中删除存储库,以清除该存储库中的 StyleBook。
-
重置。您可以删除 NetScaler ADM 中从该存储库同步的所有 StyleBook,而无需实际从 NetScaler ADM 中删除存储库条目。
-
列出文件。您可以查看 NetScaler ADM 中源自 GitHub 存储库的所有 StyleBook 的列表。