Application Delivery Management

导入自定义样书

February 6, 2024

投稿者:

构建样书后，必须将其导入 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 格式的图标的资源文件夹。如果图标文件名与样书名称匹配，则图标会自动映射到样书。否则，请执行以下操作：
  1. 将 icon_mapping.json 文件添加到资源文件夹中。
  2. 按如下方式映射 icon_mapping.json 文件中的样书和图标：
    <StyleBook file name> : <icon file name> 
  以下是示例样书捆绑包：
  
  resources 文件夹包含所需的图标。
  
  在此示例中，sharepoint.yaml 和 skype.yaml 文件分别自动映射到 sharepoint.jpeg 和 skype.png。
  
  要映射 exchange.yaml 到 exch.png，请在 icon_mapping.json 文件中指定以下内容：
```
 {
 "exchange.yaml":"exch.png"
 }
 
```
  如果指定 defaulticon 条目，则样书将映射到默认图标，除非它们映射到其他图标。
```
 defaulticon: <icon file name>
 
```
  在“应用程序”>“样书”中，导入的样书将与映射的图标一起显示。
- Raw -在 YAML 编辑器中撰写样书的内容。
  
  您可以验证样书内容以检查样书语法错误。要验证样书内容，请单击“验证内容”。
  注意
  
  在撰写样书时，请务必了解以下概念：
  - NITRO API
  - YAML
  有关如何编写自己的样书的详细信息，请参阅如何创建自己的样书。
- 同步存储库 -此选项列出添加到 ADM 的存储库。选择要与 ADM 同步的存储库。
注意

您还可以将样书 YAML 文件中的内容复制并粘贴到 YAML 编辑器中。
可选，选择样书的图标。

在“应用程序”>“样书”中，导入的样书将显示带有此图标。
单击创建。

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

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

注意

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

有关不同结构和属性的样书语法和语法的详细信息，请参阅样书语法。
单击 创建配置 链接可通过此样书创建配置。

样书将以用户界面页面形式打开，您可以在此为此样书中定义的所有参数输入值。
指定参数所需值。

在下面的例子中，
1. 指定 应用程序名称 和 负载平衡器 IP 地址 必填字段。
2. 从列表中选择 负载平衡算法 。默认情况下，会选中 ROUNDROBIN。
在 目标实例下，选择要在其中部署配置的 NetScaler 实例的 IP 地址。

您还可以根据需要指定任意数量的目标实例，在多个 NetScaler 上部署配置。
如果要在部署配置之前在 NetScaler (NITRO) 配置对象进行测试，请单击“干运行”。

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

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

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

成功部署配置后，“配置”页面中将显示一个新的配置包。

注意

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

搜索自定义风格书

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

搜索自定义样书

在 NetScaler ADM 中，导航到 应用程序 > 配置 > 样本。
单击右上角的搜索图标。
在搜索栏中，选择“类型”，然后从子列表中选择“自定义”。
NetScaler ADM 仅显示用户定义的样式手册。

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

导入自定义样书

February 6, 2024

投稿者:

February 6, 2024

投稿者: