En esta página se explica cómo configurar y usar la función de autocompletar de la CLI de gdcloud, que te permite usar la tecla Tab para completar un comando introducido parcialmente. Esta función está disponible para los shells Bash, Zsh y Fish. La función de autocompletado de la CLI de gdcloud ofrece sugerencias de comandos y opciones mientras escribes. Esto puede ser útil cuando no sepas qué comando usar o cuando quieras usar un comando que no hayas usado antes.
Activar autocompletado
Para activar la función de autocompletar, tendrás que ejecutar un comando en tu terminal. La función de autocompletado de la CLI de gdcloud está disponible para el sistema operativo Linux en los shells Bash, Zsh y Fish. Usa el siguiente comando para saber qué shell usas.
echo $SHELL
La salida tiene el siguiente aspecto: bin/$SHELL, donde $SHELL es bash, zsh o fish.
Bash
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
source <(gdcloud completion bash)
Para cargar las finalizaciones en cada sesión nueva, ejecuta el siguiente comando una vez:
gdcloud completion bash > /etc/bash_completion.d/gdcloud
Zsh
Si la función de autocompletado de shell no está habilitada en tu entorno, debes habilitarla. Comprueba si la función de autocompletado de shell está habilitada.
Comprueba el valor de la variable COMP_LINE. Si el valor de la variable COMP_LINE está vacío, no se habilita la función de autocompletado de shell. Puedes comprobar este valor ejecutando el siguiente comando:
echo $COMP_LINE
Intenta usar la función de autocompletado de shell con un comando. Si intentas usar la función de autocompletado de shell con un comando y no funciona, significa que no está habilitada. Por ejemplo, prueba a escribir el siguiente comando y a pulsar Tab. Si la función de autocompletado de shell está habilitada, deberías ver una lista de posibles opciones para el comando ls.
ls
Comprueba el resultado del comando compgen -c. Si la salida del comando compgen -c no contiene ningún comando, la función de autocompletado de shell no está habilitada. Puedes ejecutar el siguiente comando para ver el resultado del comando compgen -c. Si la función de autocompletado de shell está habilitada, el resultado del comando debería incluir una lista de comandos que tengan funciones de autocompletado.
compgen -c
Si no sabes si la función de autocompletado de shell está habilitada en tu entorno, consulta la documentación de tu shell. Si la función de autocompletado de shell no está habilitada en tu entorno, ejecuta el siguiente comando para habilitarla:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Para cargar las finalizaciones de cada sesión, ejecuta lo siguiente una vez:
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
Debes iniciar un shell nuevo para que esta configuración surta efecto.
Peces
Para cargar las autocompletaciones en la sesión de shell actual, haz lo siguiente:
gdcloud completion fish | source
Para cargar las finalizaciones de cada sesión, ejecuta lo siguiente:
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
Debes iniciar un shell nuevo para que esta configuración surta efecto.
Usar la función de autocompletar
Para usar la función de autocompletado de la CLI de gdcloud, escribe los primeros caracteres del comando que quieras usar y, a continuación, pulsa la tecla Tabulador. Si solo hay una opción posible, se inserta automáticamente en la línea de comandos. Si el comando no se autocompleta, significa que hay varias opciones posibles y debes volver a pulsar la tecla Tabulador para ver todos los comandos posibles.
Ejemplos de Autocompletar
Escribe un comando parcialmente y, a continuación, pulsa Tabulador para autocompletarlo:
gdcloud con <TAB>
Completar el comando después de pulsar Tab una vez:
gdcloud config
Escribe un comando parcialmente y, a continuación, pulsa Tabulador dos veces para ver una lista de todos los comandos posibles:
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters