Linux |奇怪的知识---complete命令---你不知道的命令参数补全---kubectl命令的参数补全

简介: Linux |奇怪的知识---complete命令---你不知道的命令参数补全---kubectl命令的参数补全

前言:

linux下有非常多的命令,其中有一些命令是比较冷门的,但比较有意思,比如,这个complete命令。

complete命令定义命令或者脚本内的方法的参数自动补全内容是什么(例如,定义某个命令的参数---可以是目录,可以是其它的命令,可以是一个词组,可以是一个脚本内的函数名),这个命令在某些特定的场合是可以提高我们的效率的(请注意关键词,命令和参数)。

命令补全和命令参数补全是两个不同的概念,这里大家一定要先区分清楚。

下面就详细介绍一哈此命令。

一,

命令的补全:

例如,任意的一个shell里面输入 com紧接着【tab】,这个是命令补全,只要命令在系统的shell的环境变量里,就可以补全,无需特别设置。

[root@master3 completions]# com
comm      command   compgen   complete  compopt   

命令的参数自动补全是什么?

我想大家应该都知道,命令可带参数也可以不带参数

例如,ls会打印当前目录下的所有可见内容,此时不需要参数。

ls -al 会打印当前目录下的所有文件和文件夹并包括它们的详细信息,此时,我们就说 -al是ls这个命令的参数,在准确点说 -al 是ls这个命令的短参数,什么叫短参数什么叫长参数就不在这废话了。这样的参数是传统的unix风格参数。

那么,还一种参数,例如 kubectl api-resources,这里,我们就会说 api-resources是kubelet的参数,只是这种参数是伯克利实验室最先使用的一种风格(小趣味知识,很早以前看过相关介绍,好像是这么说的)。

命令的参数自动补全是指的在某一个shell环境下,我们输入一个完整的命令后,空格 【tab】,shell会智能的补全剩下的参数。

例如,网络管理方面的常用命令ip,当我们安装了自动补全管理命令后:

首先输入 ip 空格  addr【tab】,在命令下面会返回给我们可能会出现的addr参数开始的所有参数

[root@master1 completions]# ip addr
address    addrlabel  
[root@master1 completions]# ip addr
address    addrlabel  

ip 空格  m【tab】 ,会列出以m开始的这些可用参数

[root@master1 completions]# ip m
macsec    maddress  monitor   mroute    mrule  

OK,命令的参数补全功能需要安装一个管理命令参数的命令,这里有点绕口,请大家仔细理解。

二,管理命令参数的命令的安装以及kubectl 这个命令的参数补全安装

在linux下安装命令为:

OK,如果你有搭建kubernetes集群,那么,可以通过kubectl命令的帮助查询到如何安装命令参数补全:

k completion --help

关于安装kubectl命令参数补全的帮助 输出如下:

  # Installing bash completion on macOS using homebrew
  ## If running Bash 3.2 included with macOS
  brew install bash-completion
  ## or, if running Bash 4.1+
  brew install bash-completion@2
  ## If kubectl is installed via homebrew, this should start working immediately
  ## If you've installed via other means, you may need add the completion to your completion directory
  kubectl completion bash > $(brew --prefix)/etc/bash_completion.d/kubectl
  # Installing bash completion on Linux
  ## If bash-completion is not installed on Linux, install the 'bash-completion' package
  ## via your distribution's package manager.
  ## Load the kubectl completion code for bash into the current shell
  source <(kubectl completion bash)
  ## Write bash completion code to a file and source it from .bash_profile
  kubectl completion bash > ~/.kube/completion.bash.inc
  printf "
  # Kubectl shell completion
  source '$HOME/.kube/completion.bash.inc'
  " >> $HOME/.bash_profile
  source $HOME/.bash_profile

总结一下,如果是macos系统,安装命令为:

brew install bash-completion

如果此macos的bash版本大于4.1,安装命令为:

brew install bash-completion@2

如果是linux操作系统,如果是最小化安装,此命令是没有默认安装的,需要搭建一个本地yum仓库或者使用网络yum仓库安装,那么,安装命令为:

yum -y install bash-completion

bash-completion安装完成后,需要激活一哈新装的脚本:

