在配置作业中使用变量

配置作业是您可以在一个或多个托管实例上运行的一组配置命令。当您在多个实例上运行相同的配置时,您可能希望对配置中使用的参数使用不同的值。您可以定义变量,使您能够为这些参数分配不同的值,或在多个实例上运行作业。

例如,考虑一个基本的负载均衡配置,您可以在其中添加一个负载均衡虚拟服务器、添加两个服务并将这些服务绑定到虚拟服务器。现在,您可能希望在两个实例上使用相同的配置,但虚拟服务器和服务名称以及 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>

在 NetScaler® ADM 中通过定义变量来创建配置作业:

  1. 导航到“基础结构”>“配置作业”。

  2. 单击“创建作业”。

  3. 在“创建作业”页面上,选择自定义作业参数,例如作业名称、实例类型和配置类型。

  4. 在“配置编辑器”中,键入用于添加负载均衡虚拟服务器、两个服务并将这些服务绑定到虚拟服务器的命令。双击选择要转换为变量的值,然后单击“转换为变量”。例如,选择负载均衡服务器的 IP 地址 *ipaddress*,然后单击“转换为变量”,如下图所示。

    转换为变量

  5. 看到美元符号将变量值括起来后,单击该变量以进一步指定变量的详细信息,例如名称、显示名称和类型。如果您想进一步指定变量的默认值,也可以单击“高级”选项。单击“保存”,然后单击“下一步”。

    定义变量 1

    键入其余命令并定义所有变量。

    定义变量 2

  6. 您可以在单个合并视图中查看在创建或编辑配置作业时定义的所有变量。

  7. 执行以下操作之一以在单个合并视图中查看所有变量:

    • 创建配置作业时,导航到“基础结构”>“配置作业”,选择“创建作业”。在“创建作业”页面上,您可以查看在创建配置作业时添加的所有变量。

    • 编辑配置作业时,导航到“网络”>“配置作业”,选择“作业名称”并单击“编辑”。在“配置作业”页面上,您可以查看在创建配置作业时添加的所有变量。

  8. 然后,您可以单击“预览变量”选项卡,以在单个合并视图中预览在创建或编辑配置作业时定义的变量。

    预览变量 1

  9. 将出现一个新弹出窗口,以表格形式显示变量的所有参数,例如名称、显示名称、类型和默认值。您还可以编辑和修改这些参数。编辑或修改任何参数后,单击“完成”按钮。

    预览变量 2

  10. 然后,您可以根据需要重新排列和重新排序配置编辑器中的命令。您可以通过拖放命令行将命令从一行移动到另一行。您还可以通过简单地更改文本框中的命令行号,将命令行从一行移动或重新排列到任何目标行。

  11. 选择要运行配置作业的实例。

  12. 在“指定变量值”选项卡中,选择“上传变量值的输入文件”选项,然后单击“下载输入密钥文件”。在我们的示例中,您需要指定每个实例上的服务器名称、服务器和服务的 IP 地址、端口号以及服务名称。保存文件并上传。如果您的值未准确定义,系统可能会抛出错误。

  13. 输入密钥文件将下载到您的本地系统,您可以通过为之前选择的每个 NetScaler 实例指定变量值来编辑它,然后单击“上传”将输入密钥文件上传到 NetScaler ADM。单击“下一步”。输入密钥文件将下载到您的本地系统,您可以通过为之前选择的每个 NetScaler 实例指定变量值来编辑它。

    注意 在输入密钥文件中,变量定义在三个级别:

    • 全局级别
    • 实例组级别
    • 实例级别

    全局变量是应用于所有实例的变量值。实例组级别变量值应用于组中定义的所有实例。实例级别变量值仅应用于特定实例。

    NetScaler ADM 优先考虑实例级别值。如果未向单个实例的变量提供值,NetScaler ADM 将使用组级别提供的值。如果未在组级别提供值,NetScaler ADM 将使用在全局级别提供的变量值。如果您为所有三个级别的变量提供输入,NetScaler ADM 将使用实例级别值作为默认值。

  14. 单击“上传”将输入密钥文件上传到 NetScaler ADM。单击“下一步”。

    重要

    当您从 Mac 上传 CSV 文件时,Mac 会将 CSV 文件存储为分号而不是逗号。当您上传输入文件并运行作业时,这将导致配置失败。如果您使用的是 Mac,请使用文本编辑器进行必要的更改,然后上传文件。

  15. 您还可以为所有实例提供通用变量值,然后单击“上传”将输入密钥文件上传到 NetScaler ADM。

    包含变量值的密钥输入文件将持久保存在配置作业中(具有相同的文件名)。您可以在创建或编辑配置作业时查看和编辑您之前使用和上传的这些输入文件。

    要在创建配置作业时查看运行配置作业,请导航到“网络”>“配置作业”,然后单击“创建作业”。在“创建作业”页面上。在“指定变量值”选项卡中,选择“所有实例的通用变量值”选项以查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑并上传文件(保持相同的文件名)。

    要在编辑配置作业时查看已运行的配置作业,请导航到“网络”>“配置作业”,选择“作业名称”并单击“编辑”。在“配置作业”页面上,在“指定变量值”选项卡中,选择“所有实例的通用变量值”选项以查看上传的文件。要编辑输入文件,请下载输入文件,然后编辑并上传文件(保持相同的文件名)。

  16. 在“作业预览”选项卡中,您可以评估和验证要在每个实例或实例组上运行的命令。

  17. 在“执行”选项卡中,您可以选择立即运行作业或安排其在以后运行。您还可以选择如果命令失败,NetScaler ADM 必须采取什么操作,以及您是否希望发送有关作业成功或失败的 Email 通知以及其他详细信息。

    安排作业

配置并运行作业后,您可以通过导航到“基础结构”>“配置作业”并选择您刚刚配置的作业来查看作业详细信息。单击“详细信息”,然后单击“变量详细信息”以查看添加到作业的变量列表。

变量列表

注意

当您保存作业并退出,或安排作业在以后运行,NetScaler ADM 会保留您在步骤 5 中为变量提供的值。

在配置作业中使用变量