安装Rover
Rover CLI安装指南:适用于Linux、Mac和Windows
(省略)Rover CLI适用于Linux、Mac和Windows。
安装方法
Linux / MacOS安装器
要安装最新版本的Rover:
curl -sSL https://rover.apollo.dev/nix/latest | sh
要安装特定版本的Rover(建议CI环境使用,以保证可预测的行为):
# Note the `v` prefixing the version numbercurl -sSL https://rover.apollo.dev/nix/v0.26.0-rc.0 | sh
如果您的机器没有安装curl
命令,您可以通过curl
下载页面.
目前rover supergraph compose
命令在Alpine Linux上还不可用。您可以在此问题中跟踪其对Alpine的支持进展。
Windows PowerShell安装程序
要安装Rover的最新版本:
iwr 'https://rover.apollo.dev/win/latest' | iex
要安装特定版本的Rover(建议CI环境使用,以保证可预测的行为):
# Note the `v` prefixing the version numberiwr 'https://rover.apollo.dev/win/v0.26.0-rc.0' | iex
npm
安装程序
Rover通过npm分发,以便与JavaScript项目集成。
从二进制镜像安装
内部,npm
安装程序从router的二进制文件下载自https://rover.apollo.dev
。如果此URL不可用,例如,在私有网络中,您可以通过以下两种方式中将npm
安装程序指向另一个URL:
-
设置环境变量
APOLLO_ROVER_DOWNLOAD_HOST
。此环境变量也会更改
rover supergraph compose
和rover dev
的插件下载的主机。默认情况下,rover dev
尝试安装router和composition的插件的最新版本。为了保持此行为,必须在二进制镜像的响应中存在X-Version: vX.X.X标题。为了避免需要此标题,可以使用APOLLO_ROVER_DEV_COMPOSITION_VERSION
和APOLLO_ROVER_DEV_ROUTER_VERSION
环境变量将该插件的版本固定。更多详情,请参阅rover dev的版本控制。 -
将以下内容添加到您的全局或本地
.npmrc
:
apollo_rover_download_host=https://your.mirror.com/repository
devDependencies
安装
运行以下命令以将rover
作为您的项目的一个devDependencies
安装:
npm install --save-dev @apollo/rover
您可以直接在您的 package.json
中调用 rover <参数>
,scripts部分,或者您可以在项目目录中运行 npx -p @apollo/rover rover <参数>
来执行命令。
当使用 npx
时,-p @apollo/rover
参数 是必要的,以便指定 @apollo/rover
包提供了 rover
命令。有关更多信息,请参阅 npx
's documentation。
全局安装
要将 rover
全局安装,以便您可以从计算机上的任何目录使用它,请运行以下命令:
npm install -g @apollo/rover
如果您没有使用版本管理器(如 nvm
)安装 npm
,您可能会在全局安装时遇到问题。如果您在尝试全局安装时遇到 EACCES
权限相关的错误,请不要使用 sudo
运行安装命令。此支持页面提供了有关如何解决此问题的信息。
二进制下载
您还可以 下载适用于您操作系统的 Rover 二进制文件并将其位置手动添加到您的 PATH
中。
非官方方法
社区维护了一些额外的安装方法
连接到 GraphOS
安装 Rover 之后,您应该使用 GraphOS 进行验证,因为其许多命令都与 GraphOS 进行通信。
运行以下命令
rover config auth
此命令指示您如何获取一个 个人API密钥 并帮助您设置配置文件。有关更多信息,请参阅 配置 Rover。