Share via

az aksarc release

  • Preview

Note

This reference is part of the aksarc extension for the Azure CLI (version 2.32.0 or higher). The extension will automatically install the first time you run an az aksarc release command. Learn more about extensions.

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage VHD images for provisioned clusters.

Commands

Name Description Type Status
az aksarc release download

Downloads the VHD images from a release.

 Extension Preview
az aksarc release save

Provisions the downloaded VHD images to the arc resource bridge.

 Extension Preview

az aksarc release download

Preview

Command group 'aksarc release' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Downloads the VHD images from a release.

az aksarc release download --staging-folder
                           [--audience]
                           [--catalog]
                           [--extract-release]
                           [--mode {full, minimum}]
                           [--version]

Examples

DownloadLatestRelease

az aksarc release download --staging-folder ./aksarc-release

Required Parameters

--staging-folder

Local directory path to store release files.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--audience

Release catalog audience. Default value is stable.

Property Value
Default value: stable
--catalog

Release catalog name. Default value is aks-hybrid-stable-catalogs-ext.

Property Value
Default value: aks-hybrid-stable-catalogs-ext
--extract-release

Extracts the OS image release files after download, for backward compatibility with older versions. Note: This feature will be deprecated in the future.

--mode

Minimum(default) downloads only Linux images. Full option downloads windows images also.

Property Value
Default value: minimum
Accepted values: full, minimum
--version

Release version to be downloaded. If not specified, it defaults to latest release.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az aksarc release save

Preview

Command group 'aksarc release' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Provisions the downloaded VHD images to the arc resource bridge.

az aksarc release save --staging-folder
                       [--config-file]

Examples

SaveRelease

az aksarc release save --config-file ./work/resourceName-appliance.yaml --staging-folder ./aksarc-release

Required Parameters

--staging-folder

Directory path to import release files.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--config-file

Path to the Arc resource bridge appliance config file, resourceName-appliance.yaml. On Azure Local devices, this can be found running Get-ArcHciConfig command in Powershell.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False