source /usr/share/bash-completion/bash_completion
echo "source <(kubectl completion bash)" > ~/.kube/completion.bash.inc
kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
source ~/.kube/completion.bash.inc #当前用户激活kubectl 命令参数补全功能

如果是需要所有用户都可以使用kubectl 的参数补全:

source /usr/share/bash-completion/bash_completion
echo "source <(kubectl completion bash)" >>/etc/profile
echo "source /usr/share/bash-completion/bash_completion" >>/etc/profile
kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null

kubectl 命令的参数补全效果:

kubectl get svc -n 空格【tab】,会列出集群内所有的namespace:

[root@node1 ~]# kubectl get svc -n 
default          kube-node-lease  kube-public      kube-system 

OK,那么,如果想要使用别名kubectl呢?

echo "alias k=kubectl">>/etc/profile
echo "complete -F __start_kubectl k">>/etc/profile
source /etc/profile

测试如下:

k get pod -n 空格【tab】,将会列出所有namespace

[root@master1 completions]# k get pod -n 
default          kube-node-lease  kube-public      kube-system

k get pod -n kube-s【tab】 【tab】,将会列出kube-system这个命名空间下的所有pod

[root@master1 completions]# k get pod -n kube-system 
coredns-7f6cbbb7b8-7c85v         kube-apiserver-master2           kube-controller-manager-master2  kube-flannel-ds-b7zf9            kube-proxy-nkgdf                 kube-proxy-xmrp5                 kube-scheduler-master3
coredns-7f6cbbb7b8-h9wtb         kube-apiserver-master3           kube-controller-manager-master3  kube-flannel-ds-qcq66            kube-proxy-rb9zk                 kube-scheduler-master1           
kube-apiserver-master1           kube-controller-manager-master1  kube-flannel-ds-5jnr7            kube-flannel-ds-ztdk7            kube-proxy-rvbb7                 kube-scheduler-master2   

OK,这些设置将会极大的提高我们管理kubernetes集群的效率,那么,complete -F 这一串是什么情况呢?

其实根本原因在于kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null 此命令在/etc/bash_completion.d目录下生成了一个名称为kubelet的脚本,此脚本内有一个函数,通过complete -F 指定函数的形式激活了kubectl的别名

