导入自定义样书
构建样书后，必须将其导入 NetScaler Application Delivery Management (ADM) 才能使用。NetScaler ADM 允许您以 YAML 形式导入单个样本或多个样本 YAML 文件作为 .zip、.tgz 或 .gz 形式的捆绑包导入。NetScaler ADM 系统会在导入时验证您的样书。样书现已准备就绪，可用于创建配置。
NetScaler ADM 还具有内置的 YAML 编辑器，您可以使用该编辑器来撰写样本 YAML 内容。YAML 编辑器允许您从 NetScaler ADM GUI 本身验证 YAML 构造。您无需为这些验证检查使用单独的工具。内容根据 YAML 标准进行验证，并突出显示任何偏差。然后，您可以更正内容并尝试将样书导入 NetScaler ADM。内置的 YAML 编辑器在编写自己的样书时有两个优点。
- 颜色编码。编辑器显示按照 YAML 指南解析的样书内容，颜色编码可帮助您轻松区分键和 YAML 内容中定义的值。
- YAML 验证。在您输入时，系统会验证内容是否存在任何 YAML 错误，并且任何偏差都会立即突出显示。此验证允许您在 ADM 中导入样书之前编写符合 YAML 准则的文本。
注意：
目前，编辑器根据 YAML 指南验证内容。它不验证代码的正确性和印刷错误。
导入样书
-
在 NetScaler ADM 中，导航到“应用程序”>“配置”>“样书”，然后单击“导入新样书”。
-
单击以下选项之一导入样书。
-
文件 -从您的本地存储中选择所需的文件或文件捆绑。
注意：
在本示例中，导入您在
lb-vserver.yml样书中创建的样书以创建负载平衡虚拟服务器。
-
捆绑包 -NetScaler ADM 允许您以 YAML 格式导入多本样书。您可以导入多个以压缩 (.zip) 格式或压缩 (.tgz, .gz) 格式压缩的 YAML 样书文件。
现在，您可以在捆绑包中的每个样书中添加图标。确保包含 PNG、GIF 或 JPEG 格式的图标的资源文件夹。如果图标文件名与样书名称匹配，则图标会自动映射到样书。否则，请执行以下操作：
-
将
icon_mapping.json文件添加到资源文件夹中。 -
按如下方式映射
icon_mapping.json文件中的样书和图标：<StyleBook file name> : <icon file name> <!--NeedCopy-->
以下是示例样书捆绑包：
resources文件夹包含所需的图标。
在此示例中，
sharepoint.yaml和skype.yaml文件分别自动映射到sharepoint.jpeg和skype.png。要映射
exchange.yaml到exch.png，请在icon_mapping.json文件中指定以下内容：{ "exchange.yaml":"exch.png" } <!--NeedCopy-->如果指定
defaulticon条目，则样书将映射到默认图标，除非它们映射到其他图标。defaulticon: <icon file name> <!--NeedCopy-->在“应用程序”>“样书”中，导入的样书将与映射的图标一起显示。
-
-
Raw -在 YAML 编辑器中撰写样书的内容。
您可以验证样书内容以检查样书语法错误。要验证样书内容，请单击“验证内容”。
注意：
在撰写样书时，请务必了解以下概念：
- NITRO API
- YAML
有关如何编写自己的样书的详细信息，请参阅 如何创建自己的样书。
-
同步存储库 -此选项列出添加到 ADM 的存储库。选择要与 ADM 同步的存储库。
注意：
您也可以将样本 YAML 文件中的内容复制并粘贴到 YAML 编辑器中。
-
-
可选，选择样书的图标。
在“应用程序”>“样书”中，导入的样书将显示带有此图标。
-
单击创建。
NetScaler ADM 现在根据样本语法验证样本是否存在所有语法和语义错误。如果出现任何错误，则不会将您的样书导入到 NetScaler ADM 中。
如果没有错误，则样书将成功导入并在 样书 页面上列出。您可以通过在样书标题部分中定义的显示名称来识别样书。
注意：
如果您要导入文件包，NetScaler ADM 会解压缩压缩后的文件夹并验证所有样书。 即使一个样本文件未通过验证测试，也不会导入捆绑包。
有关不同结构和属性的样书语法和语法的详细信息，请参阅 样书语法。
-
单击 创建配置 链接可通过此样书创建配置。
样书将以用户界面页面形式打开，您可以在此为此样书中定义的所有参数输入值。
-
指定参数所需值。
在下面的例子中，
-
指定 应用程序名称 和 负载平衡器 IP 地址 必填字段。
-
从列表中选择 负载平衡算法 。默认情况下，会选中 ROUNDROBIN。
-
-
在 目标实例下，选择要在其中部署配置的 NetScaler 实例的 IP 地址。
您还可以根据需要指定任意数量的目标实例，在多个 NetScaler 上部署配置。
-
如果要在部署配置之前在 NetScaler (NITRO) 配置对象进行测试，请单击“干运行”。
如果配置有效，则会根据指定的值创建配置对象。
在此示例中，样书只创建一个类型的对象
lbvserver。此负载平衡服务器是此基本示例样书中定义的唯一组件。稍后，单击 创建 以在选定的 NetScaler 实例上部署配置。
成功部署配置后，“配置”页面中会出现一个新的 配置 包。
注意：
您还可以单击刷新图标，将 NetScaler ADM 中最近发现的 NetScaler 实例添加到此窗口中的可用实例列表中。
搜索自定义风格书
NetScaler ADM 现在允许您根据其类型搜索 样书。也就是说，您现在可以搜索默认样书或自定义 样书。当您必须在许多默认样书中搜索用户定义的样书时，这个选项特别有用。
搜索自定义样书
-
在 NetScaler ADM 中，导航到 应用程序 > 配置 > 样本。
-
单击右上角的搜索图标。
-
在搜索栏中，选择“类型”，然后从子列表中选择“自定义”。
-
NetScaler ADM 仅显示用户定义的样式手册。