歡迎使用 Azure 開發人員 CLI (azd)! 讓我們開始安裝並學習如何運行 azd。
首先選擇您的開發環境。 如需不同開發環境選擇優缺點的詳細資訊,請參閱 Azure 開發人員 CLI (azd) 支援的環境。
如需更進階的安裝案例和指示,請參閱 Azure 開發人員 CLI 安裝程式腳本。
附註:當您安裝 azd 時,下列工具會安裝在 azd 的範疇內(這表示它們不會全域安裝),並在解除安裝 azd 時移除。
安裝 azd
winget install microsoft.azd
更新 azd
winget upgrade microsoft.azd
解除安裝 azd
winget uninstall microsoft.azd
安裝 azd
choco install azd
更新 azd
choco upgrade azd
解除安裝 azd
choco uninstall azd
安裝 azd
安裝指令碼會下載並安裝具有預設參數的電腦上的 MSI 套件。
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
更新 azd
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
解除安裝 azd
使用卸載腳本刪除 azd 會將一些項目留在計算機上。
相反地,對於 0.5.0-beta.1 版及更新版本:
搜尋 Windows 中的 新增或移除程式 。
找出 Azure Dev CLI ,然後選取三個點以展開選項功能表。
選取解除安裝。
備註
對 Windows Arm64 的支援目前處於 Alpha 階段。 如需詳細資訊,請造訪 功能版本設定和發行策略 頁面。
Arm64 azd 版本可直接在 GitHub 發行頁面上下載。 目前,沒有直接支援套件管理員安裝程式或其他管道。
安裝 azd
備註
如果您的計算機已安裝 Windows x86_64 版本 azd ,請先解除安裝 x86_64 版本,以防止 MSI 升級或修復寫入 Arm64 可執行檔。
在 GitHub 發行頁面 頁面上,下載最新 azd-windows-arm64-alpha.zip 檔案。
解壓縮 azd-windows-arm64-alpha.zip 檔案並將可執行檔複製 azd-windows-amd64.exe 到裝置上的預設 azd 位置 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI 。
將 PATH 項目新增至您裝置上的環境變數,指向位於 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe 的解壓縮文件。
更新 azd
在 GitHub 發行頁面 頁面上,下載最新 azd-windows-arm64-alpha.zip 檔案。
解壓縮 azd-windows-arm64-alpha.zip 檔案並將可執行檔複製 azd-windows-amd64.exe 到裝置上的預設 azd 位置 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI ,以取代現有的可執行檔。
確認您的裝置上有一個 PATH 環境變數,該變數指向 的解壓縮檔案 C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI\azd-windows-amd64.exe。
解除安裝 azd
從預設的azd位置C:\Users\<username>\AppData\Local\Programs\Azure Dev CLI移除裝置上的azd-windows-amd64.exe可執行檔。 如果您安裝 azd 在其他位置,則需要從該位置刪除它。
移除 PATH 您新增的環境變數,以指向 azd 安裝位置。
備註
在 Apple Silicon Mac 上(M1 和 M2) azd 需要 Rosetta 2。 如果尚未安裝 Rosetta 2,請從終端機執行 softwareupdate --install-rosetta 。
azd安裝過程將自動為您的機器架構選擇正確的二進位檔。
安裝 azd
brew tap azure/azd && brew install azd
brew tap azure/azd命令只需運行一次即可在brew中配置分流器。
如果您要使用brew從未使用brew安裝的版本中升級azd,請使用解除安裝指令碼(如果安裝到預設位置)或手動刪除azd二進位檔來移除現有的azd版本。 這將自動安裝正確的版本。
更新 azd
brew upgrade azd
解除安裝 azd
brew uninstall azd
備註
azd安裝過程將自動為機器的架構選擇正確的二進位檔。
安裝指令碼可用來在電腦範圍內安裝正確的 azd 版本。
curl -fsSL https://aka.ms/install-azd.sh | bash
更新 azd
curl -fsSL https://aka.ms/install-azd.sh | bash
解除安裝 azd
curl -fsSL https://aka.ms/uninstall-azd.sh | bash
安裝 azd
curl -fsSL https://aka.ms/install-azd.sh | bash
更新 azd
curl -fsSL https://aka.ms/install-azd.sh | bash
當您安裝 azd 時,下列工具會在 azd 的範圍內安裝(這表示它們不會全域安裝),並在解除安裝 azd 時移除:
解除安裝 azd
curl -fsSL https://aka.ms/uninstall-azd.sh | bash
Azure 開發人員 CLI 會將已簽署 .deb 的和 .rpm 套件發行至 GitHub 版本。 若要安裝或更新,請從 GitHub 版本下載適當的檔案,然後執行適當的命令來安裝套件:**
安裝或更新 .deb 套件以用於 azd
您可以使用apt-get來安裝.deb套件:
curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd_<version>_amd64.deb -o azd_<version>_amd64.deb
apt update
apt install ./azd_<version>_amd64.deb -y
解除安裝 azd 的 .deb 套件
apt remove -y azd
Azure 開發人員 CLI 會將已簽署的 .deb 和 .rpm 套件發行至 GitHub 發布。 若要安裝,請從 GitHub 版本下載適當的檔案,然後執行適當的命令來安裝套件:**
安裝適用於 azd 的 .rpm 套件
您可以使用yum install以下指令安裝.rpm套件:
curl -fSL https://github.com/Azure/azure-dev/releases/download/azure-dev-cli_<version>/azd-<version>-1.x86_64.rpm -o azd-<version>-1.x86_64.rpm
yum install -y azd-<version>-1.x86_64.rpm
解除安裝 azd 的 .rpm 套件
yum remove -y azd
先決條件
開始使用 azd之前,請確定您擁有:
安裝 azd 在開發容器中
開發容器是 Docker 映像,其中包含在本機電腦上執行應用程式所需的所有必要條件。 依照下列步驟將 azd 安裝為開發容器中的一個功能:
請將azd功能新增到範本根目錄的.devcontainer資料夾中的devcontainer.json檔案。
{
"name": "Azure Developer CLI",
"image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
"features": {
// See https://containers.dev/features for list of features
"ghcr.io/devcontainers/features/docker-in-docker:2": {
},
"ghcr.io/azure/azure-dev/azd:latest": {}
}
// Rest of file omitted...
}
重建並執行您的開發容器。 在 Visual Studio Code 中,使用 命令面板 來執行 [ 在開發容器中重建並重新開啟 ] 命令。
確認安裝
在終端機中執行命令azd,以驗證您的azd version安裝已成功完成:
azd version
azd 列印目前版本:
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
更新 Azure 開發人員 CLI
使用過期版本 azd的 時,您會看到升級至最新版本的警告。 請按照警告中的指示更新到最新版本。
請求幫助
如需如何提出 Bug、要求協助或為 Azure 開發人員 CLI 提出新功能的相關信息,請流覽 疑難解答和支援 頁面。
後續步驟