Autocompletado de la CLI de gcloud

En esta página, se proporcionan instrucciones para configurar y usar la función de autocompletado de la CLI de gdcloud que te permite usar la tecla Tab para completar un comando ingresado parcialmente. Esta función está disponible para los shells de Bash, Zsh y Fish. El autocompletado de la CLI de gdcloud es una función que proporciona sugerencias para comandos y opciones a medida que escribes. Esto puede ser útil cuando no estás seguro de qué comando usar o cuando quieres usar un comando que no usaste antes.

Activa el autocompletado

Para activar la función de autocompletado, deberás ejecutar un comando para tu terminal. La función de autocompletado de la CLI de gdcloud está disponible para el sistema operativo Linux en los shells de Bash, Zsh y Fish. Usa el siguiente comando para averiguar qué shell usas.

echo $SHELL

El resultado se verá como bin/$SHELL, donde $SHELL es bash, zsh o fish.

Bash

Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:

source <(gdcloud completion bash)

Para cargar las finalizaciones en cada sesión nueva, ejecuta los siguientes comandos una vez:

gdcloud completion bash > gdcloud-completion.bash
sudo cp gdcloud-completion.bash /etc/bash_completion.d/

Zsh

Si la finalización de shell aún no está habilitada en tu entorno, debes habilitarla. Verifica si la finalización de shell está habilitada.

Verifica el valor de la variable COMP_LINE. Si el valor de la variable COMP_LINE está vacío, significa que la finalización de shell no está habilitada. Para verificar este valor, ejecuta el siguiente comando:

echo $COMP_LINE

Intenta usar la finalización de shell con un comando. Si intentas usar la finalización de shell con un comando y no funciona, significa que la finalización de shell no está habilitada. Por ejemplo, intenta escribir el siguiente comando y presionar Tab. Si la finalización de shell está habilitada, debes ver una lista de posibles finalizaciones para el comando ls.

ls

Verifica el resultado del comando compgen -c. Si el resultado del comando compgen -c no contiene comandos, significa que la finalización de shell no está habilitada. Puedes ejecutar el siguiente comando para ver el resultado del comando compgen -c. Si la finalización de shell está habilitada, el resultado del comando debe incluir una lista de comandos que tengan funciones de finalización.

compgen -c

Si no estás seguro de si la finalización de shell está habilitada en tu entorno, consulta la documentación de tu shell. Si la finalización de shell no está habilitada en tu entorno, ejecuta el siguiente comando para habilitarla:

echo "autoload -U compinit; compinit" >> ~/.zshrc

Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:

source <(gdcloud completion zsh); compdef _gdcloud gdcloud

Para cargar las finalizaciones en cada sesión, ejecuta lo siguiente una vez:

gdcloud completion zsh > "${fpath[1]}/_gdcloud"

Debes iniciar una nueva shell para que se aplique esta configuración.

Pescado

Para cargar las finalizaciones en tu sesión actual de shell, haz lo siguiente:

gdcloud completion fish | source

Para cargar las finalizaciones en cada sesión, ejecuta lo siguiente:

gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish

Debes iniciar una nueva shell para que se aplique esta configuración.

Usa el autocompletado

Para usar el autocompletado de la CLI de gdcloud, escribe los primeros caracteres del comando que quieres usar y, luego, presiona la tecla Tab. Si solo hay una finalización posible, se inserta automáticamente en la línea de comandos. Si el comando no se completa automáticamente, significa que hay varias finalizaciones posibles y debes presionar la tecla Tab nuevamente para ver todos los comandos posibles.

Ejemplos de autocompletado

Escribe un comando parcialmente y, luego, presiona Tab para completarlo:

gdcloud con <TAB>

Comando completo después de presionar Tab una vez:

gdcloud config

Escribe un comando parcialmente y, luego, presiona Tab dos veces para ver una lista de todos los comandos posibles:

gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters