karthikk296d/aws-apigw-ingress-controller

Amazon API Gateway Ingress Controller

镜像概述

本镜像实现了Amazon API Gateway入口控制器，用于将运行在Amazon EKS（Elastic Kubernetes Service）集群上的服务通过API Gateway对外暴露。它支持通过Kubernetes Ingress资源定义API网关规则，简化EKS服务与API Gateway的集成流程。

核心功能

1. 基于Kubernetes Ingress资源自动创建和配置API Gateway前端
2. 集成IAM权限管理（支持kube2iam）
3. 支持自定义API Gateway阶段名称、客户端ARN等配置
4. 可配置后端Nginx服务的副本数、镜像及端口

使用场景

适用于需要将EKS集群内的微服务通过Amazon API Gateway对外提供HTTP/HTTPS服务的场景，例如：

• 微服务架构中的API统一入口管理
• 跨团队服务的API暴露与权限控制
• 基于API Gateway的流量管理与监控

配置说明

前提条件

• 已部署EKS集群
• 已配置kube2iam用于Pod权限管理

部署步骤

1. 创建IAM角色：

sh
export INSTANCE_ROLE_ARNS="逗号分隔的K8s worker实例ARN列表"
make iam

2. 构建并部署控制器：

sh
export IMG="你的ECR仓库地址"
export IAMROLEARN="上述步骤创建的IAM角色ARN"
make docker-build
make docker-push
make deploy

示例配置

以下是Ingress资源的配置示例：

yaml
---
apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: foobar-ingress
  annotations:
    kubernetes.io/ingress.class: apigateway
    apigateway.ingress.kubernetes.io/stage-name: prod
    apigateway.ingress.kubernetes.io/client-arns: arn::foo,arn::bar
    apigateway.ingress.kubernetes.io/nginx-replicas: "3"
    apigateway.ingress.kubernetes.io/nginx-image: nginx:latest
    apigateway.ingress.kubernetes.io/nginx-service-port: "9090"
spec:
  rules:
    - http:
        paths:
        - backend:
            serviceName: foo-service
            servicePort: 8080
          path: /api/v1/foo
        - backend:
            serviceName: bar-service
            servicePort: 8080
          path: /api/v1/bar