Skip to content

[Bug] Cloud Shell requires azd version 1.18.0 for deployments #574

Closed

Description

@Pavan-Microsoft

To Reproduce

Open Cloud Shell and check azd version

azd version

Attempt deployment with solution accelerators requiring azd >= 1.18.0

azd up

Observed Behavior

Deployment fails because the required minimum azd version (1.18.0) is not present.
Error messages indicate version incompatibility.

Expected behavior

Deployments using solution accelerators should succeed in Cloud Shell with azd version 1.18.0 or higher.

Is this specific to Cloud Shell?

Deployments succeed outside Cloud Shell with azd >= 1.18.0. This indicates the issue is specific to Cloud Shell image version.

Interface information

https://portal.azure.com, https://shell.azure.com (Browser)
Operating System / Browser: Example: Windows 10 / Chrome 140

Additional context

Request: Please update Cloud Shell to include azd version 1.18.0 or higher in the next image refresh.

Activity

  1. Pavan-Microsoft commented on Oct 6, 2025

    @Pavan-Microsoft
    Author

    Hi team, following up to check if there’s any update on the Cloud Shell image refresh to include azd version 1.18.0 or higher.

  2. Pavan-Microsoft commented on Oct 8, 2025

    @Pavan-Microsoft
    Author

    Hi team, following up to check if there’s any update on the Cloud Shell image refresh to include azd version 1.18.0 or higher.

  3. Pavan-Microsoft commented on Oct 10, 2025

    @Pavan-Microsoft
    Author

    Hi team, following up to check if there’s any update on the Cloud Shell image refresh to include azd version 1.18.0 or higher.

  4. mbifeld commented on Oct 14, 2025

    @mbifeld
    Member

    Hi Pavan-Microsoft, I verified that the next Cloud Shell image release will have azd version 1.19.0. It will roll out in ~3-4 weeks. Are there templates or workloads that are failing with azd 1.17 in Cloud Shell today?

  5. Pavan-Microsoft commented on Oct 15, 2025

    @Pavan-Microsoft
    Author

    Hi Mitchell Bifeld (@mbifeld), yes—we tried deploying Conversation Knowledge Mining Solution Accelerator

    As a workaround, we followed these steps to install azd v1.18.0 in Cloud Shell:

    1. Open Cloud Shell

      In the Azure Portal, click the Cloud Shell icon (>_) in the top bar.
      Choose Bash if prompted.

    2. Prepare installation directories

    mkdir -p ~/azd ~/bin
    • ~/azd will host the azd binaries.
    • ~/bin will contain a symlink to your chosen azd version.
    1. Install azd v1.18.0 locally
    curl -fsSL https://aka.ms/install-azd.sh | bash -s -- --install-folder ~/azd --symlink-folder ~/bin --version 1.18.0

    What this does:

    • Downloads and executes the official installer script.
    • Places the v1.18.0 binaries in ~/azd.
    • Creates ~/bin/azd as a symlink to the new binary.
    1. Ensure ~/bin is first in your PATH

    Cloud Shell’s default profile prepends ~/bin to PATH. To verify:

    echo $PATH | tr ':' ' ' | head -n 3

    You should see ~/bin listed at or near the top. If not, add this to ~/.bashrc or ~/.profile:

    echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc

    Then reload:

    source ~/.bashrc
    1. Confirm the new azd version
    azd version

    Expected output sample:

    Azure Developer CLI (azd) Version: 1.18.0 Commit: <commit-hash>
    
    1. Retry your deployment
    azd up

    Deployments should proceed without the “minimum azd version” error.

    1. (Optional) Revert to the built-in azd

    If you ever need to go back to the Cloud Shell’s default azd:

    rm ~/bin/azd
    rm -rf ~/azd

    .

  6. mbifeld commented on Oct 24, 2025

    @mbifeld
    Member

    Awesome, glad you found a workaround for the time being until the next Cloud Shell release :)

  7. mbifeld commented on Dec 8, 2025

    @mbifeld
    Member

    Cloud Shell now has azd version 1.19.0. Closing issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Triage-neededTriage needed by Cloud Shell teambugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions