启用自动更新

启用自动更新时，ALB 将更新为标记为缺省值的版本。 当较新版本成为缺省版本时，ALB 将自动更新为该版本。

如果集群中的专区中仅存在一个工作程序节点，并且您将 ALB 副本数设置为 1，那么将删除此单个 ALB pod，并在应用更新时创建新 pod。 此过程可能会导致流量中断，即使您在其他区域中具有工作程序节点和 ALB 副本也是如此。 要防止流量中断，请确保每个专区中至少存在两个工作程序节点，并且 每个 ALB 都存在两个副本。 请注意，在更新过程中，只有新连接会路由到第二个 ALB pod; 更新 ALB pod 上的现有连接会安全终止。 对于在更新期间终止的现有连接，请在客户机应用程序中启动重试。

调度自动更新的维护窗口

您可以通过创建自定义的 ConfigMap 来控制和管理 ALB 自动更新，其中指定了您希望更新的时间。

要设置自动更新的时间，可在部署 ConfigMap 中设置 updateStartTime 和 updateEndTime 键。 每个键表示 24 小时格式 (HH:MM) 的分配时间。 请注意，此时间以协调通用时间 (UTC) 而不是本地时间指定。

1. 为ConfigMap 创建一个 YAML 文件。 在 data 字段中指定 updateStartTime 和 updateEndTime 字段为键值对。

   以下示例 ConfigMap 设置自动更新功能，以在 20:34 到 23:59 UTC 之间更新集群中 35% 的 ALB pod。

   apiVersion: v1
   kind: ConfigMap
   metadata:
       name: ibm-ingress-deploy-config
       namespace: kube-system
   data:
       "updateStartTime": "20:34"
       "updateEndTime": "23:59"
   

2. 在集群中部署 ConfigMap。 新规则将在下次执行更新时应用。

   kubectl apply -f <filename>.yaml
   

禁用自动更新

要接收错误修订和安全更新，请保持启用自动更新。 禁用自动更新后，您将负责手动更新 ALB。

您可以通过运行 ibmcloud ks ingress alb autoupdate disable -c <cluster_name_or_ID> 来禁用 ALB 的自动更新。

要检查是否为集群启用了自动更新，请使用 ibmcloud ks ingress alb autoupdate get -c <cluster_name_or_ID> 命令。 如果您决定再次启用自动更新，那么可以运行 ibmcloud ks ingress alb autoupdate enable -c <cluster_name_or_ID>。

应用手动更新

您可以使用 ibmcloud ks ingress alb update 命令手动应用 Ingress ALB pod 的一次性更新。 此命令将应用缺省 ALB 映像版本，但您可以通过包含 --version 选项来应用其他版本。 有关更多信息或命令选项，请参阅 CLI 参考。

要使用 --version 选项将 ALB 映像更新到特定版本，必须 禁用自动 ALB 更新，然后使其处于禁用状态 (只要您想要运行指定的版本)。 自动更新始终应用缺省版本，并覆盖您应用的任何手动更新。 如果要使用其他版本，那么无法启用自动更新。

• 要列出可用的 ALB 版本，请运行以下命令。

  ibmcloud ks ingress alb version ls --region <region>
  

• 要更新集群中的所有 ALB pod，请运行以下命令。

  ibmcloud ks ingress alb update -c <cluster_name_or_ID> --version <image_version>
  

• 要更新特定 ALB 的 ALB，请运行以下命令。

  ibmcloud ks ingress alb update -c <cluster_name_or_ID> --version <image_version> --alb <ALB_ID> [--alb <ALB_2_ID> ...]
  

查看受支持的映像版本

要列出每种类型的映像支持的最新三个版本，请运行以下命令。

ibmcloud ks ingress alb versions

示例输出

Kubernetes Ingress versions
1.1.2_2507_iks (default)
1.2.1_2506_iks
0.35.0_1374_iks

Kubernetes Ingress 版本遵循格式 <community_version>_<ibm_build>_iks。 IBM 构建号指示 IBM Cloud Kubernetes Service 发布的 Kubernetes Ingress NGINX 发行版的最新构建。 例如，版本 1.1.2_2507_iks 指示 0.47.0 Ingress NGINX 版本的最新构建。IBM Cloud Kubernetes Service 可能会发布社区映像版本的构建以解决漏洞。

