产品文档
Citrix ADC
当前版本 13.0 12.1
查看PDF

在云中的Citrix ADC设备的第一次引导时应用Citrix ADC VPX配置

2021年9月17日
由:
C 年代

您可以在云环境中Citrix ADC设备的首次引导期间应用Citrix ADC VPX配置。这个阶段被称为preboot阶段。因此，在某些情况下，如ADC池授权，一个特定的VPX实例会在更短的时间内出现。此功能在Microsoft Azure、谷歌云平台和AWS云中可用。

什么是用户数据

在云环境中提供VPX实例时，可以选择将用户数据传递给该实例。用户数据允许您执行常见的自动化配置任务，自定义实例的启动行为，并在实例启动后运行脚本。在第一次引导时，Citrix ADC VPX实例执行以下任务:

  • 读取用户数据。
  • 解释用户数据中提供的配置。
  • 在启动时应用新添加的配置。

如何在云实例中提供预启动用户数据

您可以以XML格式向云实例提供预引导用户数据。不同的云有不同的接口来提供用户数据。

使用AWS控制台提供预引导用户数据

使用AWS控制台提供Citrix ADC VPX实例时，请导航到配置实例详细信息>高级信息，并提供启动前用户数据配置用户数据字段。

有关每个步骤的详细说明，请参见通过AWS web控制台在AWS上部署Citrix ADC VPX实例．有关详细信息，请参阅AWS文档启动实例．

AWS控制台用户数据

通过AWS CLI提供预启动用户数据

在AWS命令行中输入以下命令:

Aws ec2 run-instances \——image-id ami-0abcdef1234567890 \——instance-type t2。micro \——count 1 \——subnet-id subnet-08fc749671b2d077c \——key-name MyKeyPair \——security-group-ids sg-0b0384b66d7d692f9 \——user-data file://my_script.txt

有关详细信息，请参阅AWS文档运行的实例．

有关详细信息，请参阅AWS文档使用实例用户数据

使用Azure控制台提供预引导用户数据

使用Azure控制台提供Citrix ADC VPX实例时，请导航到创建虚拟机> Advanced选项卡。在自定义数据字段，提供启动前用户数据配置。

Azure控制台

使用Azure CLI提供预引导用户数据

在Azure CLI中输入以下命令:

az vm create \——resource-group myResourceGroup \——name MyVm \——image debian \——custom-data MyCloudInitScript.txt \

例子:

az虚拟机创建——resource-group MyResourceGroup name MyVm——image debian——custom-data MyCloudInitScript.txt

您可以将自定义数据或预引导配置作为文件传递给" -custom-data "参数。在此例中，文件名为MyCloudInitScript.txt．

有关更多信息，请参见Azure CLI文档．

使用GCP控制台提供预引导用户数据

使用GCP控制台提供Citrix ADC VPX实例时，需要填写实例的属性。扩大管理，安全，磁盘，网络，独租．导航到管理选项卡。在自动化中提供启动前用户数据配置启动脚本字段。

有关使用GCP创建VPX实例的详细信息，请参见在谷歌云平台上部署Citrix ADC VPX实例．

GCP控制台

通过gcloud CLI提供预启动用户数据

在GCP命令行中输入以下命令:

gcloud计算实例创建INSTANCE_NAMES——metadata-from-file=startup-script=LOCAL_FILE_PATH

metadata-from-file—从存储在。的文件中读取值或用户数据 ．

有关更多信息，请参见gcloud CLI文档

预启动用户数据格式

预引导用户数据必须以XML格式提供给云实例。您在引导期间通过云基础设施提供的Citrix ADC预引导用户数据可以包括以下四个部分:

  • 的Citrix ADC配置表示< NS-CONFIG >标签。
  • 属性表示的Citrix ADC的自定义自引导< NS-BOOTSTRAP >标签。
  • 属性表示的Citrix ADC中存储用户脚本< NS-SCRIPTS >标签。
  • 属性表示的合用许可配置< NS-LICENSE-CONFIG >标签。

您可以在ADC预引导配置中以任意顺序提供前面四个部分。在提供预引导用户数据时，请确保严格遵循以下部分中显示的格式。

注意:

启动前的整个用户数据配置必须包含在< NS-PRE-BOOT-CONFIG >标签，如下面的例子所示。

