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

在云中首次启动Citrix ADC设备时应用Citrix ADC VPX配置

2021年9月17日
由:
C 年代

您可以在云环境中首次启动Citrix ADC设备期间应用Citrix ADC VPX配置。这个阶段被称为preboot阶段在此文档中。因此，在某些情况下，如ADC池许可，可以在更短的时间内启动特定的VPX实例。此功能可在Microsoft Azure、谷歌Cloud平台和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-typemicro \——count 1 \——subnet-id subnet-08fc749671b2d077c \——key-name MyKeyPair \——security-group-ids sg-0b0384b66d7d692f9 \——user-data文件://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 mycloud .txt \

例子:

az vm create——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命令行提供预启动用户数据

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

——metdata -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-bootstrap >  < ns-config >

使用< NS-CONFIG >标记，以提供需要在预启动阶段应用于VPX实例的特定Citrix ADC VPX配置。

注意:

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

Citrix ADC配置

使用< NS-CONFIG >标记，以提供需要在预启动阶段应用于VPX实例的特定Citrix ADC 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 >标记包含两个脚本的详细信息。

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

script2

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