__start_kubectl()
{
    local cur prev words cword
    declare -A flaghash 2>/dev/null || :
    declare -A aliashash 2>/dev/null || :
    if declare -F _init_completion >/dev/null 2>&1; then
        _init_completion -s || return
    else
        __kubectl_init_completion -n "=" || return
    fi
    local c=0
    local flags=()
    local two_word_flags=()
    local local_nonpersistent_flags=()
    local flags_with_completion=()
    local flags_completion=()
    local commands=("kubectl")
    local must_have_one_flag=()
    local must_have_one_noun=()
    local has_completion_function
    local last_command
    local nouns=()

三,

complete命令设置参数补全

首先,我们看一下没有设置complete参数补全的命令是什么情况,以常用的ls命令为例:

本例中在root家目录下,ls  空格【tab】,此时会自动补全参数的全是当前目录下的文件夹和文件

[root@master1 ~]# pwd
/root
[root@master3 ~]# ls .
./             ../            .ansible/      .bash_history  .bash_logout   .bash_profile  .bashrc        .cshrc         .ssh/          .tcshrc        .viminfo    

complete -p 命令---查询命令的complete参数补全设置

此时的ls命令我们使用complete -p 看看它有没有设置参数补全(提示ls命令没有设置参数补全,只有默认的参数补全---参数是当前目录下的所有文件夹和文件):

[root@master3 ~]# complete -p ls
-bash: complete: ls: no completion specification

 

OK,现在使用complete命令更改ls命令参数只补全目录,不补全文件,可以看到设置后,ls命令的参数只补全文件夹了,root目录下就两个文件夹,并且查询complet 也是 -d ls了:

complete -d 命令---设置命令的参数为 文件夹

[root@master3 ~]# complete -d ls
[root@master3 ~]# ls .
./        ../       .ansible/ .ssh/     
[root@master3 ~]# complete -p ls
complete -d ls

取消complete对ls的参数补全设置:

[root@master3 ~]# complete -r ls
[root@master3 ~]# complete -p ls
-bash: complete: ls: no completion specification

complete -c 命令---设置命令的参数为命令

例如设置ls命令的参数补全为命令:

ls 空格【tab】,此时ls命令的参数补全是所有命令

[root@master3 ~]# complete -c ls
[root@master3 ~]# ls 
Display all 1456 possibilities? (y or n)
:                                         fipscheck                                 _kubectl_drain                            ntptime                                   ssh-add
!                                         fipshmac                                  _kubectl_edit                             numfmt                                    ssh-agent
./                                        firewall-cmd                              _kubectl_exec                             objcopy                                   ssh-copy-id
[                                         firewalld                                 _kubectl_explain                          objdump                                   sshd
。。。。。略略略

complete -W "词组" 命令 ---设置命令的参数为词组

例如,ls命令绑定词组 "start stop" ,ls 空格 【tab】,将会列出词组供选择

[root@master1 ~]# complete -W "start stop" ls
[root@master1 ~]# ls st
start  stop   

当然,对于ls命令这样是没有什么意义的,但脚本也可以利用complete绑定词组,这样会使得脚本更加的人性化,智能化:

例如,nginx.sh 这个脚本,绑定"start stop"作为参数,./nginx.sh 空格【tab】,将会列出词组作为参数供选择

[root@master1 ~]# ls nginx.sh
nginx.sh
[root@master1 ~]# complete -W "start stop " ./nginx.sh
[root@master1 ~]# ./nginx.sh st
start  stop   



命令参数补全主要是三个地方的脚本:

  • 第一个是/usr/share/bash-completion/bash_completion,此脚本极为重要,里面的内容比较多,也比较难懂,有兴趣的朋友可以去看看,此脚本是yum安装bash-completion程序后生成的。
  • 第二个是/usr/share/bash-completion/completions/这个目录下的脚本文件,是一些单独命令的参数设置。

例如look命令的参数设置脚本内容如下 :

cat /usr/share/bash-completion/completions/look

_look_module()
{
        local cur prev OPTS
        COMPREPLY=()
        cur="${COMP_WORDS[COMP_CWORD]}"
        prev="${COMP_WORDS[COMP_CWORD-1]}"
        case $prev in
                '-t'|'--terminate')
                        COMPREPLY=( $(compgen -W "char" -- $cur) )
                        return 0
                        ;;
                '-h'|'--help'|'-V'|'--version')
                        return 0
                        ;;
        esac
        case $cur in
                -*)
                        OPTS="--alternative --alphanum --ignore-case --terminate --version --help"
                        COMPREPLY=( $(compgen -W "${OPTS[*]}" -- $cur) )
                        return 0
                        ;;
        esac
        local IFS=$'\n'
        compopt -o filenames
        COMPREPLY=( $(compgen -f -- $cur) )
        return 0
}
complete -F _look_module look

look --空格【tab】,此时会列出  OPTS="--alternative --alphanum --ignore-case --terminate --version --help" 这些上述脚本定义的参数

root@master1 ~]# look --
--alphanum     --alternative  --help         --ignore-case  --terminate    --version

 

  • 第三个是/etc/bash_completion.d这个目录下的脚本,kubectl这个命令的参数补全脚本就存放在此,此脚本使用的是关键自定义函数:

cat /etc/bash_completion.d/kubectl 最后的一段

__start_kubectl()
{
    local cur prev words cword
    declare -A flaghash 2>/dev/null || :
    declare -A aliashash 2>/dev/null || :
    if declare -F _init_completion >/dev/null 2>&1; then
        _init_completion -s || return
    else
        __kubectl_init_completion -n "=" || return
    fi
    local c=0
    local flags=()
    local two_word_flags=()
    local local_nonpersistent_flags=()
    local flags_with_completion=()
    local flags_completion=()
    local commands=("kubectl")
    local must_have_one_flag=()
    local must_have_one_noun=()
    local has_completion_function
    local last_command
    local nouns=()
    __kubectl_handle_word
}
if [[ $(type -t compopt) = "builtin" ]]; then
    complete -o default -F __start_kubectl kubectl
else
    complete -o default -o nospace -F __start_kubectl kubectl
fi
# ex: ts=4 sw=4 et filetype=sh

