AI 助理
文档备案控制台
开发者社区 云原生 文章 正文

笔记：Docker命令自动补全

2019-09-04 22896
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 笔记：Docker命令自动补全一 背景作为一名 Linux 重度用户，每次敲命令总会情不自禁地按下 Tab 键。在键入 Docker 命令时也会出现类似的习惯性动作。那么是否 Docker 相关命令也能自动补全呢？二 操作步骤2.1 安装 bash-completionsudo yum install -y bash-completion安装完成之后重启系统或者重新登录 shell。

笔记：Docker命令自动补全

一 背景

作为一名 Linux 重度用户，每次敲命令总会情不自禁地按下 Tab 键。在键入 Docker 命令时也会出现类似的习惯性动作。那么是否 Docker 相关命令也能自动补全呢？

二 操作步骤

2.1 安装 bash-completion

sudo yum install -y bash-completion

安装完成之后重启系统或者重新登录 shell。如果安装成功。键入 docker p 后，再 Tab 键，系统显示如下：

pause   plugin  port    ps      pull    push

此时，我们运行例如 docker run 之类的命令，键入镜像的首字母，镜像名称依然无法自动补全。

2.2 根据 Docker 官方文档进一步配置

sudo curl -L https://raw.githubusercontent.com/docker/compose/1.24.1/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
source /etc/bash_completion.d/docker-compose

/etc/bash_completion.d/docker-compose内容如下：

#!/bin/bash
#
# bash completion for docker-compose
#
# This work is based on the completion for the docker command.
#
# This script provides completion of:
#  - commands and their options
#  - service names
#  - filepaths
#
# To enable the completions either:
#  - place this file in /etc/bash_completion.d
#  or
#  - copy this file to e.g. ~/.docker-compose-completion.sh and add the line
#    below to your .bashrc after bash completion features are loaded
#    . ~/.docker-compose-completion.sh

__docker_compose_previous_extglob_setting=$(shopt -p extglob)
shopt -s extglob

__docker_compose_q() {
        docker-compose 2>/dev/null "${top_level_options[@]}" "$@"
}

# Transforms a multiline list of strings into a single line string
# with the words separated by "|".
__docker_compose_to_alternatives() {
        local parts=( $1 )
        local IFS='|'
        echo "${parts[*]}"
}

# Transforms a multiline list of options into an extglob pattern
# suitable for use in case statements.
__docker_compose_to_extglob() {
        local extglob=$( __docker_compose_to_alternatives "$1" )
        echo "@($extglob)"
}

# Determines whether the option passed as the first argument exist on
# the commandline. The option may be a pattern, e.g. `--force|-f`.
__docker_compose_has_option() {
        local pattern="$1"
        for (( i=2; i < $cword; ++i)); do
                if [[ ${words[$i]} =~ ^($pattern)$ ]] ; then
                        return 0
                fi
        done
        return 1
}

# Returns `key` if we are currently completing the value of a map option (`key=value`)
# which matches the extglob passed in as an argument.
# This function is needed for key-specific completions.
__docker_compose_map_key_of_current_option() {
        local glob="$1"

        local key glob_pos
        if [ "$cur" = "=" ] ; then        # key= case
                key="$prev"
                glob_pos=$((cword - 2))
        elif [[ $cur == *=* ]] ; then     # key=value case (OSX)
                key=${cur%=*}
                glob_pos=$((cword - 1))
        elif [ "$prev" = "=" ] ; then
                key=${words[$cword - 2]}  # key=value case
                glob_pos=$((cword - 3))
        else
                return
        fi

        [ "${words[$glob_pos]}" = "=" ] && ((glob_pos--))  # --option=key=value syntax

        [[ ${words[$glob_pos]} == @($glob) ]] && echo "$key"
}

# suppress trailing whitespace
__docker_compose_nospace() {
        # compopt is not available in ancient bash versions
        type compopt &>/dev/null && compopt -o nospace
}


# Outputs a list of all defined services, regardless of their running state.
# Arguments for `docker-compose ps` may be passed in order to filter the service list,
# e.g. `status=running`.
__docker_compose_services() {
        __docker_compose_q ps --services "$@"
}

