En esta página se proporcionan instrucciones para configurar y usar la función de autocompletar de la CLI de gdcloud, que te permite usar la tecla Tabulador para completar un comando que hayas introducido parcialmente. Esta función está disponible para las shells Bash, Zsh y Fish. La función de autocompletar de la CLI gdcloud ofrece sugerencias de comandos y opciones a medida que escribes. Esto puede ser útil si no sabes qué comando usar o si quieres usar un comando que no has 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 gdcloud está disponible para el sistema operativo Linux en las shells Bash, Zsh y Fish. Usa el siguiente comando para averiguar qué shell utilizas.
echo $SHELL
La salida tiene el aspecto de bin/$SHELL, donde $SHELL es bash, zsh o fish.
Bash
Para cargar las finalizaciones en la sesión de shell actual, haz lo siguiente:
source <(gdcloud completion bash)
Para cargar las sugerencias de 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 no está habilitada en tu entorno, debes habilitarla. Comprueba si la finalización de shell está habilitada.
Comprueba el valor de la variable COMP_LINE. Si el valor de la variable COMP_LINE está vacío, significa que la función de autocompletado de shell no está habilitada. Para comprobar este valor, ejecuta el siguiente comando:
echo $COMP_LINE
Prueba a usar la función de autocompletado de shell con un comando. Si intentas usar la función de autocompletar de shell con un comando y no funciona, significa que no está habilitada. Por ejemplo, prueba a escribir el siguiente comando y pulsa Tabulador. Si la función de autocompletar de la shell está habilitada, deberías ver una lista de posibles opciones para completar el comando ls.
ls
Comprueba el resultado del comando compgen -c. Si la salida del comando compgen -c no contiene ningún comando, significa que la función de autocompletar de shell no está habilitada. Puedes ejecutar el siguiente comando para ver el resultado del comando compgen -c. Si la función de autocompletar de shell está habilitada, el resultado del comando debería incluir una lista de comandos que tengan funciones de autocompletar.
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 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 la sesión de shell actual, haz lo siguiente:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Para cargar las sugerencias de cada sesión, ejecuta lo siguiente una vez:
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
Debes iniciar un nuevo shell para que esta configuración se aplique.
Peces
Para cargar las finalizaciones 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 nuevo shell para que esta configuración se aplique.
Usar la función de autocompletar
Para usar la función de autocompletar de la CLI 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 insertará automáticamente en la línea de comandos. Si el comando no se autocompleta, significa que hay varias opciones posibles y que 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>
Comando completo después de pulsar Tabulador 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