ait release — 完整参考

创建并查看发布档案，构建并打包原生产物，发布这些产物，并晋级已接纳的发布。

适用人群： 发布工程师

打开命令手册

作用边界#

用途： 创建并查看发布档案，构建并打包原生产物，发布这些产物，并晋级已接纳的发布。

影响类别： 发布权威与对外发布的入口；build、publish 和 promote 操作可能产生外部影响。

覆盖： ait release 下共 12 个公开 help surface。

下面的代码块原样保留 1.1.1 二进制的输出，包含它给出的每一个参数、选项、默认值、可选值、冲突关系和必填要求。

完整命令树#

代码 · text

ait release
ait release candidate
ait release candidate create
ait release check
ait release build
ait release native-source
ait release native-bundle
ait release package
ait release formula
ait release show
ait release publish
ait release promote

原样输出的 help#

`ait release`#

二进制描述： Build, inspect, and publish versioned release artifacts.

代码 · text

Build, inspect, and publish versioned release artifacts.

Usage: ait release <COMMAND>

Commands:
  candidate      
  check          
  build          
  native-source  
  native-bundle  
  package        
  formula        
  show           
  publish        
  promote        
  help           Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

说明

构建、查看并发布带版本的 release 产物。

参数 / 选项	说明
`help`	打印本消息或给定子命令的帮助
`-h, --help`	打印帮助

`ait release candidate`#

参考描述： 汇总创建 release candidate 权威记录的那些操作。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release candidate <COMMAND>

Commands:
  create  
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

说明

参数 / 选项	说明
`help`	打印本消息或给定子命令的帮助
`-h, --help`	打印帮助

`ait release candidate create`#

参考描述： 为确切的版本、Line、profile 和发布通道创建一个 release candidate。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release candidate create [OPTIONS] --version <VERSION>

Options:
      --version <VERSION>  
      --line <LINE_NAME>   [default: main]
      --profile <PROFILE>  
      --channel <CHANNEL>  [possible values: rc, stable]
      --json               
  -h, --help               Print help

说明

参数 / 选项	说明
`--line <LINE_NAME>`	[default: main]
`--channel <CHANNEL>`	[possible values: rc, stable]
`-h, --help`	打印帮助

`ait release check`#

参考描述： 校验发布档案、它的组件回执和产物字节，以及所声明的测试证据。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release check [OPTIONS] <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --receipts <DIR>
          Verify family component receipts and artifact bytes below DIR
      --tests-command <TESTS_COMMAND>
          
      --skip-tests-reason <SKIP_TESTS_REASON>
          
      --json
          
  -h, --help
          Print help

`ait release build`#

参考描述： 根据组件回执或确切的原生目标矩阵，为一次发布冻结已接纳的同族产物。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release build [OPTIONS] <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --receipts <DIR>            Freeze family artifacts verified from component receipts below DIR
      --native-matrix-dir <DIR>   Read target artifacts from DIR/<rust-target-triple>/release using ait-native-source.json descriptors.
      --native-command-dir <DIR>  Read current-host release command artifacts from this explicit directory.
      --json                      
  -h, --help                      Print help

说明

参数 / 选项	说明
`--receipts <DIR>`	冻结通过 DIR 下组件回执验证的 family 产物
`--native-matrix-dir <DIR>`	使用 ait-native-source.json 描述符，从 DIR/<rust-target-triple>/release 读取目标工件。
`--native-command-dir <DIR>`	从此显式指定的目录读取当前主机的发布命令工件。
`-h, --help`	打印帮助

`ait release native-source`#

参考描述： 为一个原生发布目标记录确切的源、runner、镜像、Rust 工具链和编译器输入。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release native-source [OPTIONS] --target <TARGET> --source-dir <DIR> --runner <RUNNER> --runner-image <RUNNER_IMAGE> --rust-toolchain <RUST_TOOLCHAIN> --rustc-path <PATH> <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --target <TARGET>                  
      --source-dir <DIR>                 
      --runner <RUNNER>                  
      --runner-image <RUNNER_IMAGE>      
      --rust-toolchain <RUST_TOOLCHAIN>  
      --rustc-path <PATH>                
      --json                             
  -h, --help                             Print help

