Skip to content
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.

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

Add instruction for installing specific version #2801

Merged
merged 7 commits into from
Nov 2, 2021

Conversation

jiasli
Copy link
Member

@jiasli jiasli commented Oct 26, 2021

This PR is based on Azure/azure-cli#13331 (comment).

There are scenarios where the latest Azure CLI

  • doesn't satisfy users' needs
  • introduces breaking changes that users are not yet ready to adopt to
  • contains bugs that can't be fixed immediately

To address these scenarios, we provide the instruction for installing specific version.

@opbld31
Copy link

opbld31 commented Oct 26, 2021

Docs Build status updates of commit 61e5a2e:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/includes/interactive-login.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

Comment on lines 46 to 47
curl -L https://raw.githubusercontent.com/azclibot/homebrew-core/azcli2.29.1/Formula/azure-cli.rb > azure-cli.rb
brew install --build-from-source azure-cli.rb
Copy link
Member Author

Choose a reason for hiding this comment

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

Installing from URL (Azure/azure-cli#13331 (comment)) won't work:

brew extract or brew create and brew tap-new to create a formula file in a tap on GitHub instead.: Invalid usage: Non-checksummed download of azure-cli formula file from an arbitrary URL is unsupported! (UsageError)

Found the workaround from jhen0409/react-native-debugger#567.

Copy link
Member Author

Choose a reason for hiding this comment

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

We need to remove the instruction for now as azclibot/homebrew-core is not an official repo. There is not way for brew to install historical versions from their official repo.

@opbld30
Copy link

opbld30 commented Oct 26, 2021

Docs Build status updates of commit 7f7e6c9:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/includes/interactive-login.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@opbld32
Copy link

opbld32 commented Oct 26, 2021

Docs Build status updates of commit f855aa3:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/includes/interactive-login.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:


To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
```bash
sudo apt-get install azure-cli=2.29.1-1~bullseye
Copy link
Contributor

Choose a reason for hiding this comment

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

Generally in docs, version examples like thiese are given a generic replacement value and instructed to replace that with desired version. E.g.

"

 sudo apt-get install azure-cli=<version>~bullseye

Replace <version> with required version"

Is there a reason to add a specific version? This isn't a holding change as everything will work, just curious

Copy link
Member Author

Choose a reason for hiding this comment

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

Actually no special reason. It just serves as an example. I will change it, of course. Thanks for the suggestion.

@opbld30
Copy link

opbld30 commented Nov 1, 2021

Docs Build status updates of commit 6e10c71:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/includes/interactive-login.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

Comment on lines 72 to 78
## Sign in to Azure with the Azure CLI
## Install specific version

Run the Azure CLI with the `az` command. To sign in, use the [az login](/cli/azure/reference-index#az_login) command.
You must first configure `azure-cli` repository information as shown above.

[!INCLUDE [interactive-login](interactive-login.md)]
1. To view available versions:

To learn more about different authentication methods, see [Sign in with Azure CLI](../authenticate-azure-cli.md).
Copy link
Member Author

Choose a reason for hiding this comment

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

The "sign in" section is duplicated many times and is actually irrelevant to the topic of installation.

@opbld33
Copy link

opbld33 commented Nov 1, 2021

Docs Build status updates of commit a13cf6d:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-script.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@opbld32
Copy link

opbld32 commented Nov 1, 2021

Docs Build status updates of commit 55242b8:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-script.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@opbld31
Copy link

opbld31 commented Nov 1, 2021

Docs Build status updates of commit d0f308d:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-script.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@opbld31
Copy link

opbld31 commented Nov 1, 2021

Docs Build status updates of commit 0d85476:

✅ Validation status: passed

File Status Preview URL Details
docs-ref-conceptual/includes/cli-install-linux-apt.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-dnf.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-script.md ✅Succeeded View
docs-ref-conceptual/includes/cli-install-linux-zypper.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-macos.md ✅Succeeded View
docs-ref-conceptual/install-azure-cli-windows.md ✅Succeeded View
docs-ref-conceptual/run-azure-cli-docker.md ✅Succeeded View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

@jiasli jiasli merged commit c653259 into MicrosoftDocs:master Nov 2, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants