# Installer clusterctl avec Homebrew, Nix, zypper, winget Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de clusterctl pour les workflows d'agents IA. ## installation ```sh sudo av install brew:clusterctl ``` Commandes d'installation supplémentaires: ### macOS - Homebrew (100%): ```sh brew install clusterctl ``` Preuve: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#clusterctl ``` Preuve: nixpkgs package indexes: pkgs/by-name/cl/clusterctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install clusterctl ``` Preuve: openSUSE Tumbleweed package metadata: clusterctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst ### Windows - winget (92%): ```sh winget install --id Kubernetes.clusterctl -e ``` Preuve: Windows Package Manager source index: Kubernetes.clusterctl from https://cdn.winget.microsoft.com/cache/source.msix ## Faits du paquet - **Clé du paquet:** brew:clusterctl - **Gestionnaire de paquets:** Homebrew - **Page du gestionnaire de paquets:** - **Version:** 1.13.4 - **Résumé source:** Home for the Cluster Management API work, a subproject of sig-cluster-lifecycle - **Page d'accueil:** - **Dépôt:** - **Docs amont:** - **Licence:** Apache-2.0 - **Archive source:** - **Dernière mise à jour:** 2026-07-27T22:04:02+02:00 - **Généré:** 2026-08-04T22:13:35+00:00 ## exécutables - clusterctl (cli) - clusterctl (alias) ## Dépendances de compilation - go ## Comportement d'installation - hook post-installation: non défini - Bouteille: disponible sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Version et fraîcheur - page générée: 2026-08-04 - version du gestionnaire: 1.13.4 - gestionnaire mis à jour: 2026-07-27 - données locales: OK - dépôt amont: https://github.com/kubernetes-sigs/cluster-api - dernière version détectée: v1.13.4 (à jour) ## Historique du projet et usages clusterctl is the command-line tool for bootstrapping and managing Kubernetes Cluster API providers and management clusters. ### Historique du projet 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. ### Historique d'adoption 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. ### Modes d'utilisation 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. ### Pourquoi les passionnés de paquets s'y intéressent 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. ### Chronologie - 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. ### Sources - - - - ## Notes de sécurité infrastructure mutation or orchestration signal. - **Risque Geiger:** orange / moyen - 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: $XDG_CONFIG_HOME/cluster-api/clusterctl.yaml ## Détails de la base source - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** clusterctl - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Autres enregistrements de gestionnaires de paquets - Nix - clusterctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/cl/clusterctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper - clusterctl - 1.13.4-1.2: normalized package name match | openSUSE Tumbleweed package metadata: clusterctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CLI tool to handle the lifecycle of a Cluster API management cluster | https://github.com/kubernetes-sigs/cluster-api - zypper - clusterctl-bash-completion - 1.13.4-1.2: normalized package name match | openSUSE Tumbleweed package metadata: clusterctl-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for clusterctl | https://github.com/kubernetes-sigs/cluster-api - zypper - clusterctl-fish-completion - 1.13.4-1.2: normalized package name match | openSUSE Tumbleweed package metadata: clusterctl-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for clusterctl | https://github.com/kubernetes-sigs/cluster-api - zypper - clusterctl-zsh-completion - 1.13.4-1.2: normalized package name match | openSUSE Tumbleweed package metadata: clusterctl-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for clusterctl | https://github.com/kubernetes-sigs/cluster-api - winget - Kubernetes.clusterctl: normalized package name match | Windows Package Manager source index: Kubernetes.clusterctl from https://cdn.winget.microsoft.com/cache/source.msix ## Liens liés - [Cloud CLI packages](https://pkg.so/fr/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Secret-risk packages](https://pkg.so/fr/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://pkg.so/fr/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://pkg.so/fr/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://pkg.so/fr/brew/go/) - Build dependency declared by Homebrew. - [kubernetes-cli](https://pkg.so/fr/brew/kubernetes-cli/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [k9s](https://pkg.so/fr/brew/k9s/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [cmctl](https://pkg.so/fr/brew/cmctl/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [kops](https://pkg.so/fr/brew/kops/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [rke](https://pkg.so/fr/brew/rke/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [clusterawsadm](https://pkg.so/fr/brew/clusterawsadm/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, cluster-api, kubernetes. - [k3d](https://pkg.so/fr/brew/k3d/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, kubernetes. - [ctlptl](https://pkg.so/fr/brew/ctlptl/) - Shares pkgdb curated category or tags: cli, cloud-infrastructure, kubernetes. ## Combined YAML source View the package source record on GitHub. [combined/clusterctl.yml](https://github.com/mxcl/pkgdb/blob/main/combined/clusterctl.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph