替换
替换用于定义简写名称，这些名称可以替换 StyleBook 中的复杂表达式，从而使 StyleBook 更具可读性。
当 StyleBook 中重复使用相同的表达式或值（例如常量值）时，替换也很有用。为参数使用替换名称允许您只更新替换值，而不是更新 StyleBook 中参数的所有出现位置，这可能会导致错误。
替换也用于定义值之间的映射。
列表中的每个替换都由一个键和一个值组成。该值可以是一个简单值、一个表达式、一个函数或一个映射。
在以下示例中，定义了两个替换。第一个是
http-port，可以用作 8181 的简写。通过使用替换，您可以在 StyleBook 的其余部分中将其引用为 $substitutions.http-port，而不是 8181。
替换:
http-port: 8181
您可以为端口号指定一个助记名称，并在 StyleBook 中的一个位置定义此端口号，无论它被使用了多少次。如果您想将端口号修改为 8080，您可以在替换部分修改它，并且更改将在使用助记名称
http-port 的任何地方生效。
以下示例展示了如何在组件中使用替换。
components:
-
name: my-lbvserver-comp
type: ns::lbvserver
properties:
name: $parameters.name + "-lb"
servicetype: HTTP
ipv46: $parameters.ip
port: **$substitutions.http-port**
lbmethod: $parameters.lb-alg
替换也可以是一个复杂表达式。以下示例展示了两个替换如何使用表达式。
substitutions:
app-rule: HTTP.REQ.HEADER("X-Test-Application").EXISTS
app-name: str("acme-") + $parameters.name + str("-app")
替换表达式也可以使用现有的替换表达式，如以下示例所示。
substitutions:
http-port: 8181
app-name: str("acme-") + $parameters.name + str($substitutions.http-port) + str("-app")
替换的另一个有用功能是映射，您可以在其中将键映射到值。以下是映射替换的一个示例。
substitutions:
secure-port:
true: int("443")
false: int("80")
secure-protocol:
true: SSL
false: HTTP
以下示例展示了如何使用 secure-port 和 secure-protocol 映射。
components:
-
name: my-lbvserver-comp
type: ns::lbvserver
properties:
name: $parameters.name + "-lb"
servicetype: $substitutions.secure-protocol[$parameters.is-secure]
ipv46: $parameters.ip
port: $substitutions.secure-port[$parameters.is-secure]
lbmethod: $parameters.lb-alg
这意味着，如果 StyleBook 用户为参数 is-secure 指定布尔值“true”，或在 NetScaler Console GUI 中选择与此参数对应的复选框，则此组件的
servicetype 属性被赋值为 SSL，并且 port 属性被赋值为 443。但是，如果用户为此参数指定“false”或清除 NetScaler Console GUI 中对应的复选框，则 servicetype 被赋值为 HTTP，并且端口被赋值为 80。
以下示例展示了如何将替换用作函数。替换函数可以接受一个或多个参数。参数可以是简单类型，例如字符串、数字、IP 地址、布尔值和其他类型。
替换：
生成负载均衡器名称(名称): $name + "-lb"
在此示例中，定义了一个名为“form-lb-name”的替换函数，它接受一个名为“name”的字符串参数 ****，并使用该参数创建一个字符串，将“-lb”后缀添加到 name 参数中的字符串。使用此替换函数的表达式如下所示：
$substitutions.form-lb-name("my")
它返回
my-lb。
考虑另一个示例：
替换：
内容交换策略优先级(优先级): 10100 - 100 * $priority
替换
cspol-priority 是一个函数，它接受一个名为“priority”的参数并使用它来计算值。在 StyleBook 的其余部分中，此替换显示为：
components:
-
name: cspolicy-binding-comp
type: ns::csvserver_cspolicy_binding
condition: not $parameters.is-default
properties:
name: $parameters.csvserver-name
policyname: $components.cspolicy-comp.properties.policyname
priority: $substitutions.cspol-priority($parameters.pool.priority)
替换也可以由键和值组成。该值可以是简单值、表达式、函数、映射、列表或字典。
以下是名为
slist 的替换示例，其值为列表：
substitutions:
slist:
- a
- b
- c
替换的值也可以是键值对的字典，如下面名为
sdict 的替换示例所示：
substitutions:
sdict:
a: 1
b: 2
c: 3
您可以通过组合列表和字典来创建更复杂的属性。例如，名为
slistofdict 的替换返回键值对列表。
slistofdict:
-
a: $parameters.cs1.lb1.port
b: $parameters.cs1.lb2.port
-
a: $parameters.cs2.lb1.port
b: $parameters.cs2.lb2.port
但是，在以下示例中，替换
sdictoflist 返回一个键值对，其中值本身是另一个列表。
sdictoflist:
a:
- 1
- 2
b:
- 3
- 4
在组件中，这些替换可以在 condition、properties、repeat 和 repeat-condition 构造中使用。
以下组件示例展示了如何使用替换来指定属性：
properties:
a: $substitutions.slist
b: $substitutions.sdict
c: $substitutions.slistofdict
d: $substitutions.sdictoflist
定义一个值为列表或字典的替换的用例是，当您配置内容交换虚拟服务器和多个负载均衡虚拟服务器时。由于所有绑定到相同内容交换虚拟服务器的负载均衡虚拟服务器可能具有相同的配置，因此请使用替换列表和字典来构建配置，以避免为每个负载均衡虚拟服务器重复相同的配置。
以下示例展示了
cs-lb-mon StyleBooks 中的替换和组件，用于创建内容交换虚拟服务器配置。在构建 cs-lb-mon StyleBooks 的属性时，复杂的替换“lb-properties”指定了与内容交换虚拟服务器关联的负载均衡虚拟服务器的属性。“lb-properties”替换是一个函数，它将名称、服务类型、虚拟 IP 地址、端口和服务器作为参数，并生成一个键值对作为其值。在 cs-pools 组件中，您可以将此替换的值分配给每个池的 lb-pool 参数。
substitutions:
cs-port[]:
true: int("80")
false: int("443")
lb-properties(name, servicetype, vip, port, servers):
lb-appname: $name
lb-service-type: $servicetype
lb-virtual-ip: $vip
lb-virtual-port: $port
svc-servers: $servers
svc-service-type: $servicetype
monitors:
-
monitorname: $name
type: PING
interval: $parameters.monitor-interval
interval_units: SEC
retries: 3
components:
-
name: cs-pools
type: stlb::cs-lb-mon
description: | Updates the cs-lb-mon configuration with the different pools provided. Each pool with rule result in a dummy LB vserver, cs action, cs policy, and csvserver_cspolicy_binding configuration.
condition: $parameters.server-pools
repeat: $parameters.server-pools
repeat-item: pool
repeat-condition: $pool.rule
repeat-index: ndx
properties:
appname: $parameters.appname + "-cs"
cs-virtual-ip: $parameters.vip
cs-virtual-port: $substitutions.cs-port($parameters.protocol == "HTTP")
cs-service-type: $parameters.protocol
pools:
-
lb-pool: $substitutions.lb-properties($pool.pool-name, "HTTP", "0.0.0.0", 0, $pool.servers)
rule: $pool.rule
priority: $ndx + 1
替换映射
您可以创建将键映射到值的替换。例如，考虑一个场景，您希望为每个协议（键）定义要使用的默认端口（值）。为此，请按如下方式编写替换映射。
substitutions:
port:
HTTP: 80
DNS: 53
SSL: 443
在此示例中，HTTP 映射到 80，DNS 映射到 53，SSL 映射到 443。要检索作为参数给定的特定协议的端口，请使用表达式
$substitutions.port\[$parameters.protocol\]
该表达式根据用户指定的协议返回值。
-
如果键是 HTTP，表达式返回 80
-
如果键是 DNS，表达式返回 53
-
如果键是 SSL，表达式返回 443
-
如果映射中不存在该键，表达式不返回任何值
遍历替换列表
在以下示例中，StyleBook 遍历名为
apps 的替换列表，以创建一组 lbvserver 组件及其相应的服务组和绑定服务器。
substitutions:
apps:
-
name: lb1
vip: 1.2.3.4
vport: 80
protocol: HTTP
servers:
-
ip: 10.8.11.11
port: 8080
-
ip: 10.8.11.12
port: 8080
-
name: lb2
vip: 1.2.3.5
vport: 81
protocol: HTTP
servers:
-
ip: 10.9.11.28
port: 8080
-
ip: 10.9.11.29
port: 8181
components:
-
name: lbvserver-comp
type: ns::lbvserver
repeat: $substitutions.apps
repeat-item: app
properties:
name: $app["name"]
ipv46: $app["vip"]
port: $app["vport"]
servicetype: $app["protocol"]
components:
-
name: servicegroup-comp
type: ns::servicegroup
properties:
servicegroupname: $parent.properties.name + "-svg"
servicetype: HTTP
components:
-
name: servers-comp
type: ns::server
repeat: $app["servers"]
repeat-item: server
properties:
name: $server["ip"]
ipaddress: $server["ip"]
components:
-
name: servicegroup-servicegroupmember-binding-comp
type: ns::servicegroup_servicegroupmember_binding
properties:
servicegroupname: $parent.parent.properties.servicegroupname
servername: $parent.properties.name
port: $server["port"]