在配置作业中使用变量
配置作业是一组可以在一个或多个托管实例上运行的配置命令。当您在多个实例上运行相同的配置时,您可能希望为配置中使用的参数使用不同的值。您可以定义变量,使您能够为这些参数分配不同的值,或者跨多个实例运行作业。
例如,考虑一个基本负载均衡配置,其中添加一个负载均衡虚拟服务器,添加两个服务,并将这些服务绑定到虚拟服务器。现在,您可能希望在两个实例上使用相同的配置,但是虚拟服务器、服务名称和IP地址的值不同。通过使用变量定义虚拟服务器和服务的名称和IP地址,可以使用配置作业特性来实现这一点。
本例中使用的命令和变量如下:
add lb vserver **servername** HTTP **ipaddress portnumber** add service **servicename1** **ipaddress1** HTTP 80 add service **servicename2** **ipaddress2** HTTP 80 bind lb vserver **servername** **servicename1** bind lb vserver **servername** **servicename2**
通过在Citrix ADM中定义变量来创建一个配置作业:
导航到基础设施>配置>配置任务.
点击创建工作.
在创建工作页,选择自定义作业参数,如作业名称、实例类型和配置类型。
在Configuration Editor中,键入命令以添加一个负载均衡虚拟服务器、两个服务,并将这些服务绑定到虚拟服务器。双击选择要转换为变量的值,然后单击转换为变量.例如,选择负载均衡服务器的IP地址
ipaddress
,并单击转换为变量如下图所示。看到变量值被美元符号包围后,单击该变量以进一步指定变量的详细信息,如名称、显示名称和类型。您也可以单击先进的选项,如果您想进一步为变量指定默认值。点击保存然后,点击下一个.
输入剩下的命令并定义所有变量。
在单个合并视图中创建或编辑配置作业时,可以查看所定义的所有变量。
执行以下操作之一,在一个统一视图中查看所有变量:
- 在创建配置作业时,导航到基础设施>配置>配置任务中,选择创建工作.在创建工作页中,您可以查看在创建配置作业时添加的所有变量。
- 在编辑配置作业时,导航到网络>配置工作,选择“作业名称”,单击编辑.在配置工作页中,您可以查看在创建配置作业时添加的所有变量。
然后单击预览变量选项卡可在创建或编辑配置作业时定义的单个合并视图中预览变量。
将出现一个新的弹出窗口,并以表格形式显示变量的所有参数,如名称、显示名称、类型和默认值。您还可以编辑和修改这些参数。单击完成按钮。在编辑或修改任何参数后。
然后,您可以根据需要在配置编辑器中重新排列和重新排序命令。可以通过拖放命令行将命令从一行移动到另一行。通过简单地更改文本框中的命令行号,还可以将命令行从一行移动或重新排列到任何目标行。
选择要在其上运行配置作业的实例。
在指定变量值选项卡,选择上传变量值的输入文件选项,然后单击下载输入密钥文件.在我们的示例中,您需要在每个实例上指定服务器名称、服务器和服务的IP地址、端口号和服务名称。保存文件并上传。如果您的值定义不准确,系统可能会抛出一个错误。
输入密钥文件将下载到本地系统,您可以通过为前面选择的每个Citrix ADC实例指定变量值来编辑它,然后单击上传,将输入密钥文件上传到Citrix admin下一个.输入密钥文件将下载到您的本地系统,您可以通过为前面选择的每个Citrix ADC实例指定变量值来编辑它。
请注意
在输入密钥文件中,变量定义在三个级别:
- 全球层面上
- Instance-group水平
- 实例级
全局变量是应用于所有实例的变量值。实例组级别变量值应用于组中定义的所有实例。实例级变量值仅应用于特定实例。
Citrix ADM为实例级值提供优先级。如果没有为单个实例的变量提供值,则Citrix ADM使用组级别提供的值。如果没有在组级别提供值,Citrix ADM将使用在全局级别提供的变量值。如果跨所有三个级别为变量提供输入,Citrix ADM将使用实例级别值作为默认值。
舔上传,将输入密钥文件上传到Citrix admin下一个.
重要的
在Mac上上传CSV文件时,Mac会以分号代替逗号存储CSV文件。这将导致在上传输入文件和运行作业时配置失败。如果你使用的是Mac电脑,请使用文本编辑器进行必要的修改,然后上传文件。
还可以在所有实例中指定通用变量值并单击上传将输入密钥文件上传到citrixadm。
包含变量值的键输入文件在配置作业中被持久化(具有相同的文件名)。您可以查看和编辑之前在创建或编辑配置作业时使用和上传的这些输入文件。
若要在创建配置作业时查看运行配置作业,请导航到网络>配置工作,并单击创建工作.在创建工作页面。在指定变量值选项卡,选择所有实例的公共变量值选项,查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑并上传文件(保持相同的文件名)。
若要在编辑配置作业时查看已运行的配置作业,请导航到网络>配置工作,选择“作业名称”,单击编辑.在配置工作页,在指定变量值选项卡,选择所有实例的公共变量值选项,查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑并上传文件(保持相同的文件名)。
在工作预览选项卡,可以计算和验证要在每个实例或实例组上运行的命令。
在执行选项卡,您可以选择现在运行作业或将其安排在稍后运行。您还可以选择在命令失败时Citrix ADM必须采取的操作,以及是否希望发送关于作业成功或失败的电子邮件通知以及其他详细信息。
配置作业并运行它之后,您可以通过导航到来查看作业的详细信息基础设施>配置>配置任务并选择您配置的作业。点击细节然后,点击变量的细节查看添加到作业中的变量列表。
请注意
中为变量提供的值步骤5当您保存作业并退出时,或当您计划在稍后时间点运行作业时,Citrix ADM将保留这些作业。