En esta página se proporcionan instrucciones para configurar y usar la función de autocompletado de la CLI gdcloud, que permite usar la tecla Tab para completar un comando introducido parcialmente. Esta función está disponible en los shells Bash, Zsh y Fish. El autocompletado de la CLI de gdcloud es una función que ofrece sugerencias de comandos y opciones a medida que escribes. Puede ser útil cuando no sabes qué comando usar o cuando quieres usar un comando que no has usado antes.
Activar el autocompletado
Para activar la función de autocompletado, debes ejecutar un comando en tu terminal. La función de autocompletado de la CLI gdcloud está disponible en el sistema operativo Linux en los shells Bash, Zsh y Fish. Usa el siguiente comando para averiguar qué shell utilizas.
echo $SHELL
La salida tiene el siguiente aspecto: 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 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. 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 finalización de shell no está habilitada. Puedes comprobar este valor ejecutando 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, prueba a escribir el siguiente comando y a pulsar Tab. Si la finalización de shell está habilitada, deberías ver una lista de las posibles finalizaciones del comando ls.
ls
Comprueba la salida del comando compgen -c. Si la salida del comando compgen -c no contiene ningún comando, significa que la finalización de shell no está habilitada. Puedes ejecutar el siguiente comando para ver la salida del comando compgen -c. Si la finalización de shell está habilitada, la salida del comando debería 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 la sesión de shell actual, haz lo siguiente:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Para cargar las finalizaciones en cada sesión, ejecuta el siguiente comando una vez:
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
Debes iniciar un shell nuevo para que esta configuración surta efecto.
Fish
Para cargar las finalizaciones en la sesión de shell actual, haz lo siguiente:
gdcloud completion fish | source
Para cargar las finalizaciones en cada sesión, ejecuta el siguiente comando:
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
Debes iniciar un shell nuevo para que esta configuración surta efecto.
Usar el autocompletado
Para usar el autocompletado de la CLI gdcloud, escribe los primeros caracteres del comando que quieras usar y, a continuación, pulsa 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 rellena automáticamente, significa que hay varias finalizaciones posibles y debes pulsar la tecla Tab de nuevo para ver todos los comandos posibles.
Ejemplos de autocompletado
Escribe un comando parcialmente y, a continuación, pulsa Tab para autocompletarlo:
gdcloud con <TAB>
Comando completo después de pulsar Tab una vez:
gdcloud config
Escribe un comando parcialmente y, a continuación, pulsa Tab dos veces para ver una lista de todos los comandos posibles:
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters