# 使用 Homebrew, Nix, zypper 安装 ctlptl

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

## 安装

```sh
sudo av install brew:ctlptl
```

## 代理安全回答

ctlptl manages local Kubernetes clusters and container registry wiring.

- **凭据访问:** Reads kubeconfig, local cluster config, and registry settings.
- **远程变更:** Primarily local, but can affect reachable Kubernetes contexts.
- **发布/制品风险:** Can change local cluster state used for builds and deploy tests.
- **推荐控制:** Gate cluster create/delete and registry mutation commands.
- **代理使用指南:** Allow status and config review; require approval for cluster lifecycle changes.

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install ctlptl
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#ctlptl
```

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

- zypper (92%):

```sh
sudo zypper install ctlptl
```

  证据: openSUSE Tumbleweed package metadata: ctlptl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:ctlptl
- **软件包管理器:** Homebrew
- **版本:** 0.9.4
- **来源摘要:** Making local Kubernetes clusters fun and easy to set up
- **主页:** <https://github.com/tilt-dev/ctlptl>
- **仓库:** <https://github.com/tilt-dev/ctlptl>
- **最后更新:** 2026-07-27T22:04:06+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- ctlptl (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

ctlptl is a Tilt-developed CLI for declaratively creating and managing local Kubernetes clusters. It uses Kubernetes-style YAML to drive local cluster products such as Docker Desktop, kind, k3d, and minikube.

### 项目历史

The README says ctlptl was inspired by kubectl and Cluster API's clusterctl, with the idea that users declare a local cluster in YAML and let the CLI set it up. Tilt created it after helping teams debug repeated local-development environment misconfigurations.

The project reached v0.1.0 in November 2020 and has continued as a 0.x tool, with official release artifacts reaching v0.9.4 in June 2026.

### 采用历史

Official installation paths include Homebrew on macOS and Linux, Scoop on Windows, and go install. The README emphasizes interoperability with common local Kubernetes products rather than replacing them.

### 使用方式

Common commands include ctlptl get, create cluster, apply -f cluster.yaml, and delete -f cluster.yaml. Typical package use is in developer-workstation setup scripts and CI-friendly local-cluster recipes where a registry, CPU limits, Kubernetes version, or Docker Desktop setting needs to be repeatable.

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

ctlptl is packaging glue for the local Kubernetes stack: it wraps existing cluster implementations, exposes declarative YAML, and provides package-manager-friendly binaries for developers who want reproducible local infrastructure without maintaining bespoke shell scripts.

### 时间线

- 2020: v0.1.0 release published.
- 2020: Early releases added declarative local-cluster workflows around kind, k3d, minikube, and Docker Desktop.
- 2026: v0.9.4 release published.

### Related projects

- ctlptl is explicitly related to kubectl, Cluster API's clusterctl, kind, k3d, minikube, Docker Desktop, and Tilt's local-development tooling.

### 来源

- <https://github.com/tilt-dev/ctlptl#readme>
- <https://github.com/tilt-dev/ctlptl/tree/main/docs>
- <https://api.github.com/repos/tilt-dev/ctlptl/releases?per_page=100>


## 安全说明

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: cluster.yaml
## 其他软件包管理器记录

- Nix - ctlptl: normalized package name match | nixpkgs package indexes: pkgs/by-name/ct/ctlptl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - ctlptl - 0.9.4-1.3: normalized package name match | openSUSE Tumbleweed package metadata: ctlptl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI for declaratively setting up local Kubernetes clusters | https://github.com/tilt-dev/ctlptl
- zypper - ctlptl-bash-completion - 0.9.4-1.3: normalized package name match | openSUSE Tumbleweed package metadata: ctlptl-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for ctlptl | https://github.com/tilt-dev/ctlptl
- zypper - ctlptl-fish-completion - 0.9.4-1.3: normalized package name match | openSUSE Tumbleweed package metadata: ctlptl-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for ctlptl | https://github.com/tilt-dev/ctlptl
- zypper - ctlptl-zsh-completion - 0.9.4-1.3: normalized package name match | openSUSE Tumbleweed package metadata: ctlptl-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for ctlptl | https://github.com/tilt-dev/ctlptl


## Combined YAML source

View the package source record on GitHub. [combined/ctlptl.yml](https://github.com/mxcl/pkgdb/blob/main/combined/ctlptl.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
- curated agent safety answer
