从外部存储库导入并同步样本

考虑一下您正在使用 CI/CD 流程进行开发的场景。 或者，您正在管理 GitHub/GitLab 中的所有应用程序源代码和部署对象。

在 GitHub/GitLab 存储库中，您可能已经创建了多个样书，用于部署 NetScaler 配置和管理这些样书。 NetScaler 控制台也需要这些样书。 现在，您可以将这些样书直接导入 NetScaler 控制台。 您无需手动从 GitHub/GitLab 复制它们，然后将它们上传到 NetScaler Console 或手动同步 NetScaler Console 和 GitHub/GitLab 中的文件。

要导入样书和配置包，请在 NetScaler 控制台中定义一个代表 GitHub/GitLab 存储库的存储库。 提供 GitHub/GitLab 存储库 URL 以及您的用户名和在 GitHub/GitLab 中创建的 API 或个人访问 (PA) 令牌。 这意味着，只有在 GitHub/GitLab 拥有有效帐户的授权用户才能导入和同步 StyleBooks。

您可以导入和同步以下类型的存储库：

• 可公开访问的存储库 - 向公众开放并可通过互联网访问的存储库。
• 内部部署或私有 GitLab/GitHub 存储库 - 私有托管的存储库，通常只能在企业内部网内访问。 对于这些存储库，您必须在注册过程中选择一个 NetScaler 代理。 NetScaler 代理充当访问企业内联网内的存储库的代理。

创建存储库后，您可以将 NetScaler 控制台与您的 GitHub/GitLab 存储库同步。 NetScaler 控制台连接到 GitHub/GitLab 并导入在该存储库中找到的 StyleBooks。 然后，NetScaler 控制台会验证样书并将其添加到 NetScaler 控制台中的样书列表中。 如果样书验证失败，则不会添加到 NetScaler 控制台。 纠正错误并将更新的版本提交到您的 GitHub/GitLab 存储库。 稍后您可以尝试将它们导入或再次同步到 NetScaler 控制台。

笔记

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

• 您还可以导入和同步具有与其关联的从属样书的样书。

• 必须从 NetScaler 控制台 GUI 或 API 手动启动来自 GitHub/GitLab 存储库的 StyleBooks 同步。 也就是说，目前，StyleBooks 的导入和同步不会根据 GitHub/GitLab 提交活动自动进行。

添加存储库并从外部存储库导入样书

开始之前，请确保您在 GitHub/GitLab 中有一个有效帐户。

您可以从 GitHub/GitLab 存储库中的任何文件夹将 StyleBook 文件导入 NetScaler 控制台。

1. 在 NetScaler 控制台中，导航到 应用程序 > StyleBooks > 存储库。

2. 单击 添加。 在 Add Repository 窗口中，输入以下参数：

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

   • 存储库 URL - 输入 GitHub/GitLab 存储库 URL。

     您可以指定 GitHub/GitLab 企业 URL。 它可以帮助您从 GitHub/GitLab 企业帐户导入或同步 StyleBooks 和配置包。

   • 它是私人 URL 吗？ - 如果存储库是本地或私有 GitLab/GitHub 存储库，请选中此复选框，然后选择 代理。

   • 用户名和密码。 输入访问 GitHub/GitLab 帐户的用户名和密码。

笔记

您还可以提供 API 令牌来代替密码。 可以使用 API 令牌代替 HTTPS 上的 GitHub/GitLab 密码。 有关如何为您的 GitHub/GitLab 存储库创建 API/PA 令牌的信息，请参阅 GitHub/GitLab 文档中的 创建个人访问令牌。

1. 单击 创建。

   

   

   该存储库是在 NetScaler 控制台中创建的。

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

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

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

• 删除。 您可以删除该存储库以及之前从该 GitHub/GitLab 存储库导入的 NetScaler 控制台中存在的所有样书。

笔记

如果存储库具有任何与 ConfigPack 关联的样书，则无法从 NetScaler 控制台中删除该存储库。 首先，删除这些样书的所有配置包。 您稍后可以从 NetScaler 控制台中删除存储库，以清理该存储库中的样书。

• 重置。 您可以删除 NetScaler 控制台中从该存储库同步的所有样书，而无需实际从 NetScaler 控制台中删除存储库条目。

• 列出文件。 您可以看到 NetScaler 控制台中来自 GitHub/GitLab 存储库的所有样书的列表。

从 GitHub/GitLab 导入样书和配置包的步骤

完成先决条件后，按照以下步骤从 GitHub/GitLab 存储库导入样书和配置包：

1. 可选，如果尚未添加，请添加存储库。

2. 在“存储库”页面中选择存储库。

3. 点击 同步。