# Applies completion of services based on the current value of `$cur`.
# Arguments for `docker-compose ps` may be passed in order to filter the service list,
# see `__docker_compose_services`.
__docker_compose_complete_services() {
        COMPREPLY=( $(compgen -W "$(__docker_compose_services "$@")" -- "$cur") )
}

# The services for which at least one running container exists
__docker_compose_complete_running_services() {
        local names=$(__docker_compose_services --filter status=running)
        COMPREPLY=( $(compgen -W "$names" -- "$cur") )
}


_docker_compose_build() {
        case "$prev" in
                --build-arg)
                        COMPREPLY=( $( compgen -e -- "$cur" ) )
                        __docker_compose_nospace
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--build-arg --compress --force-rm --help --memory --no-cache --pull --parallel" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services --filter source=build
                        ;;
        esac
}


_docker_compose_bundle() {
        case "$prev" in
                --output|-o)
                        _filedir
                        return
                        ;;
        esac

        COMPREPLY=( $( compgen -W "--push-images --help --output -o" -- "$cur" ) )
}


_docker_compose_config() {
        case "$prev" in
                --hash)
                        if [[ $cur == \\* ]] ; then
                                COMPREPLY=( '\*' )
                        else
                                COMPREPLY=( $(compgen -W "$(__docker_compose_services) \\\* " -- "$cur") )
                        fi
                        return
                        ;;
        esac

        COMPREPLY=( $( compgen -W "--hash --help --quiet -q --resolve-image-digests --services --volumes" -- "$cur" ) )
}


_docker_compose_create() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--build --force-recreate --help --no-build --no-recreate" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_docker_compose() {
        case "$prev" in
                --tlscacert|--tlscert|--tlskey)
                        _filedir
                        return
                        ;;
                --file|-f)
                        _filedir "y?(a)ml"
                        return
                        ;;
                --log-level)
                        COMPREPLY=( $( compgen -W "debug info warning error critical" -- "$cur" ) )
                        return
                        ;;
                --project-directory)
                        _filedir -d
                        return
                        ;;
                $(__docker_compose_to_extglob "$daemon_options_with_args") )
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "$daemon_boolean_options $daemon_options_with_args $top_level_options_with_args --help -h --no-ansi --verbose --version -v" -- "$cur" ) )
                        ;;
                *)
                        COMPREPLY=( $( compgen -W "${commands[*]}" -- "$cur" ) )
                        ;;
        esac
}


_docker_compose_down() {
        case "$prev" in
                --rmi)
                        COMPREPLY=( $( compgen -W "all local" -- "$cur" ) )
                        return
                        ;;
                --timeout|-t)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --rmi --timeout -t --volumes -v --remove-orphans" -- "$cur" ) )
                        ;;
        esac
}


_docker_compose_events() {
        case "$prev" in
                --json)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --json" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_exec() {
        case "$prev" in
                --index|--user|-u|--workdir|-w)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "-d --detach --help --index --privileged -T --user -u --workdir -w" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_help() {
        COMPREPLY=( $( compgen -W "${commands[*]}" -- "$cur" ) )
}

_docker_compose_images() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --quiet -q" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}

_docker_compose_kill() {
        case "$prev" in
                -s)
                        COMPREPLY=( $( compgen -W "SIGHUP SIGINT SIGKILL SIGUSR1 SIGUSR2" -- "$(echo $cur | tr '[:lower:]' '[:upper:]')" ) )
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help -s" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_logs() {
        case "$prev" in
                --tail)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--follow -f --help --no-color --tail --timestamps -t" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_pause() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_port() {
        case "$prev" in
                --protocol)
                        COMPREPLY=( $( compgen -W "tcp udp" -- "$cur" ) )
                        return;
                        ;;
                --index)
                        return;
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --index --protocol" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_ps() {
        local key=$(__docker_compose_map_key_of_current_option '--filter')
        case "$key" in
                source)
                        COMPREPLY=( $( compgen -W "build image" -- "${cur##*=}" ) )
                        return
                        ;;
                status)
                        COMPREPLY=( $( compgen -W "paused restarting running stopped" -- "${cur##*=}" ) )
                        return
                        ;;
        esac

        case "$prev" in
                --filter)
                        COMPREPLY=( $( compgen -W "source status" -S "=" -- "$cur" ) )
                        __docker_compose_nospace
                        return;
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--all -a --filter --help --quiet -q --services" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_pull() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --ignore-pull-failures --include-deps --no-parallel --quiet -q" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services --filter source=image
                        ;;
        esac
}


