导入 StyleBook

Last published : Oct 06, 2026
这是 StyleBook 的第二部分,允许您声明要从当前 StyleBook 引用哪些其他 StyleBook。这使您能够导入和重用其他 StyleBook,而不是在自己的 StyleBook 中重新构建相同的配置。这是一个强制性部分。
您必须声明要在当前 StyleBook 中引用的 StyleBook 的 namespace 和 version 号。如果任何 StyleBook 直接使用 NITRO 配置对象,则必须引用 netscaler.nitro.config 命名空间。此命名空间包含所有 NetScaler NITRO 类型,例如 lbvserver 服务或监视器。支持 NetScaler 10.5 及更高版本的 StyleBook,这意味着您可以使用 StyleBook 在运行 10.5 或更高版本的任何 NetScaler 实例上创建和运行配置。
import-stylebooks 部分中使用的 prefix 属性是引用命名空间和版本组合的简写。例如,“ns”前缀可用于引用版本为 10.5 的 netscaler.nitro.config 命名空间。在 StyleBook 的后续部分中,您无需每次引用具有此命名空间和版本的 StyleBook 时都使用命名空间和版本,只需使用所选的前缀字符串以及 StyleBook 的名称即可唯一标识它。
示例:

     import-stylebooks:
      -
        namespace: netscaler.nitro.config
        version: "10.5"
        prefix: ns
     -
      namespace: com.acme.stylebooks
       version: "0.1"
       prefix: stlb
在上面的示例中,定义的第一个前缀称为 ns,它引用命名空间 netscaler.nitro.config 和版本 10.5。定义的第二个前缀称为 stlb,它引用命名空间 com.acme.stylebooks 和版本 0.1。
定义前缀后,每当您要引用属于特定命名空间和版本的类型或 StyleBook 时,都可以使用表示法 \<namespace-shorthand\>::\<type-name\>。例如,ns::lbvserver 引用在 netscaler.nitro.config 命名空间(版本 10.5)中定义的 lbvserver 类型。
同样,如果您想引用 com.acme.stylebooks 命名空间中版本为“0.1”的 StyleBook,可以使用表示法 stlb::\<stylebook-name\>。
注意
按照惯例,前缀“ns”用于指代 NetScaler 的 NITRO 命名空间。