导入自定义样书
构建样本后,必须将其导入Citrix应用程序交付管理(ADM)才能使用它。Citrix ADM允许您以YAML形式导入单个样本或多个样本YAML文件作为. zip,。tgz或. gz形式的捆绑包导入。Citrix ADM 系统在导入时验证您的样本。样书现在可用于创建配置。
Citrix ADM还具有内置的YAML编辑器,您可以使用该编辑器来撰写样本YAML内容。YAML编辑器允许您从Citrix ADM GUI本身验证YAML构造。您无需为这些验证检查使用单独的工具。内容根据YAML标准进行验证,任何偏差都会突出显示。然后,您可以更正内容并尝试将样本导入Citrix ADM。内置的YAML编辑器在编写自己的样本时提供了两个优势。
- 颜色编码。编辑器显示按照YAML指南解析的样书内容,颜色编码可帮助您轻松区分键和YAML内容中定义的值。
- YAML验证。在您输入时，将验证内容是否存在任何 YAML 错误，并立即突出显示任何偏差。此验证允许您甚至在 Citrix ADM 中导入样书之前编写符合 YAML 准则的文本。
注意
目前,编辑器根据YAML指南验证内容。它不验证代码的正确性和排版错误。
导入样书
在Citrix ADM中,导航到应用程序>配置>样本”,然后单击导入新样本。
单击以下选项之一以导入样书。
文件-从您的本地存储中选择所需的文件或文件捆绑。
注意
在此示例中，导入您在中创建的
lb-vserver.yml样书用于创建负载平衡虚拟服务器的样本。![导入样书文件]()
捆绑citrix ADM允许您以YAML格式导入多个样本。您可以导入多个以压缩格(. zip)式或压缩(。tgz . gz)格式压缩的YAML样书文件。
![导入样书捆绑包]()
现在，您可以在捆绑包中的每个样书中添加图标。为此，请将图标和
icon_mapping.json文件上传到资源文件夹。如果图标文件名和样书名称匹配，则图标将自动映射到样书。否则，请按如下方式映射icon_mapping.json文件中的样书和图标：:<图标文件名称> 以下是示例样书捆绑包：
![带图标的样书捆绑包]()
资源文件夹包含所需的图标。![资源文件夹中的图标]()
在此示例中，
sharepoint.yaml和skype.yaml文件分别自动映射到sharepoint.jpeg和skype.png。要映射
exchange.yaml到exch.png，请在icon_mapping.json文件中指定以下内容：｛“exchange.yaml”：“exch.png”｝<！——NeedCopy >生——在YAML编辑器中撰写样本的内容。
您可以验证样书内容以检查样书语法错误。要验证样书内容，请单击验证内容。
注意
在撰写样书时，请确保了解以下概念：
- 硝基API
- YAML
有关如何编写自己的样本的更多信息，请参阅如何创建您自己的样本。
![使用ADM YAML编辑器创作样的书]()
同步存储库——此选项列出添加到ADM的存储库。选择要与ADM同步的存储库。
![同步ADM中的存储库]()
注意
您还可以将样书YAML文件中的内容复制并粘贴到YAML编辑器中。
可选，选择样书的图标。
在“应用程序“>”样的书“中,导入的样书随此图标显示。
![使用图标导入样书]()
单击创建。
Citrix ADM现在根据样本语法验证样本是否存在所有语法和语义错误。如果存在任何错误,则不会将样本导入到Citrix ADM中。
如果没有错误，则样书将成功导入并在样书页面上列出。您可以通过在样本的标题部分中定义的显示名称来识别样本。
![样书示例]()
注意
如果要导入文件包,Citrix ADM会解压缩压缩文件夹并验证所有样本。即使一个样本文件未通过验证测试，也不会导入捆绑包。
有关样本语法和不同构造和属性语法的更多信息，请参阅样本语法。
单击”创建配置“链接,从此样书创建配置。
样本将以用户界面页面形式打开，您可以在此为此样本中定义的所有参数输入值。
指定参数所需的值。
在以下示例中，
指定应用程序名称和负载均衡器IP地址必填字段。
从列表中选择负载平衡算法。默认情况下,将选择”设置轮流捡取”。
成功部署配置后,“配置”页中将显示一个新的配置包。
注意
您还可以单击刷新图标,将Citrix ADM中最近发现的Citrix ADC实例添加到此窗口中的可用实例列表中。
搜索自定义样本
Citrix ADM现在允许您根据样本类型搜索样本。也就是说，您现在可以搜索默认样本或自定义样本。当您必须在许多默认样书中搜索用户定义的样书时，此选项尤其有用。
搜索自定义样本
在Citrix ADM中,导航到应用程序>配置>样本。
单击右上角的搜索图标。
在搜索栏中,选择”类型”,然后从子列表中选择”自定义”。
Citrix ADM仅显示用户定义的样本。
