worksome/rover

镜像概述

该Docker镜像为Apollo GraphQL官方命令行工具rover CLI提供容器化包装。rover CLI是Apollo GraphQL生态的核心工具，用于管理GraphQL架构、与Apollo Studio交互、执行模式检查及发布等操作。本镜像旨在消除本地安装rover的需求，通过容器化方式提供便捷、一致的运行环境。

核心功能与特性

• 免本地安装：无需在主机系统中配置rover及其依赖，通过Docker即可直接运行命令。
• 跨平台一致性：在Linux、macOS、Windows等系统上提供统一的运行结果，避免环境差异导致的问题。
• 版本管理简化：通过指定镜像标签即可切换rover版本，无需手动升级或降级工具。
• 隔离性运行：容器化执行确保rover操作不会影响主机系统配置或依赖。

使用场景

• CI/CD流程集成：在持续集成/部署管道中执行架构检查、模式发布等自动化任务。
• 临时操作需求：快速运行rover命令（如查询Apollo Studio数据）而无需长期安装工具。
• 多版本测试：在同一环境中测试不同版本rover的功能差异或兼容性。

使用方法与配置说明### 基本使用语法

通过docker run命令运行容器，基本格式如下：

bash
docker run --rm [选项] <镜像名称[:标签]> <rover命令及参数>

基础示例

• 查看rover版本：

  bash
  docker run --rm apollo/rover rover --version
  

• 获取命令帮助：

  bash
  docker run --rm apollo/rover rover --help
  

环境变量配置

带认证的命令示例

执行需Apollo Studio访问权限的命令（如拉取架构）：

bash
docker run --rm -e APOLLO_KEY=your_apollo_studio_key apollo/rover rover graph fetch my-graph-id@current

挂载文件/目录

若需使用本地配置文件或数据（如.roverrc、GraphQL模式文件），通过-v参数挂载主机目录至容器：

挂载配置文件

bash
# 使用主机的.roverrc配置
docker run --rm -v $HOME/.roverrc:/root/.roverrc apollo/rover rover config list

挂载模式文件并执行检查

bash
# 挂载当前目录的schema.graphql并检查架构
docker run --rm -v $(pwd):/app -w /app -e APOLLO_KEY=your_key apollo/rover rover graph check my-graph-id@current --schema ./schema.graphql

常用命令示例

• 发布GraphQL架构到Apollo Studio：

  bash
  docker run --rm -e APOLLO_KEY=your_key -v $(pwd):/app -w /app apollo/rover rover graph publish my-graph-id@current --schema ./schema.graphql
  

• 执行模式 lint 检查：

  bash
  docker run --rm -v $(pwd):/app -w /app apollo/rover rover graph lint --schema ./schema.graphql