# 使用 Homebrew, Nix 安装 bosh-cli

查看 bosh-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:bosh-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install bosh-cli
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#bosh-cli
```

  证据: nixpkgs package indexes: pkgs/by-name/bo/bosh-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:bosh-cli
- **软件包管理器:** Homebrew
- **版本:** 7.10.8
- **来源摘要:** Cloud Foundry BOSH CLI v2
- **主页:** <https://bosh.io/docs/cli-v2/>
- **仓库:** <https://github.com/cloudfoundry/bosh-cli>
- **最后更新:** 2026-07-28T04:53:59Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- bosh-cli (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 7.10.8
## 项目历史与用法

BOSH CLI is the command-line interface for Cloud Foundry BOSH, the release engineering, deployment, and lifecycle-management system used to operate large distributed software across clouds.

### 项目历史

BOSH began as Cloud Foundry infrastructure tooling, combining release packaging, stemcells, deployment manifests, VM lifecycle management, monitoring, recovery, and rolling updates. The BOSH site presents it as a project for managing both small and large-scale cloud software.

The Homebrew package is specifically the Go-based BOSH CLI v2 line. Its repository was created in 2016, and BOSH documentation distinguishes it from the older Ruby-based CLI v1, noting that v2 is stateless and uses hyphenated single commands.

### 采用历史

BOSH CLI adoption follows BOSH itself: Cloud Foundry operators use it to deploy directors, upload releases and stemcells, inspect deployments, run errands, and apply manifest changes. Cloud Foundry deployment documentation explicitly says Cloud Foundry leverages BOSH for deployment, lifecycle management, and distributed-systems monitoring.

The batch input records Homebrew and Nix packaging, reflecting its role as an operator workstation tool rather than an end-user application.

### 使用方式

Operators use the CLI to target BOSH environments, log in, interpolate variables, upload releases and stemcells, deploy manifests, inspect VMs, run tasks, and manage BOSH releases. The CLI docs are organized around those operational commands.

The CLI stores its local configuration under ~/.bosh/config, but v2 expects more state to be supplied explicitly through environments, aliases, flags, and manifest files compared with the old Ruby CLI workflow.

### 为什么软件包爱好者会关心

BOSH CLI is significant because it is one of the classic Cloud Foundry operator tools: small as a package, but connected to a deep ecosystem of releases, stemcells, directors, CPIs, and cloud deployments.

The v1-to-v2 transition is package-history relevant because it moved the operator CLI from a Ruby gem era to a Go binary era, changing installation and packaging expectations.

### 时间线

- 2016-08: Official GitHub repository metadata shows cloudfoundry/bosh-cli created.
- 2018: GitHub release metadata shows v5.0.1 in the public release feed.
- 2026: Repository metadata and package-manager input show ongoing maintenance and Homebrew/Nix distribution.

### Related projects

- cloudfoundry/bosh is the wider BOSH release and director project that the CLI operates.
- bosh-deployment provides manifests and operations files for deploying BOSH directors.
- Cloud Foundry cf-deployment is a major downstream deployment workflow that relies on BOSH.

### 来源

- <https://api.github.com/repos/cloudfoundry/bosh-cli>
- <https://bosh.io/>
- <https://bosh.io/docs/cli-v2-diff/>
- <https://bosh.io/docs/cli-v2-install/>
- <https://bosh.io/docs/cli-v2/>
- <https://docs.cloudfoundry.org/deploying/index.html>
- <https://github.com/cloudfoundry/bosh-cli>
- source_facts.package-manager


## 安全说明

infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.bosh/config
## 其他软件包管理器记录

- Nix - bosh-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/bo/bosh-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/bosh-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bosh-cli.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
