webofmars/rancher-compose

docker-rancher-compose

镜像概述

docker-rancher-compose是rancher-compose工具的Docker化版本。rancher-compose是Rancher平台的官方工具，用于通过YAML配置文件定义、部署和管理Rancher环境中的应用服务。该Docker镜像将rancher-compose封装为容器，无需在主机系统直接安装，提供了更便捷、隔离的运行方式。

核心功能和特性

• 容器化运行：无需在主机系统安装rancher-compose依赖，通过容器即可直接使用
• 环境隔离：与主机系统环境隔离，避免依赖冲突
• 便捷集成：易于集成到CI/CD流水线或自动化部署流程中
• 功能完整：完整保留rancher-compose的原生功能，支持应用部署、扩缩容、配置管理等操作

使用场景和适用范围

• Rancher应用管理：需要通过配置文件管理Rancher平台上应用服务的场景
• 开发环境：开发人员无需本地安装rancher-compose即可操作Rancher环境
• CI/CD流水线：在自动化部署流程中作为部署工具使用
• 多环境一致性：确保不同环境中使用相同版本的rancher-compose，避免版本差异导致的问题

使用方法和配置说明

基本使用（docker run）

bash
docker run --rm \
  -v $(pwd):/app \
  -e RANCHER_URL=<your-rancher-url> \
  -e RANCHER_ACCESS_KEY=<your-access-key> \
  -e RANCHER_SECRET_KEY=<your-secret-key> \
  docker-rancher-compose up

参数说明：

• -v $(pwd):/app：挂载当前目录到容器内/app目录，用于读取docker-compose.yml或rancher-compose.yml配置文件
• RANCHER_URL：Rancher服务器URL（必填）
• RANCHER_ACCESS_KEY：Rancher API访问密钥（必填）
• RANCHER_SECRET_KEY：Rancher API密钥（必填）

常用命令

与原生rancher-compose命令一致，主要包括：

• up：部署应用服务
• down：停止并移除应用服务
• restart：重启应用服务
• scale：扩缩容服务实例数量
• logs：查看服务日志

示例：

bash
# 部署应用
docker run --rm -v $(pwd):/app -e RANCHER_URL=... docker-rancher-compose up

# 扩缩容服务
docker run --rm -v $(pwd):/app -e RANCHER_URL=... docker-rancher-compose scale service=3

# 查看服务状态
docker run --rm -v $(pwd):/app -e RANCHER_URL=... docker-rancher-compose ps

配置文件

需在挂载目录中提供docker-compose.yml和（可选）rancher-compose.yml配置文件，定义应用服务结构及Rancher特定配置。