Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo instalar la CLI de Kf.
Por lo general, instalarás la CLI de Kf cuando ya tengas acceso a un clúster de GKE que ejecuta Kf.
Esto significa que puedes comenzar a usar los comandos de Kf sin tener que crear primero tu propio clúster de GKE.
Después de instalar la CLI de Kf y de conectarte al clúster de Kf, puedes ejecutar cualquiera de los comandos.
Para obtener una lista completa de los comandos Kf disponibles, consulta la referencia de los comandos de Kf.
Antes de comenzar
Antes de que puedas usar la CLI de Kf, debes tener acceso a un clúster de GKE que ejecute una instalación de Kf completa.
Esto significa que ejecutaste el siguiente comando para conectarte al clúster:
Con este comando, se instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña de Cloud Shell para instalarlo tú mismo.
Con este comando, se descarga kf en el directorio actual. Agrégalo a la ruta si deseas llamar desde cualquier otro lugar que no sea el directorio actual.
Si tienes una instalación existente de la CLI de Kf, puedes usar el siguiente procedimiento para actualizarla a la versión actual.
Instala la CLI:
Linux
Con este comando, se instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña de Cloud Shell para instalarlo tú mismo.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Install the Kf CLI\n\nThis document describes how to install the Kf CLI.\nYou typically install the Kf CLI when you already\nhave access to a GKE cluster running Kf.\nThat means that you can get started using Kf commands without\nhaving to first create your own GKE cluster.\n\nAfter installing the Kf CLI and connecting to the\nKf cluster, you can run any of the Kf commands.\nFor a complete list of the available Kf commands, see the\n[Kf command reference](/migrate/kf/docs/2.10/cli).\n\nBefore you begin\n----------------\n\nBefore you can use the Kf CLI, you must have\naccess to a GKE cluster running a full Kf installation.\nThat means that you have run the following command to connect to the cluster: \n\n```\ngcloud container clusters get-credentials CLUSTER_NAME \\\n --project=CLUSTER_PROJECT_ID \\\n --zone=CLUSTER_LOCATION\n```\n\nInstall the CLI\n---------------\n\n1. Install the Kf CLI:\n\n ### Linux\n\n This command installs the Kf CLI for all users on the system. Follow the\n instructions in the Cloud Shell tab to install it just for yourself. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-linux /tmp/kf\n chmod a+x /tmp/kf\n sudo mv /tmp/kf /usr/local/bin/kf\n\n ### Mac\n\n This command installs `kf` for all users on the system. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-darwin /tmp/kf\n chmod a+x /tmp/kf\n sudo mv /tmp/kf /usr/local/bin/kf\n\n ### Cloud Shell\n\n This command installs `kf` on your Cloud Shell instance if you use `bash`,\n the instructions may need to be modified for other shells. \n\n mkdir -p ~/bin\n gcloud storage cp gs://kf-releases/v2.10.0/kf-linux ~/bin/kf\n chmod a+x ~/bin/kf\n echo \"export PATH=$HOME/bin:$PATH\" \u003e\u003e ~/.bashrc\n source ~/.bashrc\n\n ### Windows\n\n This command downloads `kf` to current directory. Add it to the path if you\n want to call if from anywhere other than the current directory. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-windows.exe kf.exe\n\nUpgrade the CLI\n---------------\n\nIf you have an existing installation of the Kf CLI,\nthen you can use the following procedure to upgrade it to the current version.\n\n1. Install the CLI:\n\n ### Linux\n\n This command installs the Kf CLI for all users on the system. Follow the\n instructions in the Cloud Shell tab to install it just for yourself. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-linux /tmp/kf\n chmod a+x /tmp/kf\n sudo mv /tmp/kf /usr/local/bin/kf\n\n ### Mac\n\n This command installs `kf` for all users on the system. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-darwin /tmp/kf\n chmod a+x /tmp/kf\n sudo mv /tmp/kf /usr/local/bin/kf\n\n ### Cloud Shell\n\n This command installs `kf` on your Cloud Shell instance if you use `bash`,\n the instructions may need to be modified for other shells. \n\n mkdir -p ~/bin\n gcloud storage cp gs://kf-releases/v2.10.0/kf-linux ~/bin/kf\n chmod a+x ~/bin/kf\n echo \"export PATH=$HOME/bin:$PATH\" \u003e\u003e ~/.bashrc\n source ~/.bashrc\n\n ### Windows\n\n This downloads `kf` to current directory. Add it to the path if you\n want to call if from anywhere other than the current directory. \n\n gcloud storage cp gs://kf-releases/v2.10.0/kf-windows.exe kf.exe\n\n2. Validate the Kf CLI and\n Kf server versions match:\n\n - The CLI version is listed under `Kf Client`.\n - The Kf server version is listed under `kf[\"app.kubernetes.io/version\"]`.\n\n $ kf debug\n ...\n Version:\n Kf Client: v2.10.0\n Server version: v1.21.6-gke.1500\n kf\\[\"app.kubernetes.io/version\"\\]: v2.10.0\n ..."]]
