Skip to content

Add update notifications for daily/continuous builds #6656

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 7 commits into
base: main
Choose a base branch
from
+188 −46
Draft

Add update notifications for daily/continuous builds #6656

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
1f9c90c
Initial plan
Copilot Jan 30, 2026
6deec8c
Add update notifications for daily/continuous builds
Copilot Jan 30, 2026
134636e
Fix formatting in main.go
Copilot Jan 30, 2026
64cbfe7
Address code review feedback - fix cache file naming and improve comm…
Copilot Jan 30, 2026
29af9ea
Add documentation for enabling daily build update notifications
Copilot Jan 30, 2026
657baa3
Add global config support for update channel and improve documentation
Copilot Jan 30, 2026
8ae518c
Fix update notifications for daily channel users
Copilot Feb 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions cli/azd/docs/environment-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ Environment variables that can be used to configure `azd` behavior, usually set
- `AZD_FORCE_TTY`: If true, forces `azd` to write terminal-style output.
- `AZD_IN_CLOUDSHELL`: If true, `azd` runs with Azure Cloud Shell specific behavior.
- `AZD_SKIP_UPDATE_CHECK`: If true, skips the out-of-date update check output that is typically printed at the end of the command.
- `AZD_UPDATE_CHANNEL`: Choose which update channel to check for new versions. Set to `daily` to receive notifications for daily/continuous builds, or `stable`/`latest` (default) for official releases only. This environment variable overrides the `defaults.updateChannel` config setting. For a persistent setting, use `azd config set defaults.updateChannel daily`.

For tools that are auto-acquired by `azd`, you are able to configure the following environment variables to use a different version of the tool installed on the machine:

Expand Down
182 changes: 136 additions & 46 deletions cli/azd/main.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ func main() {
ctx = tracing.ContextFromEnv(ctx)
}

latest := make(chan semver.Version)
latest := make(chan versionCheckResult)
go fetchLatestVersion(latest)

rootContainer := ioc.NewNestedContainer(nil)
Expand All @@ -86,7 +86,7 @@ func main() {
}
}

latestVersion, ok := <-latest
checkResult, ok := <-latest