_docker_compose_push() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --ignore-push-failures" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_restart() {
        case "$prev" in
                --timeout|-t)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --timeout -t" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_rm() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--force -f --help --stop -s -v" -- "$cur" ) )
                        ;;
                *)
                        if __docker_compose_has_option "--stop|-s" ; then
                                __docker_compose_complete_services
                        else
                                __docker_compose_complete_services --filter status=stopped
                        fi
                        ;;
        esac
}


_docker_compose_run() {
        case "$prev" in
                -e)
                        COMPREPLY=( $( compgen -e -- "$cur" ) )
                        __docker_compose_nospace
                        return
                        ;;
                --entrypoint|--label|-l|--name|--user|-u|--volume|-v|--workdir|-w)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--detach -d --entrypoint -e --help --label -l --name --no-deps --publish -p --rm --service-ports -T --use-aliases --user -u --volume -v --workdir -w" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_scale() {
        case "$prev" in
                =)
                        COMPREPLY=("$cur")
                        return
                        ;;
                --timeout|-t)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --timeout -t" -- "$cur" ) )
                        ;;
                *)
                        COMPREPLY=( $(compgen -S "=" -W "$(__docker_compose_services)" -- "$cur") )
                        __docker_compose_nospace
                        ;;
        esac
}


_docker_compose_start() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services --filter status=stopped
                        ;;
        esac
}


_docker_compose_stop() {
        case "$prev" in
                --timeout|-t)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help --timeout -t" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_top() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_running_services
                        ;;
        esac
}


_docker_compose_unpause() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--help" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services --filter status=paused
                        ;;
        esac
}


_docker_compose_up() {
        case "$prev" in
                =)
                        COMPREPLY=("$cur")
                        return
                        ;;
                --exit-code-from)
                        __docker_compose_complete_services
                        return
                        ;;
                --scale)
                        COMPREPLY=( $(compgen -S "=" -W "$(__docker_compose_services)" -- "$cur") )
                        __docker_compose_nospace
                        return
                        ;;
                --timeout|-t)
                        return
                        ;;
        esac

        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--abort-on-container-exit --always-recreate-deps --build -d --detach --exit-code-from --force-recreate --help --no-build --no-color --no-deps --no-recreate --no-start --renew-anon-volumes -V --remove-orphans --scale --timeout -t" -- "$cur" ) )
                        ;;
                *)
                        __docker_compose_complete_services
                        ;;
        esac
}


_docker_compose_version() {
        case "$cur" in
                -*)
                        COMPREPLY=( $( compgen -W "--short" -- "$cur" ) )
                        ;;
        esac
}