那么,如果我们写的有比较复杂的带有很多参数的脚本,也就可以仿照以上的脚本形式写自定义的参数补全脚本,从而方便我们自己使用脚本或者命令。(目前我还写不出来太复杂的脚本,因此,参数补全脚本也就没机会自己定义了)。

命令的参数补全意义是比较重大的,通过命令的参数补全功能我们可以快速的上手命令,并对命令的使用加深记忆,这种情况尤其适用于像kubelet这样的参数非常多的命令

以上就是命令的参数补全基本原理以及一些简单的通过complete命令设定命令的参数补全。

目录
打赏
0
0
0
0
43
分享
相关文章
|
29天前
|
linux命令详细说明以及案例
本文介绍了常用的 Linux 命令及其详细说明和示例,包括:`ls`(列出目录内容)、`cd`(更改目录)、`rm` 和 `mv`(删除与移动文件)、`grep`(搜索文本)、`cat`(显示文件内容)以及 `chmod`(更改文件权限)。每个命令均配有功能描述、选项说明及实际案例,帮助用户更好地掌握 Linux 命令的使用方法。
155 56
Linux系统中的cd命令:目录切换技巧
踏过千山,越过万水,人生就是一场不断前行的旅程,总充满了未知与挑战。然而,“cd”命令如同你的旅伴,会带你穿梭在如棋盘一般的文件系统中,探索每一处未知。希望你能从“cd”命令中找到乐趣,像是掌控了一种络新妙的魔法,去向未知进发,开始你的探索之旅。
92 24
|
7天前
|
Linux命令的基本格式解析
总的来说,Linux命令的基本格式就像一个食谱,它可以指导你如何使用你的计算机。通过学习和实践,你可以成为一个真正的“计算机厨师”,创造出各种“美味”的命令。
46 15
Linux系统之su命令的基本使用
Linux系统之su命令的基本使用
68 2
Linux系统之su命令的基本使用
调试技巧 - 用Linux命令排查Java问题
总的来说,使用Linux命令来排查Java问题,需要一定的实践经验和理论知识。然而,只要我们愿意花时间深入了解这些工具,我们就能够熟练地使用它们来分析和解决问题。此外,这些工具只是帮助我们定位问题,真正解决问题需要我们对Java和JVM有深入的理解,并能够读懂和分析代码。
61 13
|
1月前
|
Linux基础:文件和目录类命令分析。
总的来说,这些基础命令,像是Linux中藏匿的小矮人,每一次我们使用他们,他们就把我们的指令准确的传递给Linux,让我们的指令变为现实。所以,现在就开始你的Linux之旅,挥动你的命令之剑,探索这个充满神秘而又奇妙的世界吧!
73 19
|
1月前
|
Linux 常用文件查看命令
`cat` 命令用于连接文件并打印到标准输出,适用于快速查看和合并文本文件内容。常用示例包括:`cat file1.txt` 查看单个文件,`cat file1.txt file2.txt` 合并多个文件,`cat &gt; filename` 创建新文件,`cat &gt;&gt; filename` 追加内容。`more` 和 `less` 命令用于分页查看文件,`tail` 命令则用于查看文件末尾内容,支持实时追踪日志更新,如 `tail -f file.log`。
71 5
Linux 常用文件查看命令
|
29天前
|
linux常用命令详细说明以及案例
本文介绍了Linux中几个常用的命令及其用法,包括:`ls`(列出目录内容)、`cd`(切换目录)、`mkdir`(创建目录)、`rm -p`(删除目录及内容)和`mv`(移动或重命名文件/目录)。每个命令都配有详细说明、语法格式、常见选项及实用案例,帮助用户更好地理解和使用这些基础命令。内容源自[linux常用命令详细说明以及案例](https://linux.ciilii.com/show/news-285.html)。
|
2月前
|
Linux系统之whereis命令的基本使用
Linux系统之whereis命令的基本使用
133 24
Linux系统之whereis命令的基本使用
|
1月前
|
Linux od命令
本文详细介绍了Linux中的 `od`命令,包括其基本语法、常用选项和示例。通过这些内容,你可以灵活地使用 `od`命令查看文件内容,提高分析和调试效率。确保理解每一个选项和示例的实现细节,应用到实际工作中时能有效地处理各种文件查看需求。
74 19