Aspire CLI をインストールする

Aspire には、Aspire ベースのアプリを作成・管理するためのコマンドラインインターフェイス（CLI）ツールが用意されています。 この CLI は、インタラクティブな操作を中心とした体験により、開発ワークフローを効率化します。

このガイドでは、お使いのシステムに Aspire CLI をインストールする方法をご紹介します。 なお、Aspire CLI を使用するには .NET 10.0 SDK が必要です。

Aspire CLI をインストールする前に、 必要な事前準備 が整っていることを確認してください。

Aspire CLI をインストール

Aspire CLI をインストールするには、インストールスクリプトをダウンロードして実行してください:

ダウンロード & インストール

1 つのコマンドでインストールスクリプトをダウンロードして実行し、Aspire CLI をインストールできます:

Bash

curl -sSL https://aspire.dev/install.sh | bash

PowerShell

irm https://aspire.dev/install.ps1 | iex

このスクリプトは、Aspire CLI インストールを確認するには、 検証 をご覧ください。

2 段階のインストール手順

別の方法として、スクリプトをダウンロードしてから実行するという 2 段階の手順でインストールすることもできます:

1. ターミナルを開きます。

2. スクリプトをダウンロードしてファイルとして保存します:

   Bash

   curl -sSL https://aspire.dev/install.sh -o aspire-install.sh

   PowerShell

   irm https://aspire.dev/install.ps1 -OutFile aspire-install.ps1

3. 安定版の Aspire をインストールするためにスクリプトを実行してください。

   次のような出力が表示されるはずです。:

   Bash

   Output

   Downloading from:
   https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-linux-x64.tar.gz
   Aspire CLI successfully installed to: /home/username/.aspire/bin/aspire
   Added /home/username/.aspire/bin to PATH for current session Added
   /home/username/.aspire/bin to PATH in /home/username/.bashrc The aspire
   cli is now available for use in this and new sessions.

   PowerShell

   Output

   Downloading from:
   https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-win-x64.zip
   Aspire CLI successfully installed to: C:\Users\name\.aspire\bin\aspire.exe
   Added C:\Users\username\.aspire\bin to PATH for current session Added
   C:\Users\username\.aspire\bin to user PATH environment variable The aspire
   cli is now available for use in this and new sessions.

検証

Aspire CLI が正しくインストールされているか確認するには、 aspire --versionを実行して、バージョン番号を取得してください:

Aspire CLI

aspire --version

次は、そのコマンドを実行した例です:

そのコマンドが正常に動作すれば、Aspire CLI ツールのバージョンが表示されます:

Aspire CLI — Output

13.2.0+{commitSHA}

+{commitSHA} というサフィックスは、Aspire CLI がどのコミットからビルドされたかを示しています。 このサフィックスはプレリリース版に含まれ、安定版リリースでは表示されない場合があります。

もっと詳しく知るには、Aspire CLI のリファレンス ドキュメントをご覧ください。

トラブルシューティング

バージョン番号が表示されない場合、PATH 環境変数の変更がターミナルに反映されていない可能性があります。 一度ターミナルを閉じて再度開き、もう一度 aspire --version コマンドを実行してみてください。

関連項目

• aspire-install スクリプト リファレンス
• aspire コマンド リファレンス