Heroku CLI

概述

Heroku CLI 是一个用于管理 Heroku 应用和服务的命令行界面。它基于 Node.js 和 oclif 构建，提供了可扩展的架构，便于与 Heroku 平台交互。

如需了解更多关于 Heroku 的信息，请访问 https://www.heroku.com/home

如需开始使用，请访问 https://devcenter.heroku.com/start

CLI 的主要功能包括：

• 应用管理 - 部署、扩展和监控应用
• Heroku Postgres 数据库管理 - 备份、恢复和管理 Heroku Postgres 数据库
• Heroku CI/CD 流水线 - 运行自动化测试，并管理评审应用，以简化部署工作流
• 附加组件市场 - 配置和管理用于扩展应用的工具与服务
• SSL 证书和域名 - 配置自定义域名并自动管理 SSL/TLS 证书
• 团队协作 - 通过精细化权限管理组织和团队访问权限
• Private Spaces - 在支持 VPN 的网络隔离环境中部署应用
• 日志和监控 - 流式传输应用日志并将其转发到外部服务
• 插件生态系统 - 通过社区插件和自定义插件扩展功能

如需了解更多关于开发插件的信息，请阅读开发 CLI 插件

问题

如遇到与 CLI 直接相关的问题，请在 GitHub 上提交问题。

如有其他问题，请提交支持工单。

贡献者

命令主题

• heroku access - 管理应用的用户访问权限
• heroku accounts - 列出缓存中的 Heroku 账户
• heroku addons - 用于开发、扩展和运营应用的工具与服务
• heroku apps - 管理 Heroku 上的应用
• heroku auth - 管理 Heroku 账户的身份验证
• heroku authorizations - OAuth 授权
• heroku autocomplete - 显示自动补全安装说明
• heroku buildpacks - 用于编译应用的脚本
• heroku certs - SSL 证书
• heroku ci - Heroku Pipelines 的测试运行器
• heroku clients - 平台上的 OAuth 客户端
• heroku config - 应用的环境变量
• heroku container - 将基于 Docker 的应用部署到 Heroku
• heroku data - 列出应用数据附加组件的维护任务
• heroku domains - 应用的自定义域名
• heroku drains - 将日志转发到 syslog 或 HTTPS
• heroku features - 添加或移除应用功能
• heroku git - 设置 git 远程地址并克隆 Heroku 仓库
• heroku help - 显示 heroku 的帮助信息。
• heroku keys - 添加或移除账户 SSH 密钥
• heroku labs - 添加或移除实验性功能
• heroku local - 在本地运行 Heroku 应用
• heroku logs - 显示最近的日志输出
• heroku maintenance - 启用或禁用对应用的访问
• heroku mcp - 以 stdio 模式启动 Heroku 平台 MCP 服务
• heroku members - 管理组织成员
• heroku notifications - 显示通知
• heroku orgs - 管理组织
• heroku pg - 管理 postgresql 数据库
• heroku pipelines - 管理流水线
• heroku plugins - 列出已安装的插件。
• heroku ps - 管理应用 dyno
• heroku redis - 管理 heroku redis 实例
• heroku regions - 列出可用于部署的区域
• heroku releases - 显示应用的发布版本
• heroku repl - 进入交互式 REPL 会话以运行 Heroku CLI 命令
• heroku reviewapps - 管理流水线中的 reviewapps
• heroku run - 在 Heroku dyno 中运行一次性进程
• heroku search - 搜索命令。
• heroku sessions - OAuth 会话
• heroku spaces - 列出可用的空间
• heroku status - 显示 Heroku 平台的当前状态
• heroku teams - 管理团队
• heroku telemetry - 列出遥测 drains
• heroku update - 更新 Heroku CLI
• heroku usage - 列出团队中某个或多个应用所附加的计量附加组件的用量
• heroku version - 显示特定 CLI 版本的变更日志信息
• heroku webhooks - 列出应用上的 webhooks

开发

克隆仓库后

1. 运行 npm install 安装依赖项
2. 运行 npm run build 构建 CLI。每次进行更改并希望在本地测试时，都需要重新运行此命令。

要在本地执行 Heroku CLI 命令，请使用 ./bin/run <command>。例如，要使用本地代码运行 heroku apps 命令，请在根目录中运行 ./bin/run apps。

测试

运行 npm test 执行所有测试。

调试

使用 WebStorm（来自 JetBrains / IntelliJ），可以运行/调试单个测试用例。

• 创建新的运行/调试配置
• 选择“Mocha”类型

贡献

请阅读我们的贡献指南以及PR 模板。