_docker_compose() {
        local previous_extglob_setting=$(shopt -p extglob)
        shopt -s extglob

        local commands=(
                build
                bundle
                config
                create
                down
                events
                exec
                help
                images
                kill
                logs
                pause
                port
                ps
                pull
                push
                restart
                rm
                run
                scale
                start
                stop
                top
                unpause
                up
                version
        )

        # Options for the docker daemon that have to be passed to secondary calls to
        # docker-compose executed by this script.
        local daemon_boolean_options="
                --skip-hostname-check
                --tls
                --tlsverify
        "
        local daemon_options_with_args="
                --file -f
                --host -H
                --project-directory
                --project-name -p
                --tlscacert
                --tlscert
                --tlskey
        "

        # These options are require special treatment when searching the command.
        local top_level_options_with_args="
                --log-level
        "

        COMPREPLY=()
        local cur prev words cword
        _get_comp_words_by_ref -n : cur prev words cword

        # search subcommand and invoke its handler.
        # special treatment of some top-level options
        local command='docker_compose'
        local top_level_options=()
        local counter=1

        while [ $counter -lt $cword ]; do
                case "${words[$counter]}" in
                        $(__docker_compose_to_extglob "$daemon_boolean_options") )
                                local opt=${words[counter]}
                                top_level_options+=($opt)
                                ;;
                        $(__docker_compose_to_extglob "$daemon_options_with_args") )
                                local opt=${words[counter]}
                                local arg=${words[++counter]}
                                top_level_options+=($opt $arg)
                                ;;
                        $(__docker_compose_to_extglob "$top_level_options_with_args") )
                                (( counter++ ))
                                ;;
                        -*)
                                ;;
                        *)
                                command="${words[$counter]}"
                                break
                                ;;
                esac
                (( counter++ ))
        done

        local completions_func=_docker_compose_${command//-/_}
        declare -F $completions_func >/dev/null && $completions_func

        eval "$previous_extglob_setting"
        return 0
}

eval "$__docker_compose_previous_extglob_setting"
unset __docker_compose_previous_extglob_setting

complete -F _docker_compose docker-compose docker-compose.exe

至此，所有补全功能相关的准备工作完成！执行 docker run 类似的命令时，镜像名称及 tag 均能自动补全了。

文章标签：
容器
Docker
Shell
晨曦蜗牛
目录
相关文章
凉凉心.
|
10月前
|
存储 Java Linux
【Docker】（2）还在浏览网页寻找Docker命令？本文全面列举与使用Docker里的各个命令！想要什么命令直接从本文拿！
docker有着比VM更少的抽象层 由于Docker不需要Hypervisor实现硬件资源虚拟化，运行在Docker容器上的程序直接使用的都是实际物理机的硬件资源 因此在CPU、内存利用率上Docker将会在效率上有明显优势 docker利用的时宿主机的内核，而不需要加载操作系统OS内核 当新建一个容器时，Docker不需要和虚拟机一样重新加载一个操作系统内核 进而避免引寻、加载操作系统内核返回等比较费时费资源的过程，当新建一个虚拟机时，虚拟机软件需要加载OS，返回新建过程时分钟级别的。 而Docker由于直接利用宿主机的操作系统，则省略了返回过程，因此新建一个Docker容器只需
凉凉心.
926 124
蓝易云
|
安全 Unix Linux
Docker中授权普通用户使用docker命令以及解决无权限访问/var/run/docker.sock错误。
通过上述步骤，可以有效解决普通用户无法使用Docker命令的问题，同时处理 `/var/run/docker.sock`权限错误。这样的设置不仅方便用户使用Docker提供的各项服务，同时还能保护系统的安全性。在进行此类配置更改时，请确保理解每一步骤的作用及潜在的安全风险，尤其是在修改文件权限时。在实际的操作中，始终应该努力保持系统的最低必要权限，避免过度放宽权限，这是保障系统安全的一个重要方针。
蓝易云
4007 75
游客beejssedmb2sq
|
Docker 容器
Docker run命令-p参数详解
本文介绍Docker端口映射的基础用法。通过`docker run -p &lt;宿主机端口&gt;:&lt;容器端口&gt;`实现端口映射，例如`-p 5000:80`将宿主机5000端口映射到容器80端口，外部访问宿主机5000端口时流量会转发至容器内部的80端口。示例命令中，`-d`用于后台运行，`--restart=always`确保容器自动重启，`--name`指定容器名称。部署完成后可通过`http://服务器IP地址:5000`验证服务是否正常运行。
游客beejssedmb2sq
1519 57
凤中枫
|
网络协议 Ubuntu Docker
Docker Compose--命令说明
Docker Compose--命令说明
凤中枫
2393 30
蓝易云
|
Ubuntu Linux 开发者
常用的Docker命令：docker_cmd_sheet
以上就是一些常用的Docker命令，希望能帮助你更好地驾驭这个强大的工具。记住，Docker就像是一个魔法咒语，只有真正理解和熟练使用，才能发挥出它的最大魔力。
蓝易云
288 22
蓝易云
|
Docker 容器
熟悉Docker容器管理命令：start、stop与restart详细使用指南
掌握这些Docker容器管理命令对于维护应用程序的正常运行至关重要。在实际操作中，应注意容器配置、关联资源以及日志等信息，确保各项操作都能够顺畅并且安全地执行。
蓝易云
3474 0
凤中枫
|
Shell 应用服务中间件 nginx
docker 镜像的部分常用命令
docker镜像常用命令
凤中枫
458 16
凤中枫
|
关系型数据库 MySQL Docker
docker 常用命令大全（基础、镜像、容器、数据卷）
常用docker命令
凤中枫
2082 15
阿里云网友
|
关系型数据库 MySQL 数据库
Docker 安装常用软件相关命令
本文介绍了在CentOS 7.9系统上安装Docker的详细步骤，包括添加阿里云镜像源、安装Docker及相关组件、启动服务以及配置镜像加速。同时，还展示了如何通过Docker安装MySQL 5.7版本数据库，涵盖拉取镜像、创建数据目录、运行容器及配置挂载点等操作，并提供验证安装成功的命令和截图。适合需要部署Docker与MySQL环境的用户参考。
阿里云网友
975 4
monGyrate
|
NoSQL 应用服务中间件 Redis
Docker 常用命令整理
Docker 常用命令整理
monGyrate
496 1

