entigolabs/entigo-infralib-agent

Entigo infralib agent 镜像文档

1. 镜像概述和主要用途

Entigo infralib agent是由Entigo公司开发的Docker镜像，旨在将infralib模块自动化应用到AWS（亚马逊云服务）或Google Cloud（谷歌云）平台。该工具基于基础设施即代码（IaC）理念，通过标准化流程实现云资源的自动化部署、配置与管理，简化多云环境下的基础设施运维工作。

2. 核心功能和特性

• 多平台兼容：支持AWS和Google Cloud两大主流云平台，满足企业多云架构需求。
• 模块自动化应用：自动解析并部署infralib模块至目标云平台，减少手动操作，降低部署错误率。
• infralib生态集成：深度整合infralib模块体系，支持标准化基础设施组件（如网络、计算、存储等）的快速部署。
• 容器化设计：基于Docker封装，具备轻量级、跨环境可移植性，简化依赖管理与部署流程。

3. 使用场景和适用范围

• 云基础设施自动化部署：适用于通过infralib模块在AWS或Google Cloud上批量部署基础设施组件的场景。
• 多云环境统一管理：帮助企业在混合云架构中（AWS+Google Cloud）实现基础设施部署流程的标准化与统一化。
• DevOps流水线集成：可嵌入CI/CD流程，实现基础设施代码的自动测试、构建与部署，提升DevOps团队协作效率。
• 基础设施标准化配置：通过infralib模块的规范应用，确保开发、测试、生产等多环境基础设施配置的一致性。

4. 使用方法和配置说明

4.1 前置要求

• 已安装Docker引擎（推荐版本20.10及以上）。
• 拥有目标云平台（AWS/Google Cloud）的访问权限及有效认证凭证。
• 已准备符合infralib规范的模块文件。

4.2 Docker部署示例

4.2.1 部署至AWS

bash
docker run --rm \
  -e CLOUD_PROVIDER=aws \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e AWS_REGION="us-west-2" \  # 可选，默认us-east-1
  -v /local/path/to/infralib/modules:/app/modules \  # 挂载本地模块目录
  entigo/infralib-agent:latest apply --module-path /app/modules

4.2.2 部署至Google Cloud

bash
docker run --rm \
  -e CLOUD_PROVIDER=google \
  -e GOOGLE_APPLICATION_CREDENTIALS="/app/credentials/key.json" \  # GCP密钥路径
  -v /local/path/to/gcp-key.json:/app/credentials/key.json:ro \  # 挂载GCP密钥文件（只读）
  -v /local/path/to/infralib/modules:/app/modules \  # 挂载本地模块目录
  entigo/infralib-agent:latest apply --module-path /app/modules

4.3 环境变量配置

4.4 命令参数说明

镜像核心命令为 apply（应用模块），支持以下参数：

5. 注意事项

• 确保挂载的infralib模块文件格式符合infralib规范，避免因格式错误导致部署失败。
• 云平台认证凭证需通过安全方式传递（如文件挂载、环境变量加密），防止凭证泄露。
• 生产环境建议结合容器编排工具（如Docker Compose、Kubernetes）使用，提升部署稳定性与可维护性。