尧图网站建设 
oh-my-zsh azure 插件详解az CLI 补全、订阅管理与提示符中的 Azure 状态显示【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzshoh-my-zsh 的 azure 插件围绕 Azure CLIaz提供三类能力加载az命令的补全脚本、提供切换与查看 Azure 订阅的快捷命令azss/azgs/az_subscriptions以及在提示符中通过azure_prompt_info函数显示当前默认订阅。读完本文你可以在~/.zshrc中正确启用该插件、理解其订阅命令的实现细节并将当前 Azure 订阅显示到RPROMPT中同时了解其依赖jq与补全脚本定位的底层机制。插件定位与启用方式azure 插件文档 说明该插件为 Azure CLI 提供补全支持并提供管理 Azure 订阅、在提示符中显示订阅的实用工具。启用方式与其他 oh-my-zsh 插件一致在~/.zshrc的plugins数组中加入azureplugins(... azure)仓库自带的配置模板 templates/zshrc.zsh-template 和精简模板 templates/minimal.zshrc 中plugins数组均默认只含gitplugins(git)启用 azure 插件时需要手动在该数组末尾追加azure。插件全部实现集中在 plugins/azure/azure.plugin.zsh 一个文件中可分为三块订阅管理命令、提示符函数、az 补全脚本加载逻辑。三个核心订阅命令README 的 Plugin commands 一节列出了三个命令下面结合 azure.plugin.zsh 的源码逐一说明其真实行为。az_subscriptions列出可用订阅az_subscriptions用于列出AZURE_CONFIG_DIR默认~/.azure/中可用的订阅同时为azss函数提供补全数据源。源码实现为function az_subscriptions() { az account list --all --output tsv --query [*].name 2 /dev/null }从源码看它实际执行的是az account list --all --output tsv --query [*].name--all会列出所有订阅包括非已登录目录下的--output tsv输出制表符分隔格式--query用 JMESPath 只保留name字段2 /dev/null则静默了 Azure CLI 常见的 stderr 告警。其配套补全函数是function _az_subscriptions() { reply($(az_subscriptions)) } compctl -K _az_subscriptions azsscompctl -K将azss命令的补全回调指向_az_subscriptions每次触发补全时调用az_subscriptions并把订阅名填入reply数组。azgs获取当前订阅azgs读取当前激活的订阅值。文档描述为 gets the current value of$azure_subscription而源码实现是直接调用 Azure CLIfunction azgs() { az account show --output tsv --query name 2/dev/null }即执行az account show并用 JMESPath 查询name字段。注意这一点在插件内部有实际影响azure_prompt_info的注释明确写道 azgs is too expensive, if we have jq, we enable the prompt——因为azgs每次都要启动一次az进程代价较高所以提示符函数没有直接复用它而是改用本地文件解析见下文。azss设置当前订阅azss用于设置$azure_subscription源码中其实是一个别名# AZ Subscription Selection alias azssaz account set --subscription执行azss等价于az account set --subscription由于前面对azss注册了compctl补全输入azss Tab即可从az_subscriptions返回的订阅列表中选取无需手打订阅名。提示符集成azure_prompt_info 与 jq 依赖插件文档 Theme 一节说明azure 插件创建了azure_prompt_info函数供主题在提示符中显示当前订阅其源码位于 azure.plugin.zsh 第 20-26 行# Azure prompt function azure_prompt_info() { [[ ! -f ${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json ]] return # azgs is too expensive, if we have jq, we enable the prompt (( $commands[jq] )) || return 1 azgs$(jq -r .subscriptions[] | select(.isDefaulttrue) .name ${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json) echo ${ZSH_THEME_AZURE_PREFIX:az:}${azgs}${ZSH_THEME_AZURE_SUFFIX:} }从源码可以拆解出它的执行流程与降级条件配置目录探测先检查${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json是否存在不存在则静默返回提示符不显示任何内容。这与 README 中的 NOTE 一致Azure CLI 把当前激活订阅的状态保存在azureProfile.json中因此提示符命令依赖该文件。jq 检查(( $commands[jq] )) || return 1是 oh-my-zsh 判断外部命令是否存在的惯用写法$commands[jq]在jq位于 PATH 中时为 1。如果系统没有安装jq函数返回 1提示符显示为空——README 明确警告 If jq is not in the path the prompt will show nothing。JSON 解析用jq -r .subscriptions[] | select(.isDefaulttrue) .name从azureProfile.json中筛选isDefault true的订阅并取出name完全在本地完成不启动az进程这也是注释中 azgs is too expensive 的原因。前后缀拼接输出格式由两个变量控制使用 zsh 的:赋值展开语法提供默认值ZSH_THEME_AZURE_PREFIX订阅名前的前缀默认az:ZSH_THEME_AZURE_SUFFIX订阅名后的后缀默认。默认输出形如az:my-subscription。需要注意一个文档与源码的差异README 中将后缀变量写作ZSH_THEME_azure_SUFFIXazure 小写而 azure.plugin.zsh 第 25 行 实际读取的是ZSH_THEME_AZURE_SUFFIX全大写 AZURE自定义该变量时应以源码为准。文档给出的接入方式是RPROMPT$(azure_prompt_info)当前仓库的 themes/ 目录下没有任何内置主题直接调用azure_prompt_info检索全部.zsh-theme文件无匹配因此该函数需要用户在自己的主题或~/.zshrc中手动接入。未启用插件时的兜底dummy 实现oh-my-zsh 在 lib/prompt_info_functions.zsh 中为一系列*_prompt_info函数定义了统一的假实现dummy implementationazure_prompt_info在 第 13-26 行 的函数列表中# Dummy implementations that return false to prevent command_not_found # errors with themes, that implement these functions # Real implementations will be used when the respective plugins are loaded function chruby_prompt_info \ ... azure_prompt_info \ ... { return 1 }文件头注释说明了设计意图主题可以直接无条件调用azure_prompt_info即使用户没有启用 azure 插件也不会触发command_not_found错误——dummy 实现只是return 1一旦加载了 azure 插件插件中的真实实现会覆盖这个兜底版本。这是 oh-my-zsh 主题与插件解耦的标准模式git_prompt_info、bzr_prompt_info、nvm_prompt_info等也遵循同样的机制见 lib/git.zsh 等文件。az CLI 补全脚本的加载机制插件的另一半职责是加载 Azure CLI 的补全脚本。azure.plugin.zsh 第 29-60 行 的查找顺序如下从$PATH中查找_az_zsh_completer_path$commands[az_zsh_completer.sh]部分发行版会把az_zsh_completer.sh放进 PATH优先采用它。Homebrew 路径若 PATH 中找不到且检测到 Homebrew 已安装则使用$_brew_prefix/etc/bash_completion.d/az。这里有个性能细节_az-homebrew-installed函数先通过[[ ${commands[brew]:t2} bin/brew ]]判断 brew 是否装在默认位置——是的话直接从brew的完整路径裁剪出前缀_brew_prefix${commands[brew]:h:h}否则才调用一次brew --prefix。源码注释指出 this call to brew is expensive (about 400 ms), so at least lets make it only once即避免每次加载都付出约 400ms 的进程启动开销。Linux 默认路径非 Homebrew 环境回退到/etc/bash_completion.d/azure-cli通过 apt 等包管理器安装的 azure-cli 通常将补全脚本放在这里。最终由这一行完成实际加载[[ -r $_az_zsh_completer_path ]] autoload -U X bashcompinit bashcompinit source $_az_zsh_completer_path即补全脚本文件可读时先通过autoload -U X bashcompinit初始化 bash 补全兼容层Azure CLI 的补全脚本是 bash-completion 格式zsh 需要bashcompinit才能加载它然后source该脚本。加载完成后unset _az_zsh_completer_path _brew_prefix清理临时变量。如果所有候选路径都不存在例如尚未安装 Azure CLI整个条件短路插件静默跳过补全加载而不报错。开发环境搭建文档 Develop 一节给出了在 Ubuntu 上通过 Docker 快速搭建插件开发环境的方法先运行docker run -it -v $(pwd):/mnt -w /mnt ubuntu bash再在容器内依次安装依赖、安装 oh-my-zsh 与 Azure CLIapt install -y curl jq zsh git vim sh -c $(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh) curl -sL https://aka.ms/InstallAzureCLIDeb | bash其中curl jq zsh git vim里的jq正是提示符函数运行所必需的依赖与上文azure_prompt_info的 jq 检查相呼应最后两条命令分别安装 oh-my-zsh 框架本体和 Azure CLI安装后即可在容器内的 zsh 中加载 azure 插件验证补全与订阅命令行为。小结能力入口底层实现订阅补全数据源az_subscriptionsaz account list --all --output tsv --query [*].name获取当前订阅azgsaz account show --output tsv --query name设置当前订阅azss别名az account set --subscription注册了compctl补全提示符显示订阅azure_prompt_info用jq本地解析azureProfile.json前后缀由ZSH_THEME_AZURE_PREFIX/ZSH_THEME_AZURE_SUFFIX控制az 命令补全—按$PATH→ Homebrew →/etc/bash_completion.d/azure-cli顺序定位补全脚本经bashcompinit加载使用 azure 插件有两个硬性前提系统安装azCLI订阅命令与补全都依赖它以及安装jq否则提示符永远为空。配置上只需在plugins数组中加入azure并在提示符中引用azure_prompt_info即可完成接入如需自定义提示符样式修改ZSH_THEME_AZURE_PREFIX与ZSH_THEME_AZURE_SUFFIX即可。【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzsh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 oh-my-zsh azure 插件详解：az CLI 补全、订阅管理与提示符中的 Azure 状态显示
oh-my-zsh azure 插件详解az CLI 补全、订阅管理与提示符中的 Azure 状态显示【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzshoh-my-zsh 的 azure 插件围绕 Azure CLIaz提供三类能力加载az命令的补全脚本、提供切换与查看 Azure 订阅的快捷命令azss/azgs/az_subscriptions以及在提示符中通过azure_prompt_info函数显示当前默认订阅。读完本文你可以在~/.zshrc中正确启用该插件、理解其订阅命令的实现细节并将当前 Azure 订阅显示到RPROMPT中同时了解其依赖jq与补全脚本定位的底层机制。插件定位与启用方式azure 插件文档 说明该插件为 Azure CLI 提供补全支持并提供管理 Azure 订阅、在提示符中显示订阅的实用工具。启用方式与其他 oh-my-zsh 插件一致在~/.zshrc的plugins数组中加入azureplugins(... azure)仓库自带的配置模板 templates/zshrc.zsh-template 和精简模板 templates/minimal.zshrc 中plugins数组均默认只含gitplugins(git)启用 azure 插件时需要手动在该数组末尾追加azure。插件全部实现集中在 plugins/azure/azure.plugin.zsh 一个文件中可分为三块订阅管理命令、提示符函数、az 补全脚本加载逻辑。三个核心订阅命令README 的 Plugin commands 一节列出了三个命令下面结合 azure.plugin.zsh 的源码逐一说明其真实行为。az_subscriptions列出可用订阅az_subscriptions用于列出AZURE_CONFIG_DIR默认~/.azure/中可用的订阅同时为azss函数提供补全数据源。源码实现为function az_subscriptions() { az account list --all --output tsv --query [*].name 2 /dev/null }从源码看它实际执行的是az account list --all --output tsv --query [*].name--all会列出所有订阅包括非已登录目录下的--output tsv输出制表符分隔格式--query用 JMESPath 只保留name字段2 /dev/null则静默了 Azure CLI 常见的 stderr 告警。其配套补全函数是function _az_subscriptions() { reply($(az_subscriptions)) } compctl -K _az_subscriptions azsscompctl -K将azss命令的补全回调指向_az_subscriptions每次触发补全时调用az_subscriptions并把订阅名填入reply数组。azgs获取当前订阅azgs读取当前激活的订阅值。文档描述为 gets the current value of$azure_subscription而源码实现是直接调用 Azure CLIfunction azgs() { az account show --output tsv --query name 2/dev/null }即执行az account show并用 JMESPath 查询name字段。注意这一点在插件内部有实际影响azure_prompt_info的注释明确写道 azgs is too expensive, if we have jq, we enable the prompt——因为azgs每次都要启动一次az进程代价较高所以提示符函数没有直接复用它而是改用本地文件解析见下文。azss设置当前订阅azss用于设置$azure_subscription源码中其实是一个别名# AZ Subscription Selection alias azssaz account set --subscription执行azss等价于az account set --subscription由于前面对azss注册了compctl补全输入azss Tab即可从az_subscriptions返回的订阅列表中选取无需手打订阅名。提示符集成azure_prompt_info 与 jq 依赖插件文档 Theme 一节说明azure 插件创建了azure_prompt_info函数供主题在提示符中显示当前订阅其源码位于 azure.plugin.zsh 第 20-26 行# Azure prompt function azure_prompt_info() { [[ ! -f ${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json ]] return # azgs is too expensive, if we have jq, we enable the prompt (( $commands[jq] )) || return 1 azgs$(jq -r .subscriptions[] | select(.isDefaulttrue) .name ${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json) echo ${ZSH_THEME_AZURE_PREFIX:az:}${azgs}${ZSH_THEME_AZURE_SUFFIX:} }从源码可以拆解出它的执行流程与降级条件配置目录探测先检查${AZURE_CONFIG_DIR:-$HOME/.azure}/azureProfile.json是否存在不存在则静默返回提示符不显示任何内容。这与 README 中的 NOTE 一致Azure CLI 把当前激活订阅的状态保存在azureProfile.json中因此提示符命令依赖该文件。jq 检查(( $commands[jq] )) || return 1是 oh-my-zsh 判断外部命令是否存在的惯用写法$commands[jq]在jq位于 PATH 中时为 1。如果系统没有安装jq函数返回 1提示符显示为空——README 明确警告 If jq is not in the path the prompt will show nothing。JSON 解析用jq -r .subscriptions[] | select(.isDefaulttrue) .name从azureProfile.json中筛选isDefault true的订阅并取出name完全在本地完成不启动az进程这也是注释中 azgs is too expensive 的原因。前后缀拼接输出格式由两个变量控制使用 zsh 的:赋值展开语法提供默认值ZSH_THEME_AZURE_PREFIX订阅名前的前缀默认az:ZSH_THEME_AZURE_SUFFIX订阅名后的后缀默认。默认输出形如az:my-subscription。需要注意一个文档与源码的差异README 中将后缀变量写作ZSH_THEME_azure_SUFFIXazure 小写而 azure.plugin.zsh 第 25 行 实际读取的是ZSH_THEME_AZURE_SUFFIX全大写 AZURE自定义该变量时应以源码为准。文档给出的接入方式是RPROMPT$(azure_prompt_info)当前仓库的 themes/ 目录下没有任何内置主题直接调用azure_prompt_info检索全部.zsh-theme文件无匹配因此该函数需要用户在自己的主题或~/.zshrc中手动接入。未启用插件时的兜底dummy 实现oh-my-zsh 在 lib/prompt_info_functions.zsh 中为一系列*_prompt_info函数定义了统一的假实现dummy implementationazure_prompt_info在 第 13-26 行 的函数列表中# Dummy implementations that return false to prevent command_not_found # errors with themes, that implement these functions # Real implementations will be used when the respective plugins are loaded function chruby_prompt_info \ ... azure_prompt_info \ ... { return 1 }文件头注释说明了设计意图主题可以直接无条件调用azure_prompt_info即使用户没有启用 azure 插件也不会触发command_not_found错误——dummy 实现只是return 1一旦加载了 azure 插件插件中的真实实现会覆盖这个兜底版本。这是 oh-my-zsh 主题与插件解耦的标准模式git_prompt_info、bzr_prompt_info、nvm_prompt_info等也遵循同样的机制见 lib/git.zsh 等文件。az CLI 补全脚本的加载机制插件的另一半职责是加载 Azure CLI 的补全脚本。azure.plugin.zsh 第 29-60 行 的查找顺序如下从$PATH中查找_az_zsh_completer_path$commands[az_zsh_completer.sh]部分发行版会把az_zsh_completer.sh放进 PATH优先采用它。Homebrew 路径若 PATH 中找不到且检测到 Homebrew 已安装则使用$_brew_prefix/etc/bash_completion.d/az。这里有个性能细节_az-homebrew-installed函数先通过[[ ${commands[brew]:t2} bin/brew ]]判断 brew 是否装在默认位置——是的话直接从brew的完整路径裁剪出前缀_brew_prefix${commands[brew]:h:h}否则才调用一次brew --prefix。源码注释指出 this call to brew is expensive (about 400 ms), so at least lets make it only once即避免每次加载都付出约 400ms 的进程启动开销。Linux 默认路径非 Homebrew 环境回退到/etc/bash_completion.d/azure-cli通过 apt 等包管理器安装的 azure-cli 通常将补全脚本放在这里。最终由这一行完成实际加载[[ -r $_az_zsh_completer_path ]] autoload -U X bashcompinit bashcompinit source $_az_zsh_completer_path即补全脚本文件可读时先通过autoload -U X bashcompinit初始化 bash 补全兼容层Azure CLI 的补全脚本是 bash-completion 格式zsh 需要bashcompinit才能加载它然后source该脚本。加载完成后unset _az_zsh_completer_path _brew_prefix清理临时变量。如果所有候选路径都不存在例如尚未安装 Azure CLI整个条件短路插件静默跳过补全加载而不报错。开发环境搭建文档 Develop 一节给出了在 Ubuntu 上通过 Docker 快速搭建插件开发环境的方法先运行docker run -it -v $(pwd):/mnt -w /mnt ubuntu bash再在容器内依次安装依赖、安装 oh-my-zsh 与 Azure CLIapt install -y curl jq zsh git vim sh -c $(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh) curl -sL https://aka.ms/InstallAzureCLIDeb | bash其中curl jq zsh git vim里的jq正是提示符函数运行所必需的依赖与上文azure_prompt_info的 jq 检查相呼应最后两条命令分别安装 oh-my-zsh 框架本体和 Azure CLI安装后即可在容器内的 zsh 中加载 azure 插件验证补全与订阅命令行为。小结能力入口底层实现订阅补全数据源az_subscriptionsaz account list --all --output tsv --query [*].name获取当前订阅azgsaz account show --output tsv --query name设置当前订阅azss别名az account set --subscription注册了compctl补全提示符显示订阅azure_prompt_info用jq本地解析azureProfile.json前后缀由ZSH_THEME_AZURE_PREFIX/ZSH_THEME_AZURE_SUFFIX控制az 命令补全—按$PATH→ Homebrew →/etc/bash_completion.d/azure-cli顺序定位补全脚本经bashcompinit加载使用 azure 插件有两个硬性前提系统安装azCLI订阅命令与补全都依赖它以及安装jq否则提示符永远为空。配置上只需在plugins数组中加入azure并在提示符中引用azure_prompt_info即可完成接入如需自定义提示符样式修改ZSH_THEME_AZURE_PREFIX与ZSH_THEME_AZURE_SUFFIX即可。【免费下载链接】ohmyzsh A delightful community-driven (with 2,500 contributors) framework for managing your zsh configuration. Includes 300 optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python, etc), 140 themes to spice up your morning, and an auto-update tool that makes it easy to keep up with the latest updates from the community.项目地址: https://gitcode.com/gh_mirrors/oh/ohmyzsh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考