Azure Developer CLI (azd) へようこそ。
azdを実行する方法のインストールと学習を始めましょう。
まず、開発環境を選択します。 さまざまな開発環境の選択肢の長所と短所の詳細については、「Azure Developer CLI (azd) でサポートされる環境>」を参照してください。
より高度なインストール シナリオと手順については、「Azure Developer CLI Installer Scripts」を参照してください。
注: azdをインストールすると、次のツールが azd スコープ内にインストールされ (つまり、グローバルにインストールされません)、azd がアンインストールされると削除されます。
azd のインストール
winget install microsoft.azd
azd を更新する
winget upgrade microsoft.azd
アンインストール azd
winget uninstall microsoft.azd
注
Apple Silicon Mac (M1 および M2) azd では Rosetta 2 が必要です。 Rosetta 2 がまだインストールされていない場合は、ターミナルから softwareupdate --install-rosetta 実行します。
azdインストール プロセスでは、コンピューターのアーキテクチャに適したバイナリが自動的に選択されます。
azd のインストール
brew install azure/azd/azd
brewを使用して、azdを使用してインストールされていないバージョンからbrewをアップグレードする場合は、アンインストール スクリプトを使用して (既定の場所にインストールされている場合)、またはazd バイナリを手動で削除して、既存のバージョンのazdを削除します。 これにより、正しいバージョンが自動的にインストールされます。
azd を更新する
brew upgrade --cask azure/azd/azd
アンインストール azd
brew uninstall azd
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
[前提条件]
azdの使用を開始する前に、次のことを確認してください。
- インストール：
- Docker Desktop (他のオプションは近日公開予定)。
- リモートコンテナー用の VS Code 拡張機能
- アクティブなサブスクリプションを持つAzure アカウント。 無料で作成できます。
開発コンテナーに azd をインストールする
開発コンテナーは、ローカル コンピューターでアプリを実行するために必要なすべての前提条件を含む Docker イメージです。 次の手順に従って、 azd を機能として開発コンテナーにインストールします。
テンプレートのルートにある
azdフォルダーのdevcontainer.jsonファイルに.devcontainer機能を追加します。{ "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で、コマンド パレットを使用して、Rebuild と Reopen in Dev Container コマンドを実行します。
azd extensions の自動インストール
azd開発コンテナー機能では、コンテナーのビルド中に、extensions拡張機能のコンマ区切りの一覧を自動的にインストールするazd オプションがサポートされています。 この方法でインストールされた拡張機能は、コンテナーが起動するとすぐに使用でき、手動セットアップが減り、必要な拡張機能が既にインストールされている状態で azd コマンドを実行できるようになります。
拡張機能を自動インストールするには、extensions ファイルのazd機能エントリに devcontainer.json オプションを追加します。
{
"name": "Azure Developer CLI",
"image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
"features": {
"ghcr.io/azure/azure-dev/azd:latest": {
"extensions": "my-ext-1,my-ext-2"
}
}
}
extensionsの値はazd拡張名のコンマ区切りリストです。 インストールはコンテナーのビルド中に行われるため、コンテナーが起動するとすぐに拡張機能を使用できるようになります。 拡張機能の一覧を変更した後、Visual Studio Codeの Rebuild と Reopen in Dev Container コマンドを使用して、更新された拡張機能でコンテナーを再構築します。
azd Dev Container Feature の詳細を確認します。
インストールの検証
ターミナルで azd コマンドを実行して、azd versionのインストールが正常に完了したことを確認します。
azd version
azd は現在のバージョンを出力します。
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
Azure Developer CLI を更新する
azdは、組み込みのazd update コマンド (ベータ) を使用するか、インストールに使用したのと同じ方法を使用して手動で更新できます。
azd update (ベータ) を使用する
azd update コマンドは、azdが最初にインストールされた方法を検出し、適切な更新方法に自動的に委任します。
| インストール方法 |
azd updateの機能 |
|---|---|
winget |
winget upgrade Microsoft.Azd を実行します |
choco |
実行 choco upgrade azd |
| スクリプトまたは MSI のインストール (Windows) | 自動バックアップと復元を使用して install-azd.ps1 を実行します |
| インストール スクリプト (Linux/macOS) | 実行 install-azd.sh |
| Homebrew | 実行 brew upgrade --cask azure/azd/azd |
.deb
/
.rpm パッケージ |
バイナリを直接ダウンロードして置き換える |
次のコマンドを実行して、最新の安定バージョンに更新します。
azd update
注
azd update コマンドは現在ベータ版です。 アルファ機能とベータ版の機能サポートの詳細については、 機能のバージョン管理とリリース戦略 に関するページを参照してください。
更新チャネルの切り替え
azd では、 stable (既定) と dailyの 2 つの更新チャネルがサポートされています。 チャネルの切り替えは、スクリプト ベースのインストールと Homebrew でサポートされています。
azdまたはwingetを使用してchocoをインストールした場合、これらのパッケージ マネージャーから毎日のビルドを使用することはできません。azd update最初にスクリプトを使用して再インストールするガイダンスが表示されます。
daily チャネルに切り替えて更新するには:
azd update --channel daily
stable チャネルに戻すには:
azd update --channel stable
チャネルを切り替えるとき、 azd 続行する前に確認を求められます。
パッケージ マネージャーまたはインストール スクリプトを使用する
また、上記のインストール セクションで示したのと同じパッケージ マネージャーまたはインストール スクリプト コマンドを使用して、いつでも手動で更新することもできます。
azdが古い場合、インストール方法に該当する更新コマンドを含む警告メッセージが表示されます。
ヘルプを要求する
Azure Developer CLI のバグの報告、ヘルプの要求、または新機能の提案の方法については、トラブルシューティングとサポートページを参照してください。