hashicorp/consul-lambda-registrator

AWS Lambda-Consul 注册/注销容器镜像

1. 镜像概述

本容器镜像作为AWS Lambda函数与Consul服务发现系统的集成工具，提供自动化的服务注册与注销能力。通过与Consul API交互，确保Lambda函数在部署、更新或删除时，其服务信息能实时同步至Consul，维持服务发现数据的准确性。

2. 核心功能与特性

• 双向服务管理：支持Lambda函数向Consul注册服务元数据及从Consul注销服务记录
• Consul原生集成：兼容Consul 1.0+版本HTTP API，支持标准服务注册参数（服务名称、ID、标签等）
• 配置灵活性：支持自定义服务健康检查、TTL及元数据标签
• 轻量级设计：基于Alpine基础镜像构建，镜像体积小，资源占用低
• AWS权限适配：支持通过环境变量或IAM角色获取AWS API访问权限

3. 使用场景与适用范围

• 无服务器架构服务发现：在基于Lambda构建的微服务架构中，通过Consul实现跨服务调用的服务发现
• 动态扩缩容场景：Lambda函数因负载自动扩缩容时，实时更新Consul服务列表
• CI/CD流程集成：在Lambda函数部署流水线中嵌入自动注册步骤，简化发布流程
• 多环境管理：区分开发/测试/生产环境的Lambda服务注册，实现环境隔离

4. 使用方法与配置说明

4.1 前提条件

• 运行环境需具备Docker引擎或兼容容器运行时
• 可访问的Consul集群（1.0+版本），并开放API端口（默认8500）
• 具备Lambda函数信息读取权限及Consul服务注册权限的AWS凭证

4.2 环境变量配置

4.3 基础使用示例

4.3.1 注册Lambda函数到Consul

bash
docker run -d \
  -e CONSUL_ADDR=consul-server:8500 \
  -e AWS_REGION=us-east-1 \
  -e LAMBDA_FUNCTION_NAME=order-service \
  -e SERVICE_NAME=lambda-order-service \
  -e SERVICE_TAGS=serverless,order-processing \
  your-image-name:latest register

4.3.2 从Consul注销Lambda函数

bash
docker run -d \
  -e CONSUL_ADDR=consul-server:8500 \
  -e AWS_REGION=us-east-1 \
  -e LAMBDA_FUNCTION_NAME=order-service \
  your-image-name:latest deregister

4.4 高级配置示例（带健康检查）

bash
docker run -d \
  -e CONSUL_ADDR=consul-server:8500 \
  -e CONSUL_TOKEN=consul-acl-token \
  -e AWS_REGION=us-west-2 \
  -e LAMBDA_FUNCTION_NAME=user-auth-service \
  -e SERVICE_NAME=lambda-user-auth \
  -e SERVICE_TAGS=auth,serverless,v2 \
  -e HEALTH_CHECK_HTTP=https://auth.example.com/health \
  -e HEALTH_CHECK_INTERVAL=10s \
  -e HEALTH_CHECK_TIMEOUT=5s \
  your-image-name:latest register

5. 注意事项

• 容器需具备同时访问AWS API（lambda.amazonaws.com）和Consul服务的网络权限
• 使用IAM角色时，需确保容器所在环境（如ECS/EKS）已附加包含lambda:GetFunction权限的策略
• 注销操作需指定准确的LAMBDA_FUNCTION_NAME，避免误删其他服务记录
• 生产环境建议启用Consul ACL及HTTPS加密传输（通过CONSUL_SCHEME=https配置）