Apache CloudStack EC2stack 镜像文档

镜像概述和主要用途

Apache CloudStack EC2stack 是一个为 Apache CloudStack 提供 EC2 兼容性接口的工具。它能够接收 Amazon EC2 API 请求，将这些请求映射到相应的 CloudStack API 调用，并按要求解析响应。这使得为 Amazon EC2 API 创建的工具可以用于 Apache CloudStack。

核心功能和特性

• 将 Amazon EC2 API 请求转换为 CloudStack API 调用
• 解析 CloudStack 响应以适应 EC2 API 格式
• 支持 AWS Signature Version 2 签名验证
• 提供 REST API 接口，默认监听 5000 端口
• 与 AWS CLI 工具兼容（需配置使用 v2 签名版本）

使用场景和适用范围

• 需要使用 AWS CLI 或其他 EC2 工具管理 CloudStack 资源的环境
• 希望在 CloudStack 平台上使用基于 EC2 API 的自动化脚本或工具
• 迁移自 AWS EC2 并希望保持工具链兼容性的场景
• 开发需要同时支持 EC2 和 CloudStack 的多云应用

详细的使用方法和配置说明

前提条件

• Docker 环境
• CloudStack 环境的 API 访问密钥（Access Key 和 Secret Key）
• CloudStack 服务端点信息

镜像获取

docker pull cloudstack/cloudstack-ec2stack

配置步骤

1. 运行交互式容器进行配置

docker run -ti cloudstack/cloudstack-ec2stack ec2stack-configure

注意：配置过程中，请将绑定地址设置为 0.0.0.0 以允许容器外部访问

2. 提交配置后的容器为新镜像

# 首先获取容器ID
docker ps -a
# 提交为新镜像
docker commit <container_id> ec2stack:yourcloud

运行容器

docker run -d -p 5000:5000 ec2stack:yourcloud ec2stack

用户注册

curl -d AWSSecretKey=yoursecretkey -d AWSAccessKeyId=yourapikey -d Action=RegisterSecretKey http://localhost:5000

成功注册后会返回 XML 响应，包含 "Successfully Registered" 消息。

AWS CLI 配置

1. 安装 AWS CLI（Ubuntu 系统）

sudo apt-get install python-pip
sudo pip install awscli

2. 配置 AWS CLI

aws configure

输入 CloudStack API 密钥、区域名称，并将签名版本设置为 v2：

aws configure set default.ec2.signature_version v2

3. 使用 AWS CLI 访问 CloudStack

aws ec2 describe-images --endpoint=http://localhost:5000

配置参数说明

重要配置注意事项

EC2stack 当前版本仅支持 AWS Signature Version 2，因此使用 AWS CLI 时必须显式配置使用 Version 2：

• 对于默认配置文件：

  aws configure set default.ec2.signature_version v2
  

• 对于命名配置文件：

  aws configure set profile.<your_profile_name>.ec2.signature_version v2
  

这些命令会更新 ~/.aws/config 文件中的相应设置。

Docker Compose 部署示例

创建 docker-compose.yml 文件：

version: '3'
services:
  ec2stack:
    build:
      context: .
      dockerfile: Dockerfile.ec2stack
    ports:
      - "5000:5000"
    restart: always
    environment:
      - CLOUDSTACK_ENDPOINT=[***]
      - CLOUDSTACK_ZONE=your-zone-name
    command: ec2stack

验证部署

部署完成后，可以使用以下命令验证服务是否正常运行：

# 检查服务是否响应
curl http://localhost:5000

# 验证基本功能
aws ec2 describe-instances --endpoint=http://localhost:5000

参考文档

• Apache CloudStack 官方网站
• EC2stack 用户指南
• AWS CLI 配置文档