// If we were able to fetch a latest version, check to see if we are up to date and
// print a warning if we are not. Note that we don't print this warning when the CLI version
Expand All @@ -100,55 +100,88 @@ func main() {
// This is a dev build (i.e. built using `go install without setting a version`) - don't print a warning in this
// case
log.Printf("eliding update message for dev build")
} else if latestVersion.GT(internal.VersionInfo().Version) {
} else if checkResult.version.GT(internal.VersionInfo().Version) {
var upgradeText string

installedBy := installer.InstalledBy()
if runtime.GOOS == "windows" {
switch installedBy {
case installer.InstallTypePs:
//nolint:lll
upgradeText = "run:\npowershell -ex AllSigned -c \"Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression\"\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/windows"
case installer.InstallTypeWinget:
upgradeText = "run:\nwinget upgrade Microsoft.Azd"
case installer.InstallTypeChoco:
upgradeText = "run:\nchoco upgrade azd"
default:
// Also covers "msi" case where the user installed directly
// via MSI
upgradeText = "visit https://aka.ms/azd/upgrade/windows"
}
} else if runtime.GOOS == "linux" {
switch installedBy {
case installer.InstallTypeSh:
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/linux"
default:
// Also covers "deb" and "rpm" cases which are currently
// documented. When package manager distribution support is
// added, this will need to be updated.
upgradeText = "visit https://aka.ms/azd/upgrade/linux"
}
} else if runtime.GOOS == "darwin" {
switch installedBy {
case installer.InstallTypeBrew:
upgradeText = "run:\nbrew update && brew upgrade azd"
case installer.InstallTypeSh:
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/mac"
default:
upgradeText = "visit https://aka.ms/azd/upgrade/mac"

// For daily channel, only show upgrade instructions for script-based installations
if checkResult.channel == "daily" {
if runtime.GOOS == "windows" {
if installedBy == installer.InstallTypePs {
//nolint:lll
upgradeText = "run:\npowershell -ex AllSigned -c \"Invoke-RestMethod 'https://aka.ms/install-azd.ps1' -OutFile 'install-azd.ps1'; ./install-azd.ps1 -Version 'daily'\"\n\nFor more information on daily builds, see: https://aka.ms/azd/install"
} else {
//nolint:lll
upgradeText = "visit https://aka.ms/azd/install and use the PowerShell install script with '-Version daily' to upgrade to the latest daily build"
}
} else if runtime.GOOS == "linux" {
if installedBy == installer.InstallTypeSh {
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash -s -- --version daily\n\nFor more information on daily builds, see: https://aka.ms/azd/install"
} else {
//nolint:lll
upgradeText = "visit https://aka.ms/azd/install and use the install script with '--version daily' to upgrade to the latest daily build"
}
} else if runtime.GOOS == "darwin" {
if installedBy == installer.InstallTypeSh {
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash -s -- --version daily\n\nFor more information on daily builds, see: https://aka.ms/azd/install"
} else {
//nolint:lll
upgradeText = "visit https://aka.ms/azd/install and use the install script with '--version daily' to upgrade to the latest daily build"
}
} else {
upgradeText = "visit https://aka.ms/azd/install and use the install script with '--version daily' to upgrade to the latest daily build"
}
} else {
// Platform is not recognized, use the generic install link
upgradeText = "visit https://aka.ms/azd/upgrade"
// Standard upgrade instructions for stable/latest channel
if runtime.GOOS == "windows" {
switch installedBy {
case installer.InstallTypePs:
//nolint:lll
upgradeText = "run:\npowershell -ex AllSigned -c \"Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression\"\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/windows"
case installer.InstallTypeWinget:
upgradeText = "run:\nwinget upgrade Microsoft.Azd"
case installer.InstallTypeChoco:
upgradeText = "run:\nchoco upgrade azd"
default:
// Also covers "msi" case where the user installed directly
// via MSI
upgradeText = "visit https://aka.ms/azd/upgrade/windows"
}
} else if runtime.GOOS == "linux" {
switch installedBy {
case installer.InstallTypeSh:
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/linux"
default:
// Also covers "deb" and "rpm" cases which are currently
// documented. When package manager distribution support is
// added, this will need to be updated.
upgradeText = "visit https://aka.ms/azd/upgrade/linux"
}
} else if runtime.GOOS == "darwin" {
switch installedBy {
case installer.InstallTypeBrew:
upgradeText = "run:\nbrew update && brew upgrade azd"
case installer.InstallTypeSh:
//nolint:lll
upgradeText = "run:\ncurl -fsSL https://aka.ms/install-azd.sh | bash\n\nIf the install script was run with custom parameters, ensure that the same parameters are used for the upgrade. For advanced install instructions, see: https://aka.ms/azd/upgrade/mac"
default:
upgradeText = "visit https://aka.ms/azd/upgrade/mac"
}
} else {
// Platform is not recognized, use the generic install link
upgradeText = "visit https://aka.ms/azd/upgrade"
}
}

fmt.Fprintln(
os.Stderr,
output.WithWarningFormat(
"WARNING: your version of azd is out of date, you have %s and the latest version is %s",
internal.VersionInfo().Version.String(), latestVersion.String()))
internal.VersionInfo().Version.String(), checkResult.version.String()))
fmt.Fprintln(os.Stderr)
fmt.Fprintln(
os.Stderr,
Expand Down Expand Up @@ -180,10 +213,16 @@ func main() {
// which is used to cache version information for our up to date check.
const updateCheckCacheFileName = "update-check.json"

// versionCheckResult contains the result of checking for the latest version
type versionCheckResult struct {
version semver.Version
channel string
}

// fetchLatestVersion fetches the latest version of the CLI and sends the result
// across the version channel, which it then closes. If the latest version can not
// be determined, the channel is closed without writing a value.
func fetchLatestVersion(version chan<- semver.Version) {
func fetchLatestVersion(version chan<- versionCheckResult) {
defer close(version)

// Allow the user to skip the update check if they wish, by setting AZD_SKIP_UPDATE_CHECK to
Expand All @@ -198,15 +237,61 @@ func fetchLatestVersion(version chan<- semver.Version) {
}
}

// To avoid fetching the latest version of the CLI on every invocation, we cache the result for a period
// of time, in the user's home directory.
// Determine which update channel to check (latest/stable or daily)
// "latest" and "stable" both refer to official releases
// Priority: 1) Environment variable, 2) User config file, 3) Default to "latest"
updateChannel := "latest"

// First, try to read from user config file
configDir, err := config.GetUserConfigDir()
if err != nil {
log.Printf("could not determine config directory: %v, will use default channel", err)
} else {
configFilePath := filepath.Join(configDir, "config.json")
if configFile, err := os.ReadFile(configFilePath); err == nil {
if userConfig, err := config.Parse(configFile); err == nil {
if channel, ok := userConfig.GetString("defaults.updateChannel"); ok {
if channel == "daily" || channel == "stable" || channel == "latest" {
updateChannel = channel
log.Printf("using update channel '%s' from config file", channel)
} else {
log.Printf("unknown update channel '%s' in config file, using latest channel", channel)
}
}
}
}
}

// Environment variable overrides config file setting
if channel, has := os.LookupEnv("AZD_UPDATE_CHANNEL"); has {
if channel == "daily" {
updateChannel = "daily"
log.Print("using daily update channel from environment variable")
} else if channel == "stable" || channel == "latest" {
updateChannel = channel
log.Printf("using %s update channel from environment variable", channel)
} else {
log.Printf("unknown update channel '%s' in environment variable, using latest channel", channel)
}
}

// To avoid fetching the latest version of the CLI on every invocation, we cache the result for a period
// of time, in the user's home directory. Use channel-specific cache file to avoid conflicts when
// switching between update channels.
if err != nil {
log.Printf("could not determine config directory: %v, skipping update check", err)
return
}

cacheFilePath := filepath.Join(configDir, updateCheckCacheFileName)
// Re-get config dir in case we couldn't get it earlier
configDir, err = config.GetUserConfigDir()
if err != nil {
log.Printf("could not determine config directory: %v, skipping update check", err)
return
}

cacheFileName := fmt.Sprintf("update-check-%s.json", updateChannel)
cacheFilePath := filepath.Join(configDir, cacheFileName)
cacheFile, err := os.ReadFile(cacheFilePath)
if err != nil && !errors.Is(err, fs.ErrNotExist) {
log.Printf("error reading update cache file: %v, skipping update check", err)
Expand Down Expand Up @@ -251,7 +336,9 @@ func fetchLatestVersion(version chan<- semver.Version) {
// If we don't have a cached version we can use, fetch one (and cache it)
if cachedLatestVersion == nil {
log.Print("fetching latest version information for update check")
req, err := http.NewRequest(http.MethodGet, "https://aka.ms/azure-dev/versions/cli/latest", nil)

versionURL := fmt.Sprintf("https://aka.ms/azure-dev/versions/cli/%s", updateChannel)
Copy link
Member

@danieljurek danieljurek Jan 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO for engineering: ensure appropriate aka.ms links and consumed assets are set up

req, err := http.NewRequest(http.MethodGet, versionURL, nil)
if err != nil {
log.Printf("failed to create request object: %v, skipping update check", err)
}
Expand Down Expand Up @@ -313,7 +400,10 @@ func fetchLatestVersion(version chan<- semver.Version) {
}

// Publish our value, the defer above will close the channel.
version <- *cachedLatestVersion
version <- versionCheckResult{
version: *cachedLatestVersion,
channel: updateChannel,
}
}

type updateCacheFile struct {
Expand Down
6 changes: 6 additions & 0 deletions cli/azd/resources/config_options.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,12 @@
- key: pipeline.config.applicationServiceManagementReference
description: "Application Service Management Reference for Azure pipeline configuration."
type: string
- key: defaults.updateChannel
description: "Choose which update channel to check for new versions. Set to 'daily' to receive notifications for daily/continuous builds, or 'stable'/'latest' (default) for official releases only. Environment variable AZD_UPDATE_CHANNEL takes precedence over this config setting."
type: string
allowedValues: ["stable", "latest", "daily"]
envVar: "AZD_UPDATE_CHANNEL"
example: "daily"
- key: (env) AZD_CONFIG_DIR
description: "Override the default configuration directory location."
type: envvar
Expand Down
21 changes: 21 additions & 0 deletions cli/installer/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -170,6 +170,27 @@ The `--install-folder` parameter places the `azd` binary in the specified locati

The `daily` feed is periodically updated with builds from the latest source code in the `main` branch. Use the `version` parameter to download the latest daily release.

#### Enabling update notifications for daily builds

By default, `azd` checks for updates from the stable release channel. If you're using daily builds and want to receive update notifications for new daily builds, you can configure this using either a config setting or an environment variable.

**Using config (recommended for persistent setting):**
```bash
azd config set defaults.updateChannel daily
```

**Using environment variable (overrides config):**
```bash
export AZD_UPDATE_CHANNEL=daily
```

To switch back to stable releases:
```bash
azd config set defaults.updateChannel stable
```

**Note:** When using daily builds, ensure you've installed azd using the install script with the `--version daily` parameter (shown below) to get the latest daily build. Update notifications will alert you when newer daily builds become available.

#### Windows

##### Install
Expand Down
24 changes: 24 additions & 0 deletions eng/pipelines/templates/stages/publish.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -375,6 +375,30 @@ stages:
CreateGitHubRelease: false
PublishUploadLocations: release/daily;daily/archive/$(Build.BuildId)-$(Build.SourceVersion)

# Upload version.txt for daily builds to enable update notifications
- pwsh: |
New-Item -ItemType Directory -Path daily-version -Force
Write-Output $(CLI_VERSION) | Out-File -Encoding utf8 -FilePath ./daily-version/version.txt
displayName: Write version.txt file for daily builds

- task: AzurePowerShell@5
displayName: Upload version.txt to daily channel
inputs:
azureSubscription: 'Azure SDK Artifacts'
azurePowerShellVersion: LatestVersion
pwsh: true
ScriptType: InlineScript
Inline: |
Get-ChildItem daily-version/
Write-Host "Upload to azd/standalone/release/daily"
azcopy copy "daily-version/*" "$(publish-storage-location)/`$web/azd/standalone/release/daily" --overwrite=true
if ($LASTEXITCODE) {
Write-Error "Upload failed"
exit 1
}
env:
AZCOPY_AUTO_LOGIN_TYPE: 'PSCRED'

- deployment: Publish_For_PR
environment: none
condition: >-
Expand Down