reactiveops/iam-waiter

镜像概述

该Docker镜像用于解决Kubernetes集群中使用kube2iam和Cluster Autoscaler时的常见问题：新节点上的Pod可能在kube2iam就绪前启动，导致IAM角色分配延迟引发错误。它作为init容器，等待Pod的IAM角色正确分配后再启动主容器。

核心功能

• 作为Kubernetes init容器运行，阻塞主容器启动直到IAM角色就绪
• 检查Pod的IAM角色ARN是否包含指定字符串（通过环境变量配置）
• 可自定义检查间隔和最大尝试次数

使用场景

适用于Kubernetes集群中启用kube2iam和Cluster Autoscaler的场景，尤其是需要Pod依赖特定IAM角色才能正常运行的应用（如访问AWS服务的工作负载）。

配置说明

镜像支持以下环境变量配置：

• MATCH_ROLE（必填）：IAM角色ARN中需包含的字符串，镜像将等待角色满足此条件
• INTERVAL_IN_SECONDS（可选）：检查IAM角色的间隔时间，默认10秒
• MAX_ATTEMPTS（可选）：最大检查次数，超过后放弃，默认100次

部署示例

以下是作为init容器使用的Pod配置示例：

yaml
apiVersion: v1
kind: Pod
metadata:
  name: iam-waiter-test
  namespace: iam-waiter-testing
  annotations:
    iam.amazonaws.com/role: arn:aws:iam::123456789:role/iam-waiter-test
spec:
  initContainers:
  - name: iam-waiter
    image: docker.xuanyuan.run/reactiveops/iam-waiter:0.1.0
    env:
      - name: MATCH_ROLE
        value: iam-waiter-test
  containers:
  - name: aws-cli
    image: docker.xuanyuan.run/mesosphere/aws-cli:1.14.5
    command: ['watch', '-n', '15', 'aws', 'sts', 'get-caller-identity']

说明：示例中init容器等待IAM角色ARN包含"iam-waiter-test"，主容器使用AWS CLI验证身份信息。实际使用时可替换主容器为需要IAM角色的业务容器。

许可证

Apache License 2.0