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`#