Instala la CLI de Kf

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. Consulta Referencia de comandos de Kf para obtener una lista completa de los comandos de Kf disponibles.

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:

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

Instala la CLI

  1. Instala la CLI de Kf:

    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.

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

    Mac

    Con este comando, se instala kf para todos los usuarios del sistema.

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

    Cloud Shell

    Este comando instalará kf en tu instancia de Cloud Shell si usas bash. Es posible que tengas que modificar las instrucciones para otros shells.

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

    Windows

    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.

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

Actualiza la CLI

Si tienes una instalación existente de la CLI de Kf, puedes usar el siguiente procedimiento para actualizarla a la versión actual:

  1. 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.

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

    Mac

    Con este comando, se instala kf para todos los usuarios del sistema.

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

    Cloud Shell

    Este comando instalará kf en tu instancia de Cloud Shell si usas bash. Es posible que tengas que modificar las instrucciones para otros shells.

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

    Windows

    Esta acción descarga kf al directorio actual. Agrégalo a la ruta si deseas llamar desde cualquier otro lugar que no sea el directorio actual.

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

    • La versión de la CLI se muestra en Kf Client.
    • La versión del servidor Kf aparecerá en kf["app.kubernetes.io/version"].
    $ kf debug
    ...
    Version:
      Kf Client:                        v2.5.4
      Server version:                   v1.20.6-gke.1000
      kf["app.kubernetes.io/version"]:  v2.5.4
    ...