インストール

追加のインストールコマンド

macOS

Homebrew確認済み · 100%

brew install clusterctl

local Homebrew formula metadata

Linux

Nix確認済み · 92%

nix profile install nixpkgs#clusterctl

nixpkgs package indexes · pkgs/by-name/cl/clusterctl/package.nix · ソース: api.github.com

openSUSE zypper確認済み · 92%

sudo zypper install clusterctl

openSUSE Tumbleweed package metadata · clusterctl · ソース: download.opensuse.org

Windows

Windows Package Manager確認済み · 92%

winget install --id Kubernetes.clusterctl -e

Windows Package Manager source index · Kubernetes.clusterctl · ソース: cdn.winget.microsoft.com

概要

パッケージ概要

Home for the Cluster Management API work, a subproject of sig-cluster-lifecycle

プロジェクトリンク

コマンドとエイリアス

clusterctl

履歴

プロジェクトの歴史と使われ方

clusterctl is the command-line tool for bootstrapping and managing Kubernetes Cluster API providers and management clusters.

プロジェクトの歴史

The Cluster API project was started by Kubernetes SIG Cluster Lifecycle to provide declarative APIs and tooling for provisioning, upgrading, and operating multiple Kubernetes clusters.

clusterctl became the user-facing CLI for that project. The official docs say it handles the lifecycle of a Cluster API management cluster, provides a simple day-1 experience, fetches provider component YAML, installs providers, and encodes best practices for provider management and upgrades.

採用の歴史

clusterctl adoption follows Cluster API adoption across infrastructure providers. The docs describe default provider repositories sponsored by SIG Cluster Lifecycle and a provider contract that lets infrastructure, bootstrap, and control-plane providers publish release assets for clusterctl.

The input package facts show distribution through Homebrew, Nix, winget, and zypper, which matches its role as a cross-platform Kubernetes operations CLI.

使われ方

Common commands include `clusterctl init` for management-cluster initialization, `clusterctl generate cluster` for workload-cluster templates, `clusterctl move` for moving Cluster API objects between management clusters, and `clusterctl upgrade plan/apply` for provider upgrades.

clusterctl uses `$XDG_CONFIG_HOME/cluster-api/clusterctl.yaml` for provider repository configuration, variable substitution values, image overrides, and options such as log level or version-check behavior.

パッケージ好きにとっての重要性

clusterctl matters to package maintainers because it is the small local binary that wires a large Kubernetes provider ecosystem together: it discovers releases, fetches YAML assets, talks to GitHub or Go proxies, and applies provider contracts across platforms.

It is also a classic modern infrastructure CLI: a single executable distributed by OS package managers while its real work coordinates remote releases, Kubernetes manifests, and cluster lifecycle state.

タイムライン

2019: Cluster API GitHub releases include early v0.1.x and v0.3.x releases.
2021: Cluster API v1.0.0 was published.
2024: Cluster API v1.7 and v1.8 release candidates were published.
2026: The Cluster API book documents v1.13 and current clusterctl behavior.

Related projects

Cluster API is the parent project for clusterctl.
kubeadm is discussed in the official Cluster API introduction as prior SIG Cluster Lifecycle tooling that reduced Kubernetes bootstrap complexity.
Cluster API providers such as Cluster API Provider AWS implement the provider contracts that clusterctl consumes.

ソース

セキュリティ状態

リスクレベル: orange

infrastructure mutation or orchestration signal.

リスク分類器

リスク orange · 信頼度中 · infrastructure

理由

infrastructure mutation or orchestration signal

信号

text:cluster

インストール挙動

formula メタデータに Homebrew post-install フックは記録されていません。
Homebrew bottle メタデータは 6 個のプラットフォームターゲットで利用できます。
ビルドメタデータには 1 件のビルド依存関係があります。

推奨レビュー

エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。

local files

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

Config paths the tool may read or write during local use.

Unix: $XDG_CONFIG_HOME/cluster-api/clusterctl.yaml

実行可能ファイル

インストールされる実行可能ファイル

コマンド	種類	公開範囲	メモ
`clusterctl`	cli	グローバル実行可能ファイル

鮮度

バージョンと鮮度

これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。

ページ生成日2026-07-25

