Scegli uno strumento per gestire il ciclo di vita del cluster
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Google Distributed Cloud offre una scelta di strumenti per creare cluster e gestire le operazioni del ciclo di vita dei cluster (aggiornamento, upgrade ed eliminazione):
Lo strumento a riga di comando bmctl, che esegui sulla workstation di amministrazione nel tuo data center on-premise. Devi creare un
file di configurazione
che descriva la rete del cluster, il bilanciamento del carico e altre funzionalità del cluster. Specifica questo file sulla riga di comando per bmctl. Puoi anche eseguire kubectl sulla workstation di amministrazione per eseguire l'upgrade e l'aggiornamento dei cluster e per eliminare i cluster utente.
La Google Cloud console, Google Cloud CLI o
Terraform,
che puoi eseguire da qualsiasi computer con connettività di rete all'API GKE On-Prem.
Questi strumenti standard utilizzano l'API GKE On-Prem, che viene eseguita sull' Google Cloud
infrastruttura. Nel loro insieme, gli strumenti standard sono chiamati
client dell'API GKE On-Prem. Per gestire il ciclo di vita dei cluster, l'API GKE On-Prem deve archiviare i metadati relativi allo stato del cluster inGoogle Cloud, nella regione Google Cloud specificata al momento della creazione del cluster. Questi metadati consentono all'API di gestire il ciclo di vita del cluster e non includono dati specifici del carico di lavoro.
Indipendentemente dallo strumento che utilizzi per creare i cluster, le informazioni che raccoglierai e fornirai allo strumento, come gli indirizzi IP delle macchine dei nodi del cluster e i VIP del bilanciatore del carico, sono le stesse.
Questa selezione ti consente di scegliere lo strumento migliore per il tuo caso d'uso e il tuo ambiente. Ad esempio:
Per le prime installazioni in un ambiente di sviluppo, ti consigliamo di utilizzare la console perché l'interfaccia utente fornisce indicazioni e assistenza aggiuntive.
Se la tua organizzazione utilizza già gcloud CLI o Terraform per gestire altre risorse Google Cloud , probabilmente vorrai utilizzare questi strumenti anche per Google Distributed Cloud.
Se la tua organizzazione ha requisiti o limitazioni normativi, potrebbe essere necessario limitare l'utilizzo di Google Cloud e di bmctl sulla tua workstation di amministrazione per creare cluster e gestire il loro ciclo di vita.
Se crei un cluster con bmctl, puoi
registrarlo con l'API GKE On-Prem
dopo la creazione, in modo da poter utilizzare anche i client dell'API GKE On-Prem.
Limitazioni dei client dell'API GKE On-Prem
Lo strumento bmctl è stato fornito con la prima release di Google Distributed Cloud ed è il più avanzato per quanto riguarda le funzionalità supportate. Ti consigliamo di esaminare la funzionalità dei client dell'API GKE On-Prem quando effettui una scelta. Il seguente elenco riassume le limitazioni attuali. Controlla questo elenco di volta in volta man mano che i client dell'API GKE On-Prem si evolvono.
I cluster di amministrazione e utente sono gli unici tipi di cluster supportati
Le versioni secondarie o patch più recenti non sono disponibili nell'API GKE On-Prem
fino a 7-10 giorni dopo il rilascio
Le seguenti funzionalità di networking avanzato non sono supportate:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)"]]
