AWS Controllers for Kubernetes (ACK) 资源接管实践指南

背景介绍

在Kubernetes环境中使用AWS Controllers for Kubernetes (ACK)时，用户经常需要将现有的AWS资源纳入ACK管理范围。本文针对Application Auto Scaling和SageMaker控制器的资源接管场景，详细解析了最佳实践方案。

资源接管方案演进

ACK早期版本提供了AdoptedResource CRD来实现资源接管功能，但这种方式存在以下问题：

1. 配置复杂，需要额外定义AdoptedResource对象
2. 容易因API组配置错误导致"resource manager factory not found"错误
3. 维护成本较高

新版本ACK引入了基于注解的资源接管机制，通过直接在目标资源上添加特定注解即可实现资源接管，大大简化了操作流程。

Application Auto Scaling资源接管实践

对于Application Auto Scaling资源，正确的接管方式如下：

ScalableTarget接管示例

apiVersion: applicationautoscaling.services.k8s.aws/v1alpha1
kind: ScalableTarget
metadata:
  name: my-scalable-target
  annotations:
    services.k8s.aws/adoption-policy: adopt
    services.k8s.aws/adoption-fields: |
      {
          "resourceID": "my-resource-id",
          "serviceNamespace": "sagemaker",
          "scalableDimension": "sagemaker:variant:DesiredInstanceCount"
      }

ScalingPolicy接管示例

apiVersion: applicationautoscaling.services.k8s.aws/v1alpha1
kind: ScalingPolicy
metadata:
  name: my-scaling-policy
  annotations:
    services.k8s.aws/adoption-policy: adopt
    services.k8s.aws/adoption-fields: |
      {
          "policyName": "my-policy-name",
          "serviceNamespace": "sagemaker",
          "resourceID": "my-resource-id",
          "scalableDimension": "sagemaker:variant:DesiredInstanceCount"
      }

关键参数说明：

• resourceID: 目标资源的唯一标识符
• serviceNamespace: 资源所属的服务命名空间
• scalableDimension: 可扩展维度定义

SageMaker资源接管实践

对于SageMaker资源，接管方式略有不同：

Endpoint接管示例

apiVersion: sagemaker.services.k8s.aws/v1alpha1
kind: Endpoint
metadata:
  name: my-endpoint
  annotations:
    services.k8s.aws/adoption-policy: adopt
    services.k8s.aws/adoption-fields: |
      {
          "endpointName": "my-endpoint-name"
      }

Model接管示例

apiVersion: sagemaker.services.k8s.aws/v1alpha1
kind: Model
metadata:
  name: my-model
  annotations:
    services.k8s.aws/adoption-policy: adopt
    services.k8s.aws/adoption-fields: |
      {
          "modelName": "my-model-name"
      }

常见问题排查

1. 资源管理器未找到错误
   通常是由于API组配置错误导致，确保使用正确的API组：

   • Application Auto Scaling资源使用applicationautoscaling.services.k8s.aws
   • SageMaker资源使用sagemaker.services.k8s.aws

2. 资源已存在但未被管理
   检查是否正确设置了adoption-policy: adopt注解

3. 字段验证失败
   确保adoption-fields中包含了所有必填字段，可以通过查看控制器源码中的PopulateResourceFromAnnotation方法确认所需字段

最佳实践建议

1. 优先使用注解方式接管资源，而非AdoptedResource CRD
2. 接管前确认目标资源在AWS控制台中的实际参数
3. 对于复杂资源，建议先通过describe命令获取完整配置
4. 测试环境先行验证，再在生产环境实施
5. 保持ACK控制器版本更新，以获取最新功能支持

通过遵循以上实践指南，用户可以高效地将现有AWS资源纳入ACK管理范围，实现基础设施的声明式管理。