マネージャ版1.13.4

マネージャ更新日2026-07-15

ローカルデータOK

上流最新

検出された最新v1.13.4

https://github.com/kubernetes-sigs/cluster-api

OK鮮度警告は生成されていません。

インストールメタデータ

パッケージメタデータ

パッケージキー	brew:clusterctl
バージョン	1.13.4
パッケージマネージャ	Homebrew
パッケージマネージャページ	https://formulae.brew.sh/formula/clusterctl
ホームページ	https://cluster-api.sigs.k8s.io
リポジトリ	https://github.com/kubernetes-sigs/cluster-api
上流ドキュメント	https://cluster-api.sigs.k8s.io/clusterctl/configuration
ライセンス	Apache-2.0
ソースアーカイブ	https://github.com/kubernetes-sigs/cluster-api/archive/refs/tags/v1.13.4.tar.gz
最終更新	2026-07-15T20:59:17Z
Pulse	updated
ビルド依存関係	go
Bottle	利用可能 (対象 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定義
サービス	宣言なし

レジストリ情報

ソースデータベース詳細

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	clusterctl
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

ソースデータベース一致

他のパッケージマネージャ記録

一致は外部パッケージマネージャインデックスから取得され、ローカルの Automic Vault パッケージリンクとは分けて表示されます。

Nix95%

clusterctl

nix profile install nixpkgs#clusterctl

normalized package name match
一致条件: Clusterctl

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/cl/clusterctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

zypper95%

clusterctl 1.13.1-1.1

CLI tool to handle the lifecycle of a Cluster API management cluster

https://github.com/kubernetes-sigs/cluster-api

sudo zypper install clusterctl

License: Apache-2.0
Category: Unspecified
Architecture: x86_64
Source Package: clusterctl
1 依存関係
1 提供
normalized package name match
一致条件: Clusterctl

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: clusterctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

clusterctl-bash-completion 1.13.1-1.1

Bash Completion for clusterctl

https://github.com/kubernetes-sigs/cluster-api

sudo zypper install clusterctl-bash-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: clusterctl
2 依存関係
1 提供
normalized package name match
一致条件: Clusterctl

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: clusterctl-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

clusterctl-fish-completion 1.13.1-1.1

Fish Completion for clusterctl

https://github.com/kubernetes-sigs/cluster-api

sudo zypper install clusterctl-fish-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: clusterctl
1 依存関係
1 提供
normalized package name match
一致条件: Clusterctl

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: clusterctl-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

clusterctl-zsh-completion 1.13.1-1.1

Zsh Completion for clusterctl

https://github.com/kubernetes-sigs/cluster-api

sudo zypper install clusterctl-zsh-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: clusterctl
1 依存関係
1 提供
normalized package name match
一致条件: Clusterctl

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: clusterctl-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

winget95%

Kubernetes.clusterctl

winget install --id Kubernetes.clusterctl -e

normalized package name match
一致条件: Clusterctl

Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: Kubernetes.clusterctl from https://cdn.winget.microsoft.com/cache/source.msix

パッケージグラフ

リンクは、ローカルのパッケージ関係グラフ、補足データ、依存関係、エコシステム一致、パッケージハブ所属から来ています。

ソース経路

リポジトリデータから生成

このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。

Combined YAML source

View the package source record on GitHub.

combined/clusterctl.yml

使用ソース

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

clusterctl を Homebrew, Nix, zypper, winget でインストール

追加のインストールコマンド

macOS

Linux

Windows

パッケージ概要

プロジェクトリンク

コマンドとエイリアス

プロジェクトの歴史と使われ方

プロジェクトの歴史

採用の歴史

使われ方

パッケージ好きにとっての重要性

タイムライン

Related projects

ソース

リスクレベル: orange

リスク分類器

理由

信号

インストール挙動

推奨レビュー

Configuration and credential file locations

Configuration files

インストールされる実行可能ファイル

バージョンと鮮度

パッケージメタデータ

ソースデータベース詳細

他のパッケージマネージャ記録

内部パッケージリンク

トピック別ハブ

関連ツール

同じワークフロー

エージェント安全ガイド

リポジトリデータから生成

Combined YAML source

使用ソース