azd upgrade

[danieljurek]

Collection of specifications and resources for an azd upgrade command which can bring a user up to the latest version of azd for their given "channel" (e.g. GA, latest, daily)

• Check latest available version and alert a user if their version is behind for their current channel

• User can run azd upgrade command at any time to upgrade using their existing installation style

• Copy azd to $TEMP and run the copy with parameters to launch the upgrade. This prevents file locks during the upgrade process that would halt the upgrade.

• MSI

  • Download MSI
  • Determine MSI state and launch install with appropriate configs

• macos brew

  • Fork and run brew upgrade

• RPM/DEB Linux

  • Download appropriate package file (.rpm/.deb)
  • Run the installer

In all cases, ensure that the .installed-by.txt file includes that most recent installation was performed using azd upgrade.

Bake the install channel into the binary itself (similar to how version is done).

[danieljurek]

File locking: https://pkg.go.dev/cmd/go/internal/lockedfile/internal/filelock

[danieljurek]

Open questions:

• In the case of rpm/deb one would likely need to be root
• Will msiexec.exe elevate in the case of ALLUSERS=1?
• Are there custom parameters in brew install or rpm/deb that we need to detect/account for?

Other notes:

• Wait for azd to become writable (not in use by telemetry upload, etc.)

• Do NOT do telemetry upload if it blocks the azd binary

• How are we going to test this?

  • (See existing e2e test infra that builds a copy of azd)
  • Arrange a web server of some sort
  • AZD_UPGRADE_URL=http://localhost.../ azd upgrade

[ellismg]

File locking: https://pkg.go.dev/cmd/go/internal/lockedfile/internal/filelock

Just an FYI, we already have some uses of this package in the codebase: https://pkg.go.dev/github.com/gofrs/flock for doing file locking. We use this in both the telemetry system and in our msal cache.

[danieljurek]

Also include a .channel.txt in the same directory as azd which inform the channel to search for the latest version.

[wbreza]

Based on feedback from partner teams having an azd upgrade command will be very useful. People are having a hard time remembering how they installed azd and not quite sure what upgrade path to follow or upgrade showing successful but azd version still showing out of date.

[jongio]

I'd also implement a azd bicep upgrade as there have been many times that azd is behind on bicep version and I need to use the latest bicep

[savannahostrowski]

If we wanted to expose upgrade commands for tooling, I'd probably rather see us have something more generic to azd tool upgrade. That's lower priority and IMO, should be discussed as a separate item.