示例1:

< ns-pre-boot-config > < ns-config >  < ns-bootstrap >  < ns-scripts >  < ns-license-config >

示例2:

< ns-pre-boot-config > < ns-license-config >  < ns-scripts >  < ns-bootstrap >  < ns-config >

使用< NS-CONFIG >标签提供特定的Citrix ADC VPX配置，需要在预引导阶段应用到VPX实例。

注意:

的< NS-CONFIG >节必须有有效的ADC CLI命令。不验证cli的语法错误或格式。

Citrix ADC配置

使用< NS-CONFIG >标签提供特定的Citrix ADC VPX配置，需要在预引导阶段应用到VPX实例。

注意:

的< NS-CONFIG >节必须有有效的ADC CLI命令。不验证cli的语法错误或格式。

例子:

在下面的示例中，使用< NS-CONFIG >部分提供了配置的详细信息。配置ID为“5”的VLAN，并与SNIP(5.0.0.1)绑定。还配置了负载均衡虚拟服务器(4.0.0.101)。

ADC配置

你可以从这里复制上面截图中的配置:

< NS-PRE-BOOT-CONFIG > < NS-CONFIG >添加vlan 5添加ns ip 5.0.0.1 255.255.255.0绑定vlan 5 ipaddress 5.0.0.1 255.255.255.0启用ns特性西城SP磅应答器添加服务器5.0.0.201 5.0.0.201添加服务preboot_s5_201 5.0.0.201 HTTP 80 -gslb没有maxclient -maxReq 0 cip禁用切实不-useproxyport是的- SP -cltTimeout 180 -svrTimeout 360 -CKA没有-TCPB cmp加磅vserver preboot_v4_101 HTTP 4.0.0.101 80 -persistenceType没有-cltTimeout 180 < / NS-CONFIG > < / NS-PRE-BOOT-CONFIG > < !——NeedCopy >

Citrix ADC VPX实例将出现应用于< NS-CONFIG >节，如下图所示。

验证VLAN配置

验证服务器配置

用户脚本

使用< NS-SCRIPTS >标签提供任何必须在Citrix ADC VPX实例中存储和运行的脚本。

类中可以包含许多脚本< NS-SCRIPTS >标签。每个脚本必须包含在< >脚本标签。每一个< >脚本节对应于一个脚本，并使用以下子标记包含脚本的所有详细信息。

  • <脚本名>:需要保存的脚本文件名。
  • <脚本内容>:指示必须存储的文件的内容。
  • < SCRIPT-TARGET-LOCATION >:指示必须将此文件存储在其中的指定目标位置。如果没有提供目标位置，默认情况下，文件或脚本保存在“/nsconfig”目录中。
  • < SCRIPT-NS-BOOTUP >:指定用于运行脚本的命令。
    • 如果你使用< SCRIPT-NS-BOOTUP >节中提供的命令存储在“/nsconfig/nsafter.sh”中，这些命令在包引擎启动后作为“nsafter.sh”执行的一部分运行。
    • 如果您不使用< SCRIPT-NS-BOOTUP >节中，脚本文件将存储在指定的目标位置中。

示例1:

在本例中，< NS-SCRIPTS >标签只包含一个脚本的详细信息:script-1.sh。“script-1.sh”脚本保存在“/var”目录下。该脚本将填充指定的内容，并在包引擎启动后使用“sh /var/script-1.sh”命令运行。

Script1

你可以从这里复制上面截图中的配置:

在下面的快照中，可以验证“script-1.sh”脚本是否保存在“/var/”目录下。运行“script -1.sh”脚本，并相应地创建输出文件。

script1输出

示例2:

在下面的示例中，使用< NS-SCRIPTS >标签包含两个脚本的详细信息。

  • 第一个脚本以“script-1.sh”的形式保存在“/var”目录下。该脚本由指定的内容填充，并在包引擎启动后使用命令“sh /var/script-1.sh”运行。
  • 第二个脚本以“file-2.txt”的形式保存在“/var”目录下。该文件由指定的内容填充。但是由于bootup执行命令，它不会运行< SCRIPT-NS-BOOTUP >未提供。

script2

你可以从这里复制上面截图中的配置: