Instalar la CLI de Kf

En este documento se describe cómo instalar la CLI de Kf. Normalmente, la CLI de Kf se instala cuando ya se tiene acceso a un clúster de GKE que ejecuta Kf. Esto significa que puedes empezar 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 conectarte al clúster de Kf, puedes ejecutar cualquiera de los comandos de Kf. Para ver una lista completa de los comandos de Kf disponibles, consulta la referencia de comandos de Kf.

Antes de empezar

Para poder usar la CLI de Kf, debes tener acceso a un clúster de GKE que ejecute una instalación completa de Kf. Esto significa que has ejecutado el siguiente comando para conectarte al clúster:

gcloud container clusters get-credentials CLUSTER_NAME \
    --project=CLUSTER_PROJECT_ID \
    --zone=CLUSTER_LOCATION

Instalar la CLI

  1. Instala la CLI de Kf:

    Linux

    Este comando instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña Cloud Shell para instalarlo solo para ti.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-linux /tmp/kf
    chmod a+x /tmp/kf
    sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    Este comando instala kf para todos los usuarios del sistema.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-darwin /tmp/kf
    chmod a+x /tmp/kf
    sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Este comando instala kf en tu instancia de Cloud Shell si usas bash. Si usas otro shell, es posible que tengas que modificar las instrucciones.

    mkdir -p ~/bin
    gcloud storage cp gs://kf-releases/v2.7.3/kf-linux ~/bin/kf
    chmod a+x ~/bin/kf
    echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
    source ~/.bashrc

    Windows

    Este comando descarga kf en el directorio actual. Añádela a la ruta si quieres llamarla desde cualquier otro directorio que no sea el actual.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-windows.exe kf.exe

Actualizar la CLI

Si ya tienes instalada la CLI de Kf, puedes usar el siguiente procedimiento para actualizarla a la versión actual.

  1. Instala la CLI:

    Linux

    Este comando instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña Cloud Shell para instalarlo solo para ti.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-linux /tmp/kf
    chmod a+x /tmp/kf
    sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    Este comando instala kf para todos los usuarios del sistema.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-darwin /tmp/kf
    chmod a+x /tmp/kf
    sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Este comando instala kf en tu instancia de Cloud Shell si usas bash. Si usas otro shell, es posible que tengas que modificar las instrucciones.

    mkdir -p ~/bin
    gcloud storage cp gs://kf-releases/v2.7.3/kf-linux ~/bin/kf
    chmod a+x ~/bin/kf
    echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
    source ~/.bashrc

    Windows

    De esta forma, se descarga kf en el directorio actual. Añádela a la ruta si quieres llamarla desde cualquier otro directorio que no sea el actual.

    gcloud storage cp gs://kf-releases/v2.7.3/kf-windows.exe kf.exe
  2. Valida que las versiones de la CLI de Kf y del servidor de Kf coincidan:

    • La versión de la CLI aparece en Kf Client.
    • La versión del servidor Kf se indica en kf["app.kubernetes.io/version"].
    $ kf debug
    ...
    Version:
      Kf Client:                        v2.7.3
      Server version:                   v1.21.3-gke.2001
      kf["app.kubernetes.io/version"]:  v2.7.3
    ...