Skip to content

Commit 8975afc

Browse files
authored
{Doc} Update try_new_features_before_release.md (#22872)
1 parent cabcd93 commit 8975afc

File tree

1 file changed

+19
-7
lines changed

1 file changed

+19
-7
lines changed

doc/try_new_features_before_release.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
11
# Try new features before release
22

3-
This documentation shows how to try new features in commit or PR before release even if the PR is not merged.
3+
This documentation shows how to try new features in commits or PRs before release even if the PR is not merged.
44

5-
Azure CLI releases new versions every 3 weeks. Many customers and developers are eager to try and test new features before the formal release. Fortunately, Azure CLI project builds artifacts for every commit and PR and you can download them.
5+
Azure CLI release schedule can be found at https://github.com/Azure/azure-cli/milestones. Many customers and developers are eager to try and test new features before the formal release. Fortunately, Azure CLI project builds artifacts for every commit and PR and you can download them.
66

7-
## Tutorial for commit
7+
## Install edge builds for `dev` branch
8+
9+
The most convenient way is to [install edge builds](https://github.com/Azure/azure-cli#edge-builds) released for every commit on `dev` branch.
10+
11+
If no edge builds are released for your platform, you may directly install the artifacts built by the CI pipeline as described below.
12+
13+
## For commits
814

915
Step 1. Select a commit. Click the √ or × symbol. Click "Details" of a "build package" item.
1016

@@ -22,7 +28,7 @@ Step 4. Download your favorite artifact.
2228

2329
![](assets/4.PNG)
2430

25-
## Tutorial for PR
31+
## For PRs
2632

2733
Step 1. Open a PR no matter it is merged or not. Click "Checks" tab.
2834

@@ -39,19 +45,22 @@ Follow the same steps in previous sessions and find artifact page. Click `pypi`
3945
![](assets/6.PNG)
4046

4147
```powershell
42-
pip install azure_cli-2.6.0-py3-none-any.whl azure_cli_command_modules_nspkg-2.0.3-py3-none-any.whl azure_cli_core-2.6.0-py3-none-any.whl azure_cli_nspkg-3.0.4-py3-none-any.whl azure_cli_telemetry-1.0.4-py3-none-any.whl azure_mgmt_imagebuilder-1.0.0-py2.py3-none-any.whl
48+
pip install azure_cli-2.6.0-py3-none-any.whl azure_cli_core-2.6.0-py3-none-any.whl azure_cli_telemetry-1.0.4-py3-none-any.whl azure_mgmt_imagebuilder-1.0.0-py2.py3-none-any.whl
4349
```
44-
`azure_cli-2.6.0-py3-none-any.whl`, `azure_cli_command_modules_nspkg-2.0.3-py3-none-any.whl`, `azure_cli_core-2.6.0-py3-none-any.whl`, `azure_cli_nspkg-3.0.4-py3-none-any.whl`, `azure_cli_telemetry-1.0.4-py3-none-any.whl` are packages of Azure CLI. `azure_mgmt_imagebuilder-1.0.0-py2.py3-none-any.whl` is a package of Image Builder resource provider. You should change it to your own SDK package containing the new feature.
50+
`azure_cli-2.6.0-py3-none-any.whl`, `azure_cli_core-2.6.0-py3-none-any.whl`, `azure_cli_telemetry-1.0.4-py3-none-any.whl` are packages of Azure CLI. `azure_mgmt_imagebuilder-1.0.0-py2.py3-none-any.whl` is a package of Image Builder resource provider. You should change it to your own SDK package containing the new feature.
4551

4652
We recommend using a virtual environment to install the `.whl` files. This is an optional step.
4753
Example commands in PowerShell:
4854

4955
```powershell
50-
# Create a virtual environment
56+
# Create a virtual environment
5157
python -m venv env
5258
5359
# Activate it
60+
# PowerShell
5461
env\Scripts\activate.ps1
62+
# Linux/MacOS Bash
63+
. ./env/bin/activate
5564
```
5665

5766
## Install from source code
@@ -70,7 +79,10 @@ git checkout <branch>/<commit>
7079
python -m venv env
7180
7281
# Activate the virtual environment
82+
# PowerShell
7383
env\Scripts\activate.ps1
84+
# Linux/MacOS Bash
85+
. ./env/bin/activate
7486
7587
# Install azdev - the development tool for Azure CLI
7688
pip install azdev

0 commit comments

Comments
 (0)