导入自定义样本

构建样书后,您必须将其导入 NetScaler 应用程序交付管理 (ADM) 才能使用它。 NetScaler ADM 允许您以 YAML 格式导入单个样书,或以 .zip、.tgz 或 .gz 格式将多个样书 YAML 文件作为捆绑包导入。 NetScaler ADM 系统会在导入时验证您的样书。 样书现在可用于创建配置。

NetScaler ADM 还具有内置 YAML 编辑器,您可以使用它来编写 StyleBook YAML 内容。 YAML 编辑器允许您从 NetScaler ADM GUI 本身验证您的 YAML 构造。 您不需要使用单独的工具进行这些验证检查。 内容根据 YAML 标准进行验证,任何偏差都会突出显示。 然后,您可以更正内容并尝试将样书导入 NetScaler ADM。 内置的 YAML 编辑器在编写您自己的 StyleBook 时提供了两个优势。

笔记

目前,编辑器根据 YAML 指南验证内容。 它不验证代码的正确性和印刷错误。

导入样本

  1. 在 NetScaler ADM 中,导航到 应用程序 > 配置 > 样本,然后单击 导入新样本

  2. 单击以下选项之一来导入样本。

笔记

在此示例中,导入您在 样书中创建的 lb-vserver.yml 样书以创建负载平衡虚拟服务器

    ![导入样本文件](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-1-citrix.png)

-  **Bundle** - NetScaler ADM 允许您导入 YAML 格式的多个 StyleBook。 您可以导入多个以 zip (.zip) 格式或 tarball (.tgz、.gz) 格式压缩的 YAML StyleBook 文件。

    ![导入样本包](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-5-citrix.png)

    您现在可以将图标添加到捆绑包中的每个样本中。 确保资源文件夹包含 PNG、GIF 或 JPEG 格式的图标。 如果图标文件名与样本名称匹配,则图标会自动映射到样本。 否则,请执行以下操作:

    1.  在资源文件夹中添加 `icon_mapping.json` 文件。

    2.  在 `icon_mapping.json` 文件中映射 StyleBooks 和图标,如下所示:

        ```yaml
        <StyleBook file name> : <icon file name>
        <!--NeedCopy--> ```

    以下是样书包示例:

    ![带有图标的 StyleBook 包](/en-us/netscaler-application-delivery-management-software/media/stylebook-icons-bundle.png)

    `资源` 文件夹包含所需的图标。

    ![资源文件夹中的图标](/en-us/netscaler-application-delivery-management-software/media/stylebook-resources-folder.png)

    在这个例子中, `sharepoint.yaml` 和 `skype.yaml` 文件分别自动映射到 `sharepoint.jpeg` 和 `skype.png` 。

    要将 `exchange.yaml` 映射到 `exch.png`,请在 `icon_mapping.json` 文件中指定以下内容:

    ```json
    {
    “exchange.yaml”:“exch.png” }
    <!--NeedCopy--> ```

    如果您指定 `defaulticon` 条目,则样书将映射到默认图标,除非它们映射到不同的图标。

    ```yaml
    默认图标: <icon file name>
    <!--NeedCopy--> ```

    在 **应用程序 > 样书**中,导入的样书会与映射的图标一起出现。

-  **Raw** - 在 YAML 编辑器中编写 StyleBook 的内容。

    您可以验证样书内容以检查样书语法错误。 要验证样本内容,请单击 **验证内容**。 > **笔记** > > 在编写 StyleBook 时,请务必了解以下概念: > > -  NITRO API > -  YAML

    有关如何编写自己的 StyleBook 的更多信息,请参阅 [如何创建自己的 StyleBook](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/how-to-create-custom-stylebooks.html)。

    ![使用 ADM YAML 编辑器创作样书](/en-us/netscaler-application-delivery-management-software/media/nmas-stylebooks-yaml-editor-2-citrix.png)

-       **同步存储库** - 此选项列出添加到 ADM 的存储库。 选择您想要与 ADM 同步的存储库。 > **笔记** > > 您还可以将 StyleBook YAML 文件中的内容复制并粘贴到 YAML 编辑器中。
  1. 可选,选择一个图标到样本中。

    应用程序 > 样书中,导入的样书会带有此图标。

  2. 单击 创建

    NetScaler ADM 现在根据样书语法验证样书是否存在所有句法和语义错误。 如果有任何错误,您的样书将不会导入 NetScaler ADM。

    如果没有错误,则表示样书已成功导入并列在 样书 页面上。 您可以通过在样书的标题部分中定义的显示名称来识别样书。

笔记

如果您要导入一包文件,NetScaler ADM 会解压缩压缩文件夹并验证所有样书。 即使一个样书文件未通过验证测试,也不会导入该捆绑包。

有关 StyleBook 语法和不同构造和属性的语法的更多信息,请参阅 [StyleBook 语法](/en-us/netscaler-application-delivery-management-software/13-1/stylebooks/stylebooks-grammar.html)。
  1. 单击 创建配置 链接从此样本创建配置。

    样本打开为一个用户界面页面,您可以在其中输入此样本中定义的所有参数的值。

  2. 指定参数所需的值。

    在以下示例中,

    1. 指定 应用程序名称负载均衡器 IP 地址 必填字段。

    2. 从列表中选择 负载平衡算法 。 默认情况下,选择 ROUNDROBIN

  3. 目标实例下,选择要部署配置的 NetScaler 实例的 IP 地址。

    您还可以根据需要指定尽可能多的目标实例,在多个 NetScaler 上部署配置。

  4. 如果您想在部署配置之前在 NetScaler (NITRO) 配置对象上进行测试,请单击 Dry Run

    如果配置有效,则根据指定的值创建配置对象。

    在此示例中,StyleBook 仅创建一个类型为 lbvserver的对象。 该负载平衡服务器是此基本示例样书中定义的唯一组件。

    稍后,单击 创建 在选定的 NetScaler 实例上部署配置。

成功部署配置后, 配置 页面中会出现一个新的配置包。

笔记

您还可以单击刷新图标,将 NetScaler ADM 中最近发现的 NetScaler 实例添加到此窗口中的可用实例列表中。

搜索自定义样本

NetScaler ADM 现在允许您根据类型搜索样书。 也就是说,您现在可以搜索默认样本或自定义样本。 当您必须在众多默认样本中搜索用户定义的样本时,此选项特别有用。

搜索自定义样本

  1. 在 NetScaler ADM 中,导航到 应用程序 > 配置 > 样书

  2. 单击右上角的搜索图标。

  3. 在搜索栏中,选择 类型 ,然后从子列表中选择 自定义

  4. NetScaler ADM 仅显示用户定义的样本。