有关每个 Ingress 映像版本中的更改，请参阅 Ingress 版本更改日志。

恢复到早期版本

如果最近更新了 ALB pod，但 ALB 的定制配置受最新映像版本构建的影响，那么可以使用带有 --version 选项的 ibmcloud ks ingress alb update 命令将 ALB pod 回滚到受支持的较早版本。 将 ALB 更改为的映像版本必须是 ibmcloud ks ingress alb versions 输出中列出的受支持映像版本。

请注意，如果还原到较低版本，那么必须 禁用自动 ALB 更新，然后保持禁用状态，只要您想要运行较低版本。 自动更新始终应用最新版本并覆盖您应用的任何手动更新。 如果要使用较早版本，那么无法启用自动更新。

在区域中创建更多 ALB

区域中的每个 ALB 都作为两个 pod 部署在不同的工作程序节点上。 要扩展 ALB 处理功能并处理更多连接，可以在区域中创建其他 ALB。 新 ALB 的 IP 地址将自动添加到 Ingress 子域。

创建多区域群集时，会在每个有工作者节点的区域创建一个默认的公共 ALB。 如果您稍后除去这三个原始专区中的一个，并在另一专区中添加工作程序，那么不会在该新专区中创建缺省公共 ALB。 您可以手动创建 ALB 以处理该新专区中的连接。

使用 Ingress 资源验证时，所有 ALB 都会验证每个创建和更新请求。 如果没有针对特定 ALB 实例运行任何 pod，那么您可能无法在集群上应用 Ingress 资源。 确保每个处于已启用状态的 ALB 至少有一个正在运行的 pod。 有关更多信息，请参阅 Ingress 部署定制参考。

1. 在具有工作程序节点的每个区域中，创建 ALB。

   以下命令适用于 经典集群。 有关更多信息和命令选项，请参阅 CLI 参考。

   ibmcloud ks ingress alb create --cluster <cluster_name_or_ID> --type <public_or_private> --zone <zone> --vlan <VLAN_ID> [--ip <IP_address>] [--version image_version]
   

   以下命令适用于 VPC 集群。 有关更多信息和命令选项，请参阅 CLI 参考。

   ibmcloud ks ingress alb create vpc-gen2 --cluster <cluster_name_or_ID> --type <public_or_private> --zone <vpc_zone> [--version image_version]
   

2. 验证您在每个区域中创建的 ALB 的 状态 是否为 enabled。 对于经典集群，请检查是否已分配 ALB IP。 对于 VPC 集群，请检查是否已分配 负载均衡器主机名。

   ibmcloud ks ingress alb ls --cluster <cluster_name_or_ID>
   

   经典集群的示例输出。

   ALB ID                                            Enabled   Status     Type      ALB IP          Zone    Build                          ALB VLAN ID   NLB Version
   private-crdf253b6025d64944ab99ed63bb4567b6-alb1   false     disabled   private   -               dal12   ingress:1.1.2_2507_iks   2294021       -
   private-crdf253b6025d64944ab99ed63bb4567b6-alb2   false     disabled   private   -               dal10   ingress:1.1.2_2507_iks   2234947       -
   public-crdf253b6025d64944ab99ed63bb4567b6-alb1    true      enabled    public    169.48.228.78   dal12   ingress:1.1.2_2507_iks   2294019       -
   public-crdf253b6025d64944ab99ed63bb4567b6-alb2    true      enabled    public    169.46.17.6     dal10   ingress:1.1.2_2507_iks   2234945       -
   

   VPC 集群的示例输出。

   ALB ID                                            Enabled   Status     Type      Load Balancer Hostname                 Zone         Build
   private-crdf253b6025d64944ab99ed63bb4567b6-alb1   false     disabled   private   -                                      us-south-2   ingress:1.1.2_2507_iks
   private-crdf253b6025d64944ab99ed63bb4567b6-alb2   false     disabled   private   -                                      us-south-1   ingress:1.1.2_2507_iks
   public-crdf253b6025d64944ab99ed63bb4567b6-alb1    true      enabled    public    23f2dfb1-us-south.lb.appdomain.cloud   us-south-2   ingress:1.1.2_2507_iks
   public-crdf253b6025d64944ab99ed63bb4567b6-alb2    true      enabled    public    23f2dfb1-us-south.lb.appdomain.cloud   us-south-1   ingress:1.1.2_2507_iks
   
   

