产品文档
ADC
14.1 - Current Release 13.1 13.0 12.1
查看 PDF

在一次性 NITRO API 调用中为服务组配置所需的一组服务组成员

October 25, 2023
投稿者: 
C

添加了支持，以便在一次 NITRO API 调用中为服务组配置所需的服务组成员集。添加了新的 API（所需状态 API）来支持此配置。使用期望状态 API，您可以：

  • 在“servicegroup_servicegroupmemberlist_binding”资源上的单个 PUT 请求中提供服务组成员的列表。
  • 在该PUT请求中提供它们的权重和状态（可选）。
  • 有效地将设备配置与应用程序服务器周围的部署更改同步。

Citrix ADC 设备将请求的所需成员集与配置的成员集进行比较。然后，它会自动绑定新成员并解除请求中不存在的成员的绑定。

注意：

  • 只有 API. 类型的服务组才支持此功能
  • 您只能使用 Desired State API 绑定基于 IP 地址的服务，不允许使用基于域名的服务。
  • 以前，只能在 NITRO 呼叫中绑定一个服务组成员。

重要提示

Citrix ADC 群集部署中支持 ServiceGroup 成员资格的所需状态 API。

使用案例：在大规模部署（例如 Kubernetes）中将部署更改同步到 Citrix ADC 设备

在大规模和高度动态的部署（例如 Kubernetes）中，面临的挑战是如何使设备配置与部署的变化速度保持同步，从而准确地为应用程序流量提供服务。在此类部署中，控制器（入口或 E-W 控制器）负责更新 ADC 配置。每当部署发生更改时，都会通过“端点事件”将有效的终端集 kube-api server 发送给控制器。Controller 使用读取三角修改方法，其中执行以下操作：

  • 从 ADC 设备获取服务的当前配置的端点集（服务组的服务组成员集）。
  • 将已配置的端点集与接收事件中的设置进行比较。
  • 绑定新终端节点（服务组成员）或取消绑定已删除的终端节点。

由于更改率和服务大小在此环境中很高，因此此配置方法效率不高，可能会延迟配置更新。

所需状态 API 通过在单个 API 中接受服务组的预期成员集来解决问题，并有效地更新配置。

使用 CLI 创建 API 类型的服务组

在命令提示窗口中，键入：

add serviceGroup <serviceGroupName>@ <serviceType> [-autoScale <autoScale>]

示例：

add serviceGroup svg1 HTTP -autoScale API

您可以通过 add serviceGroup 或 set serviceGroup 命令来配置 autoDisablegraceful、autoDisabledelay 和 autoScale参数。

add serviceGroup <serviceGroupName>@ <serviceType> \[-autoScale <autoScale>] \[-autoDisablegraceful \( YES | NO)] \[-autoDisabledelay <secs>]

add serviceGroup <serviceGroupName>@ <serviceType> \[-autoScale \(API |CLOUD | DISABLED| DNS |POLICY)]

set serviceGroup <serviceGroupName \[-autoDisablegraceful \( YES | NO)] \[-autoDisabledelay <secs>]

set serviceGroup <serviceGroupName \[-autoScale \(API |CLOUD | DISABLED| DNS |POLICY)]

示例：

add serviceGroup svg1 HTTP autoDisablegraceful YES -autoDisabledelay 100

add serviceGroup svg1 HTTP -autoScale API

set serviceGroup svg1 -autoDisablegraceful  YES -autoDisabledelay 100

set serviceGroup svg1 -autoScale API

参数

autoDisablegraceful

表示服务正常关闭。如果启用此选项，设备将等待与该服务的所有未完成连接关闭，然后再删除该服务。对于系统上已有持久会话的客户端，会继续向该服务发送新的连接或请求。仅当没有未完成的连接时，才会删除服务成员。默认值：NO

autoDisabledelay

指示正常关机所允许的时间（以秒为单位）。在此期间，系统上已有持久会话的客户端会继续向该服务发送新的连接或请求。系统上没有持久性会话的新客户端的连接或请求不会发送到服务。相反，它们是在其他可用服务之间进行负载平衡的。延迟时间到期后，服务成员将被删除。

AutoScale API

允许使用所需状态 API 将成员集绑定到目标服务组。如果提供的所有条件都匹配，则可以将服务组从非 AutoScale 类型设置为所需状态 API 的 AutoScale 类型。

如果现有成员绑定满足以下任一条件，则 set serviceGroup Autoscale 命令可能会失败：

  • 如果绑定到服务组的服务器是名称服务器或基于域的服务器。
  • 如果绑定到服务组的服务器名称是 IP 地址，则它必须与实际的服务器 IP 地址相匹配。在以下示例中，服务器名称和服务器 IP 地址不匹配。
    • CLI： 添加服务器 IP 地址服务器名
    • 示例： add server 1.2.3.4 4.3.2.1
  • 如果环回服务器名称不是 127.0.0.1 或 0000:0000:0000:0000:0000:0000:0000:0001。
  • 如果您在 set serviceGroup 命令中选择了不同类型的 AutoScale（云、API、DNS 和策略），然后添加 serviceGroup 命令。

重要：

  • autoDisablegraceful 和 autoDisabledelay 参数仅适用于 AutoScale 类型“API”和“CLOUD”的服务组。
  • 如果未配置 autoDisablegraceful 或 autoDisabledelay 参数，则会立即删除服务成员。

优雅地解除服务组成员的绑定

如果任何服务组成员不在 desired state 列表中，则会根据 autoDisablegraceful 或 autoDisabledelay 参数配置优雅地解除绑定这些成员。

  • 如果设置了其中一个参数，则服务组成员将正常解除绑定。
  • 如果未设置这些参数，则服务组成员将立即解除绑定。

注意：

  • 仅当运行 show service group 命令时，才会显示标识为正常取消绑定的服务组成员。
  • 无法对标识为正常解除绑定的服务组成员执行任何操作（例如设置、取消设置）。

下图显示了 show service group 命令的示例。

示例显示服务组命令

使用 GUI 创建 API 类型的服务组

  1. 导航到 流量管理 > 负载平衡 > 服务组，然后单击 添加。

  2. 在 AutoScale 模式下，选择 API。

使用 GUI 为 API 类型服务组配置正常关机或延时时间

  1. 导航到 Traffic Management（流量管理）> Load Balancing（负载平衡）> Service Groups（服务组）。

  2. 在 AutoScale 模式下，选择 API。

  3. 在“自动禁用优雅”中，选择“是”。

  4. 在 自动禁用延迟中，输入正常关机的等待时间。

注意： 只有在 AutoScale 模式下选择 API 或 CLOUD 时，才会启用自动禁用正常显示延迟或自动显示延迟字段。

在一次性 NITRO API 调用中为服务组配置所需的一组服务组成员
October 25, 2023
投稿者: 
C
October 25, 2023
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.