Choisir un outil pour gérer le cycle de vie du cluster
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Google Distributed Cloud vous propose un choix d'outils pour créer des clusters et gérer les opérations du cycle de vie des clusters (mise à jour, mise à niveau et suppression) :
L'outil de ligne de commande bmctl, que vous exécutez sur votre poste de travail administrateur dans votre centre de données sur site. Vous créez un fichier de configuration qui décrit le réseau du cluster, l'équilibrage de charge et d'autres fonctionnalités du cluster. Vous spécifiez ce fichier sur la ligne de commande pour bmctl. Vous pouvez également exécuter kubectl sur votre poste de travail administrateur pour mettre à niveau et mettre à jour des clusters, et pour supprimer des clusters d'utilisateurs.
La Google Cloud console, Google Cloud CLI ou Terraform, que vous pouvez exécuter à partir de n'importe quel ordinateur disposant d'une connectivité réseau à l'API GKE On-Prem.
Ces outils standards utilisent l'API GKE On-Prem, qui s'exécute sur l'infrastructure Google Cloud. Collectivement, les outils standards sont appelés clients de l'API GKE On-Prem. Pour gérer le cycle de vie de vos clusters, l'API GKE On-Prem doit stocker les métadonnées sur l'état de votre cluster dansGoogle Cloud, dans la région Google Cloud que vous spécifiez lors de la création du cluster. Ces métadonnées permettent à l'API de gérer le cycle de vie du cluster et n'incluent pas de données spécifiques à la charge de travail.
Quel que soit l'outil que vous utilisez pour créer des clusters, les informations que vous collectez et fournissez à l'outil, telles que les adresses IP des machines de nœuds de cluster et les adresses VIP de l'équilibreur de charge, sont les mêmes.
Cette sélection vous permet de choisir l'outil le mieux adapté à votre cas d'utilisation et à votre environnement. Exemple :
Pour vos premières installations dans un environnement de développement, vous pouvez utiliser la console, car l'interface utilisateur fournit des conseils et une aide supplémentaires.
Si votre organisation utilise déjà la gcloud CLI ou Terraform pour gérer d'autres Google Cloud ressources, vous souhaiterez probablement utiliser ces outils pour Google Distributed Cloud.
Si votre organisation est soumise à des exigences ou des restrictions réglementaires, vous devrez peut-être limiter votre dépendance à Google Cloud et utiliser bmctl sur votre poste de travail administrateur pour créer des clusters et gérer leur cycle de vie.
Si vous créez un cluster avec bmctl, vous pouvez l'inscrire auprès de l'API GKE On-Prem après sa création, ce qui vous permet également d'utiliser les clients de l'API GKE On-Prem.
Limites des clients de l'API GKE On-Prem
L'outil bmctl a été fourni avec la première version de Google Distributed Cloud. Il est le plus abouti en termes de fonctionnalités compatibles. Nous vous recommandons d'examiner les fonctionnalités des clients d'API GKE On-Prem avant de faire votre choix. La liste suivante récapitule les limites actuelles. Consultez cette liste de temps en temps, car les clients de l'API GKE On-Prem évoluent.
Les clusters d'administrateur et d'utilisateur sont les seuls types de clusters acceptés.
Les dernières versions mineures ou de correctif ne sont disponibles dans l'API GKE On-Prem que sept à dix jours après leur publication.
Les fonctionnalités réseau avancées suivantes ne sont pas compatibles:
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/01 (UTC)."],[],[],null,["Google Distributed Cloud provides you a choice of tools to create clusters and\nmanage the cluster lifecycle operations (update, upgrade, and delete):\n\n- The command-line tool `bmctl`, which you run on your admin workstation in your on-premises data center. You create a [configuration file](/kubernetes-engine/distributed-cloud/bare-metal/docs/reference/cluster-config-ref) that describes the cluster network, load balancing, and other cluster features. You specify this file on the command line to `bmctl`. You can also run `kubectl` on your admin workstation to upgrade and update clusters and to delete user clusters.\n- The Google Cloud console, Google Cloud CLI, or [Terraform](https://www.terraform.io), which you can run from any computer that has network connectivity to the [GKE On-Prem API](/anthos/clusters/docs/on-prem-api/reference/rest). These standard tools use the GKE On-Prem API, which runs on Google Cloud infrastructure. Collectively, the standard tools are referred to as the *GKE On-Prem API clients*. To manage the lifecycle of your clusters, the GKE On-Prem API must store metadata about your cluster's state in Google Cloud, in the Google Cloud region that you specify when creating the cluster. This metadata lets the API manage the cluster lifecycle and doesn't include workload-specific data.\n\nNo matter which tool you use to create clusters, the information that\nyou gather and provide to the tool, such as the IP addresses\nof cluster node machines and load balancer VIPs, is the same.\n\nThis selection lets you choose the best tool for your use case and\nenvironment. For example:\n\n- For your first installations in a development environment, you might want to use the console because the user interface provides additional guidance and help.\n- If your organization already uses the gcloud CLI or Terraform to manage other Google Cloud resources, you will probably want to use these tools for Google Distributed Cloud as well.\n- If your organization has regulatory requirements or restrictions, you might need to limit your reliance on Google Cloud and use `bmctl` on your admin workstation to create clusters and manage cluster lifecycle.\n\nIf you create a cluster with `bmctl`, you can\n[enroll the cluster with the GKE On-Prem API](/kubernetes-engine/distributed-cloud/bare-metal/docs/how-to/enroll-cluster)\nafter the cluster is created, which lets you also use the GKE On-Prem API\nclients.\n\nLimitations with the GKE On-Prem API clients\n\nThe `bmctl` tool was shipped with the first release of Google Distributed Cloud,\nand it is the most mature as far as features that it supports. We recommend that\nyou review the functionality for the GKE On-Prem API clients when making a\nchoice. The following list summarizes current limitations. Check this list from\ntime to time as the GKE On-Prem API clients evolve.\n\n- Admin and user clusters are the only supported cluster types\n\n- The latest minor or patch versions aren't available in the GKE On-Prem API\n until 7 to 10 days after the release\n\n- The following advanced networking features aren't supported:\n\n - [IPv4/IPv6 dual-stack networking](/kubernetes-engine/distributed-cloud/bare-metal/docs/how-to/dual-stack-networking)\n - [IPv4 flat mode network model](/kubernetes-engine/distributed-cloud/bare-metal/docs/how-to/flat-network)\n\nWhat's next\n\n- `bmctl`\n\n - [Cluster configuration field reference](/kubernetes-engine/distributed-cloud/bare-metal/docs/reference/cluster-config-ref#cluster_configuration_fields)\n- gcloud CLI\n\n - [`gcloud container bare-metal clusters`](/sdk/gcloud/reference/container/bare-metal/clusters)\n\n - [`gcloud container bare-metal node-pools`](/sdk/gcloud/reference/container/bare-metal/node-pools)\n\n - [`gcloud container bare-metal admin-clusters`](/sdk/gcloud/reference/container/bare-metal/admin-clusters)\n\n- Terraform\n\n - [`google_gkeonprem_bare_metal_cluster`](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/gkeonprem_bare_metal_cluster)\n\n - [`google_gkeonprem_bare_metal_node_pool`](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/gkeonprem_bare_metal_node_pool)\n\n - [`google_gkeonprem_bare_metal_admin_cluster`](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/gkeonprem_bare_metal_admin_cluster)"]]