更改 ALB pod 副本数

缺省情况下，每个 ALB 都有 2 个副本。 您可以通过手动更改 ALB pod 的数量或通过启用动态自动缩放来定制 ALB 处理功能。

单个 ALB pod 可以处理大量请求。 如果迂到超时，响应缓慢或其他超负荷迹象，请检查后端应用程序的状态。 在缩放 ALB pod 之前，请确保 ALB 是应用程序的瓶颈，否则它可能无法提供预期结果。

对于经典集群: 如果 ALB 的负载均衡器服务配置将 externalTrafficPolicy 设置为 Local，请不要超过 2 个副本。 经典负载均衡器使用 2 副本的固定配置运行，并且只能将流量转发到与负载均衡器 pod 位于同一节点上的 ALB pod。

缺省情况下，定期 Ingress 版本更新会自动推广到 ALB。 如果集群中的专区中仅存在一个工作程序节点，并且您将 ALB 副本数设置为 1，那么将删除此单个 ALB pod，并在应用更新时创建新 pod。 此过程可能会导致流量中断，即使您在其他区域中具有工作程序节点和 ALB 副本也是如此。 要防止流量中断，请确保每个专区中至少存在两个工作程序节点，并且每个 ALB 都存在两个副本。 请注意，在更新过程中，只有新连接会路由到第二个 ALB pod; 更新 ALB pod 上的现有连接会安全终止。 建议客户机应用程序对更新期间终止的现有连接启动重试。

通过创建 ConfigMap来手动更改 ALB 副本数。 请注意，如果 已将 ALB 配置为使用动态缩放，那么无法手动缩放 ALB 副本。

1. 获取 ALB 的标识。

   ibmcloud ks ingress alb ls -c <cluster_name_or_ID>
   

2. 为 ibm-ingress-deploy-config ConfigMap创建 YAML 文件。 对于每个 ALB，添加 '{"replicas":<number_of_replicas>}'。 此示例将 ALB pod 的数量增加到 4 个副本。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: ibm-ingress-deploy-config
     namespace: kube-system
   data:
     <alb1-id>: '{"replicas":4}'
     <alb2-id>: '{"replicas":4}'
     ...
   

3. 在集群中创建 ibm-ingress-deploy-config ConfigMap。

   kubectl create -f ibm-ingress-deploy-config.yaml
   

4. 要应用更改，请更新 ALB。 请注意，可能需要最多 5 分钟才能应用更改。

   ibmcloud ks ingress alb update -c <cluster_name_or_ID>
   

5. 验证 Ready 的 ALB pod 数是否增加到您指定的副本数。

   kubectl get pods -n kube-system | grep alb
   

用于配置动态 ALB 自动缩放的示例命令

用于基于平均 CPU 利用率 60% 的动态缩放的示例命令。

ibmcloud ks ingress alb autoscale set -c <cluster_name_or_ID> --alb <alb-id> --min-replicas 2 --max-replicas 5 --cpu-average-utilization 60

用于基于存储在名为 my-custom-metrics.yaml 的文件中的定制度量的动态缩放的示例命令。

ibmcloud ks ingress alb autoscale set -c <cluster_name_or_ID> --alb <alb-id> --min-replicas 2 --max-replicas 5 --custom-metrics-file my-custom-metrics.yaml

计算平均 CPU 利用率

下图显示了用于在规划自动缩放配置时确定 CPU 使用率的示例方案。

假定您有一个空闲集群，其中有两个正在运行的 ALB 副本没有入局流量。 在这种情况下，总 CPU 请求数为 2*20m=40m。 其中一个副本可能使用 5m CPU 和另一个 7m CPU。 我们可以使用以下公式计算 CPU 利用率。

禁用 ALB 自动缩放

运行该命令以禁用 ALB 的自动缩放。

ibmcloud ks ingress alb autoscale unset --alb ALB --cluster CLUSTER