Gemini CLI 执行和部署

本文档介绍了如何运行 Gemini CLI 及其部署架构。

运行 Gemini CLI

有几种方法可以运行 Gemini CLI。您选择的选项取决于您打算如何使用 Gemini CLI。

这是推荐给最终用户安装 Gemini CLI 的方式。它涉及从 NPM 注册表下载 Gemini CLI 包。

全局安装：
bash
```
npm install -g @google/gemini-cli
```
然后，您可以从任何地方运行 CLI：
bash
```
gemini
```

NPX 执行：

bash

# 在不进行全局安装的情况下从 NPM 执行最新版本
npx @google/gemini-cli

为了安全性和隔离性，Gemini CLI 可以在容器内运行。这是 CLI 执行可能产生副作用的工具的默认方式。

直接从注册表运行： 您可以直接运行已发布的沙箱镜像。这对于只有 Docker 并想运行 CLI 的环境很有用。
bash
```
# 运行已发布的沙箱镜像
docker run --rm -it us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.1.1
```
使用 --sandbox 标志： 如果您已在本地安装了 Gemini CLI（使用上面描述的标准安装），您可以指示它在沙箱容器内运行。
bash
```
gemini --sandbox -y -p "在此处输入您的提示"
```

项目贡献者将希望直接从源代码运行 CLI。

开发模式： 此方法提供热重载，对于主动开发很有用。
bash
```
# 从仓库根目录
npm run start
```
类似生产模式（链接包）： 此方法通过链接本地包来模拟全局安装。这对于在生产工作流中测试本地构建很有用。
bash
```
# 将本地 cli 包链接到您的全局 node_modules
npm link packages/cli

# 现在您可以使用 `gemini` 命令运行本地版本
gemini
```

您可以直接从 GitHub 仓库运行 Gemini CLI 的最新提交版本。这对于测试仍在开发中的功能很有用。

bash

# 直接从 GitHub 的 main 分支执行 CLI
npx https://github.com/google-gemini/gemini-cli

上述执行方法得益于以下架构组件和流程：

NPM 包

Gemini CLI 项目是一个 monorepo，它向 NPM 注册表发布两个核心包：

这些包在执行标准安装和从源代码运行 Gemini CLI 时使用。

构建和打包流程

根据分发渠道，使用两种不同的构建流程：

NPM 发布： 为了发布到 NPM 注册表，@google/gemini-cli-core 和 @google/gemini-cli 中的 TypeScript 源代码使用 TypeScript 编译器（tsc）转译为标准的 JavaScript。生成的 dist/ 目录就是发布到 NPM 包中的内容。这是 TypeScript 库的标准方法。
GitHub npx 执行： 当直接从 GitHub 运行 Gemini CLI 的最新版本时，package.json 中的 prepare 脚本会触发一个不同的流程。该脚本使用 esbuild 将整个应用程序及其依赖项捆绑成一个单一的、自包含的 JavaScript 文件。此捆绑包是在用户机器上即时创建的，并且不会提交到仓库。

Docker 沙箱镜像

基于 Docker 的执行方法由 gemini-cli-sandbox 容器镜像支持。此镜像发布到容器注册表，并包含一个预先安装的全局版本的 Gemini CLI。

发布流程通过 GitHub Actions 自动化。发布工作流执行以下操作：