awsserviceoperator/aws-service-operator

AWS Service Operator

AWS Service Operator允许您通过Kubernetes自定义资源定义（CRD）管理AWS资源。

使用该工具可实现GitOps工作流，通过Kubernetes自定义资源定义、内部控制循环和AWS CloudFormation编排，将基础设施驱动至期望状态。关于"Operator"的更多信息可参考此处。

前提条件

开始前需准备：

• 运行在AWS中的Kubernetes集群（推荐使用EKS或kops创建）
• kubectl工具
• AWS CLI工具

核心功能

1. 通过Kubernetes CRD创建和管理AWS资源
2. 集成AWS CloudFormation进行资源编排
3. 支持GitOps工作流，实现基础设施版本化管理
4. 自动为集群内资源创建Kubernetes Service

使用场景

• 云基础设施的GitOps管理
• 在Kubernetes集群内统一管控AWS资源
• 通过代码定义和版本控制AWS基础设施

配置说明

IAM权限管理

需安装IAM管理层（如kube2iam），以实现Pod级别的AWS权限控制。可参考https://github.com/jtblin/kube2iam%E6%88%96%E5%85%B6Helm Chart进行部署。

创建IAM角色

执行以下命令创建Operator所需的IAM角色（替换<K8S_WORKER_NODE_IAM_ROLE>为工作节点角色ARN）：

shell
aws cloudformation create-stack \
  --stack-name aws-service-operator-role \
  --capabilities CAPABILITY_NAMED_IAM \
  --template-body file://configs/aws-service-operator-role.yaml \
  --parameters \
    ParameterKey=WorkerArn,ParameterValue=<K8S_WORKER_NODE_IAM_ROLE>    

部署Operator

1. 替换configs/aws-service-operator.yaml中的占位符（账户ID、区域、集群名、S3桶名）
2. 部署Operator：

shell
kubectl apply -f configs/aws-service-operator.yaml

3. 部署CloudFormation模板：

shell
kubectl apply -f examples/cloudformationtemplates

4. （可选）查看日志：

shell
kubectl logs -f -n aws-service-operator deploy/aws-service-operator

5. 示例：创建ECR仓库

shell
kubectl apply -f examples/ecrrepository.yaml
kubectl describe ecr example-repository-name

清理资源

shell
kubectl delete ecr example-repository-name
kubectl get crd | grep ".operator.aws" | awk '{print $1}' | xargs kubectl delete crd
kubectl delete -f configs/aws-service-operator.yaml