说明

参数 / 选项	说明
`-h, --help`	打印帮助

`ait release native-bundle`#

参考描述： 只从带有所需源描述文件的目标目录构建原生发布包。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release native-bundle [OPTIONS] --native-matrix-dir <DIR> <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --native-matrix-dir <DIR>  Build native bundles only from DIR/<rust-target-triple>/release using ait-native-source.json descriptors.
      --json                     
  -h, --help                     Print help

说明

参数 / 选项	说明
`--native-matrix-dir <DIR>`	使用 ait-native-source.json 描述符，仅从 DIR/<rust-target-triple>/release 构建原生 bundle。
`-h, --help`	打印帮助

`ait release package`#

参考描述： 为已接纳的发布创建针对特定发布通道的打包产物。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release package [OPTIONS] --channel <CHANNEL> <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --channel <CHANNEL>  Assemble one declared channel from an immutable frozen family build [possible values: homebrew, apt, winget, pypi, npm]
      --json               
  -h, --help               Print help

说明

参数 / 选项	说明
`--channel <CHANNEL>`	从一个不可变的已冻结 family 构建组装一个已声明的渠道 [possible values: homebrew, apt, winget, pypi, npm]
`-h, --help`	打印帮助

`ait release formula`#

参考描述： 从已接纳的发布生成一份具名的打包 formula。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release formula [OPTIONS] --name <NAME> <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --name <NAME>
          
      --python-formula <PYTHON_FORMULA>
          Homebrew Python dependency formula written into the generated formula. [default: python@3]
      --json
          
  -h, --help
          Print help

`ait release show`#

参考描述： 查看发布档案及其记录的接纳状态。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release show [OPTIONS] <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --remote <REMOTE>  
      --json             
  -h, --help             Print help

说明

参数 / 选项	说明
`-h, --help`	打印帮助

`ait release publish`#

参考描述： 通过配置好的发布边界，发布选定的已接纳发布产物。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release publish [OPTIONS] <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --remote <REMOTE>  
      --json             
  -h, --help             Print help

说明

参数 / 选项	说明
`-h, --help`	打印帮助

`ait release promote`#

参考描述： 把已接纳的发布晋级到选定的发布通道。

1.1.1 二进制没有为这个 surface 单独给出描述，上面那句是文档补充的说明。下面是解析器提供的完整用法和选项，未作改动。

代码 · text

Usage: ait release promote [OPTIONS] --channel <CHANNEL> <RELEASE_ID>

Arguments:
  <RELEASE_ID>  

Options:
      --channel <CHANNEL>  [possible values: rc, stable]
      --json               
  -h, --help               Print help

说明

参数 / 选项	说明
`--channel <CHANNEL>`	[possible values: rc, stable]
`-h, --help`	打印帮助

版本权威

对照 1.1.1 源码逐条核对

这一页是公开文档，不是第二份产品契约。要确认发布权威，请以确切的源码和分发契约为准。

打开 1.1.1 Release ↗分发契约 ↗CLI 源码 ↗

所属组件 Snapshot

ait-coreSNP-ED7593DBF982
ait-serverSNP-0CCD7DD2A077
ait-runnerSNP-35C9C133D2EE
ait-pythonSNP-756C731A4CC0
ait-nodeSNP-55E90D0A81F1

作用边界#

完整命令树#

原样输出的 help#

ait release#

ait release candidate#

ait release candidate create#

ait release check#

ait release build#

ait release native-source#

ait release native-bundle#

ait release package#

ait release formula#

ait release show#

ait release publish#

ait release promote#

对照 1.1.1 源码逐条核对

`ait release`#

`ait release candidate`#

`ait release candidate create`#

`ait release check`#

`ait release build`#

`ait release native-source`#

`ait release native-bundle`#

`ait release package`#

`ait release formula`#

`ait release show`#

`ait release publish`#

`ait release promote`#