akamai/eaa-k8s-connector

镜像概述

该Docker镜像为Akamai Enterprise Application Access (EAA)提供Kubernetes (k8s)环境的集成连接器，旨在实现Kubernetes集群与Akamai EAA服务的无缝对接。通过该镜像，用户可在Kubernetes环境中便捷地部署、配置和管理Akamai EAA相关资源，确保企业应用通过Akamai EAA服务实现安全、可控的访问。

核心功能与特性

1. Kubernetes环境深度集成

• 支持与Kubernetes集群的API Server通信，自动发现和管理集群内资源。
• 兼容主流Kubernetes版本（1.18+），适配标准Kubernetes资源模型（如Deployment、Service等）。

2. Akamai EAA服务管理

• 提供Akamai EAA应用、身份提供商、访问策略等资源的创建、更新与删除操作。
• 支持EAA服务配置的导入/导出，实现配置版本化管理。

3. 安全访问控制

• 集成Akamai EAA的身份验证与授权机制，确保Kubernetes集群内应用通过EAA服务安全访问企业资源。
• 支持基于角色的访问控制（RBAC），适配Kubernetes RBAC策略与EAA权限模型。

4. 配置同步与状态监控

• 实时同步Kubernetes集群状态与Akamai EAA服务配置，确保两端资源一致性。
• 提供健康检查与状态上报功能，支持集成Prometheus等监控工具。

使用场景与适用范围

适用场景

• 企业在Kubernetes集群中部署应用，需通过Akamai EAA服务实现外部用户或跨集群安全访问。
• 需要在Kubernetes环境中集中管理Akamai EAA资源（如应用、策略、身份提供商）。
• 需实现Kubernetes集群资源与Akamai EAA服务配置的自动化同步与联动。

适用范围

• 运行Kubernetes 1.18+版本的集群环境（包括自建集群、云厂商托管集群如EKS、GKE、AKS）。
• 使用Akamai EAA服务的企业用户，需具备Akamai EAA管理员权限。
• 需要安全访问企业内部应用的场景，如远程办公、跨地域团队协作等。

使用方法与配置说明

前置条件

• 已获取Akamai EAA服务的API凭证（API Key、API Secret）。
• 目标Kubernetes集群已配置kubectl访问权限，且集群网络可访问Akamai EAA API端点。
• Docker环境或Kubernetes集群（用于部署该镜像）。

部署示例

1. Docker run部署（单机测试）

bash
docker run -d \
  --name akamai-eaa-k8s-connector \
  -e EAA_API_KEY="your-eaa-api-key" \
  -e EAA_API_SECRET="your-eaa-api-secret" \
  -e EAA_TENANT_ID="your-eaa-tenant-id" \
  -e KUBECONFIG="/kube/config" \
  -v /path/to/local/kubeconfig:/kube/config \
  docker.xuanyuan.run/akamai/eaa-k8s-connector:latest

2. Kubernetes Deployment部署（生产环境）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: eaa-k8s-connector
  namespace: akamai-eaa
spec:
  replicas: 1
  selector:
    matchLabels:
      app: eaa-k8s-connector
  template:
    metadata:
      labels:
        app: eaa-k8s-connector
    spec:
      containers:
      - name: eaa-k8s-connector
        image: docker.xuanyuan.run/akamai/eaa-k8s-connector:latest
        env:
        - name: EAA_API_KEY
          valueFrom:
            secretKeyRef:
              name: eaa-credentials
              key: api-key
        - name: EAA_API_SECRET
          valueFrom:
            secretKeyRef:
              name: eaa-credentials
              key: api-secret
        - name: EAA_TENANT_ID
          value: "your-tenant-id"
        - name: KUBECONFIG
          value: "/var/run/secrets/kubernetes.io/serviceaccount/kubeconfig"
        volumeMounts:
        - name: kubeconfig
          mountPath: /var/run/secrets/kubernetes.io/serviceaccount
          readOnly: true
      volumes:
      - name: kubeconfig
        secret:
          secretName: kubeconfig-secret

配置参数说明

环境变量

验证部署

部署完成后，可通过以下方式验证服务状态：

1. 查看容器日志：

   bash
   docker logs <container-id>  # Docker部署
   kubectl logs -n akamai-eaa <pod-name>  # Kubernetes部署
   

2. 检查同步状态：日志中出现"Sync completed successfully"表示配置同步正常。
3. 通过Akamai EAA管理控制台确认资源已同步至Kubernetes集群。

注意事项

• 确保EAA_API_KEY和EAA_API_SECRET以安全方式管理（如Kubernetes Secrets），避免明文暴露。
• 生产环境建议使用Kubernetes Deployment部署，并配置资源限制与自动重启策略。
• 首次部署需确保网络通畅，容器可访问Akamai EAA API端点（https://<region>.eaa.akamai.com/api/v1）及Kubernetes API Server。