热门文章

最新文章

  • 1
    推荐3款 Docker 认证的实用免费插件，帮助您快速构建云原生应用程序！
  • 2
    【云栖大会】Docker与阿里云达成战略合作 为企业级客户提供容器服务
  • 3
    Docker五分钟搭建Wordpress
  • 4
    Docker with Spring Boot
  • 5
    【Docker系列】Docker-核心概念/常用命令与项目部署实践
  • 6
    这可能是2024年把微服务讲的最全了：SpringBoot+Cloud+Docker
  • 7
    阿里云ECS使用docker搭建mysql服务
  • 8
    docker ＜应用分享＞ 上传镜像到 私有仓库 / 本地仓库，从私库拉取镜像
  • 9
    Docker swarm实现基于Consul和Haproxy的RabbitMQ高可用集群
  • 10
    docker、k8s 面试总结
  • 1
    在虚拟机Docker环境下部署Nginx的步骤。
    476
  • 2
    手把手教你使用 Docker 部署 Nginx 教程
    4270
  • 3
    n8n Docker 部署手册
    3983
  • 4
    【Docker】（3）学习Docker中 镜像与容器数据卷、映射关系！手把手带你安装 MySql主从同步 和 Redis三主三从集群！并且进行主从切换与扩容操作，还有分析 哈希分区 等知识点！
    977
  • 5
    【Docker】（2）还在浏览网页寻找Docker命令？本文全面列举与使用Docker里的各个命令！想要什么命令直接从本文拿！
    936
  • 6
    【Docker】（1）Docker的概述与架构，手把手带你安装Docker，云原生路上不可缺少的一门技术！
    784
  • 7
    【赵渝强老师】Docker容器的资源管理机制
    904
  • 8
    手把手教你用 Docker 部署 Redis
    2939
  • 9
    如何在Kubernetes环境下使用第三方监控系统监控Docker容器性能？
    1139
  • 10
    如何使用第三方监控系统监控Docker容器性能？
    920

    • 相关课程

    更多
  • 深入解析Docker容器化技术
  • 基于Docker与Jenkins实现自动化部署
  • Docker 快速入门
  • Docker完全自学手册图文教程
  • AI开发者的Docker实践
  • Docker 入门

    • 相关电子书

    更多
  • 应用 Docker 进行持续交付：用技术改变交付路程
  • 从Docker到容器服务
  • 构建基因数据应用生态系统—— docker in Bio/informatics

    • 推荐镜像

    更多
  • docker-ce
  • docker-toolbox
    • 下一篇
    一条命令迁移，帮你实现 OpenClaw 与 Hermes Agent 记忆互通！