导入自定义样书
构建样本后,必须将其导入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的存储库。选择要与ADM同步的存储库。
注意
您还可以将样书YAML文件中的内容复制并粘贴到YAML编辑器中。
可选,选择样书的图标。
在“应用程序“>”样的书“中,导入的样书随此图标显示。
单击创建。
Citrix ADM现在根据样本语法验证样本是否存在所有语法和语义错误。如果存在任何错误,则不会将样本导入到Citrix ADM中。
如果没有错误,则样书将成功导入并在样书页面上列出。您可以通过在样本的标题部分中定义的显示名称来识别样本。
注意
如果要导入文件包,Citrix ADM会解压缩压缩文件夹并验证所有样本。即使一个样本文件未通过验证测试,也不会导入捆绑包。
有关样本语法和不同构造和属性语法的更多信息,请参阅样本语法。
单击”创建配置“链接,从此样书创建配置。
样本将以用户界面页面形式打开,您可以在此为此样本中定义的所有参数输入值。
指定参数所需的值。
在以下示例中,
指定应用程序名称和负载均衡器IP地址必填字段。
从列表中选择负载平衡算法。默认情况下,将选择”设置轮流捡取”。
![配置示例部署)(/ en - us / citrix-application-delivery-management-service /媒体/ nmas -样本yaml -编辑- 4. - png)
在“目标实例“下,选择要在其中部署配置的Citrix ADC实例的IP地址。
您还可以通过根据需要指定任意数量的目标实例,在多个Citrix ADC上部署配置。
如果要在部署配置之前在Citrix ADC(硝基)配置对象上进行测试,请单击干运行。
如果配置有效,则会根据指定的值创建配置对象。
在此示例中,样书只创建一个类型的对象
lbvserver
。此负载平衡服务器是此基本示例样书中定义的唯一组件。稍后,单击创建以在选定的Citrix ADC实例上部署配置。
成功部署配置后,“配置”页中将显示一个新的配置包。
注意
您还可以单击刷新图标,将Citrix ADM中最近发现的Citrix ADC实例添加到此窗口中的可用实例列表中。
搜索自定义样本
Citrix ADM现在允许您根据样本类型搜索样本。也就是说,您现在可以搜索默认样本或自定义样本。当您必须在许多默认样书中搜索用户定义的样书时,此选项尤其有用。
搜索自定义样本
在Citrix ADM中,导航到应用程序>配置>样本。
单击右上角的搜索图标。
在搜索栏中,选择”类型”,然后从子列表中选择”自定义”。
Citrix ADM仅显示用户定义的样本。