本頁面提供相關操作說明,協助您設定及使用 gdcloud CLI 自動完成功能,只要按下 Tab 鍵,即可完成部分輸入的指令。這項功能適用於 Bash、Zsh 和 Fish 殼層。 gdcloud CLI 自動完成功能會在您輸入指令和選項時提供建議。如果您不確定要使用哪個指令,或是想使用從未用過的指令,這項功能就非常實用。
啟用自動完成功能
如要啟用自動完成功能,請在終端機中執行指令。gdcloud CLI 自動完成功能適用於 Linux 作業系統的 Bash、Zsh 和 Fish 殼層。使用下列指令找出您使用的殼層。
echo $SHELL
輸出內容看起來會像 bin/$SHELL,其中 $SHELL 是 bash、zsh 或 fish。
Bash
如要在目前的 Shell 工作階段中載入自動完成功能:
source <(gdcloud completion bash)
如要為每個新工作階段載入完成項目,請執行一次:
gdcloud completion bash > /etc/bash_completion.d/gdcloud
Zsh
如果環境中尚未啟用 Shell 自動完成功能,請務必啟用。檢查是否已啟用 Shell 完成功能。
檢查 COMP_LINE 變數的值。如果 COMP_LINE 變數的值為空白,則不會啟用殼層完成功能。您可以執行下列指令來檢查這個值:
echo $COMP_LINE
嘗試使用指令完成功能。如果您嘗試使用指令的殼層完成功能,但無法運作,表示殼層完成功能未啟用。舉例來說,請嘗試輸入下列指令,然後按下 Tab 鍵。如果已啟用 Shell 完成功能,您應該會看到 ls 指令的可能完成清單。
ls
檢查 compgen -c 指令的輸出內容。如果 compgen -c 指令的輸出內容不含任何指令,表示未啟用 Shell 完成功能。您可以執行下列指令,查看 compgen -c 指令的輸出內容。如果已啟用 Shell 補完功能,指令輸出內容應會列出具有補完功能的指令。
compgen -c
如果不確定環境是否已啟用 Shell 自動完成功能,請參閱 Shell 的說明文件。 如果環境未啟用殼層完成功能,請執行下列指令來啟用:
echo "autoload -U compinit; compinit" >> ~/.zshrc
如要在目前的 Shell 工作階段中載入自動完成功能:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
如要載入每個工作階段的完成事項,請執行一次:
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
您必須啟動新的殼層,這項設定才會生效。
魚
如要在目前的 Shell 工作階段中載入自動完成功能:
gdcloud completion fish | source
如要載入每個工作階段的完成項目,請執行下列指令:
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
您必須啟動新的殼層,這項設定才會生效。
使用自動完成功能
如要使用 gdcloud CLI 自動完成功能,請輸入要使用的指令前幾個字元,然後按下 Tab 鍵。如果只有一個可能的完成項目,系統會自動插入指令列。如果指令未自動填入,表示有多個可能的完成項目,您必須再次按下 Tab 鍵,才能查看所有可能的指令。
自動完成範例
輸入部分指令,然後按下 Tab 鍵,即可自動完成指令:
gdcloud con <TAB>
按下 Tab 鍵一次後完成的指令:
gdcloud config
輸入部分指令,然後按兩次 Tab 鍵,即可查看所有可能的指令:
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters