Microsoft Dev Box カスタマイズのタスクを作成する場合は、開発ボックスの特定のアクションを定義して、一貫性のある効率的な開発環境を確保できます。 カタログ内で新しいタスクを作成すると、開発チームに合わせた再利用可能なコンポーネントを定義し、利用可能な構成を制限するガードレールを追加できます。 この記事では、カスタマイズ タスク用のカタログの作成、タスクの追加、デベロッパー センターまたはプロジェクトへのカタログのアタッチについて説明します。
タスクは、ソフトウェアのインストールなどの特定のアクションを実行します。 各タスクは、1 つ以上の PowerShell スクリプトと、パラメーターを提供してスクリプトの実行方法を定義する task.yaml ファイルで構成されます。 task.yaml ファイルに PowerShell コマンドを含めることもできます。
デベロッパー センターにアタッチされたカタログに、キュレーションされたタスクのコレクションを、各タスクを別個のフォルダーにして格納できます。 Dev Box では、GitHub リポジトリまたは Azure Repos リポジトリのカタログとしての使用がサポートされています。 Dev Box は、カタログの指定されたフォルダーを再帰的にスキャンして、タスク定義を検索します。
WinGet と PowerShell は、カタログを必要とせず、どのデベロッパー センターでも入手できます。 カスタマイズで WinGet または PowerShell のみを使用する場合は、カスタマイズ ファイルでそれらを使用するタスクを作成できます。 他のツールやスクリプトを使用する必要がある場合は、カタログ内にタスクを作成します。
Microsoft からは、カスタマイズを始めるのに役立つクイック スタート カタログが提供されています。 これには、一般的なアクションを定義する既定のタスク セットが含まれます。
- WinGet パッケージ マネージャーを使用してソフトウェアをインストールする。
- WinGet 構成を使用して、Desired State Configuration (DSC) をデプロイする。
-
git-cloneを使用してリポジトリをクローンする。 - アプリケーションを構成する (Visual Studio 拡張機能のインストールなど)。
- PowerShell スクリプトを実行する。
[前提条件]
この記事の手順を実行するには、以下が必要です。
- 開発ボックス プロジェクトが構成されたデベロッパー センター。
- GitHub または Azure Repos 上にある既存のカタログ。
カスタマイズを構成するために必要なアクセス許可については、「カスタマイズ のアクセス許可」を参照してください。
カタログ内でタスクを作成する
ソフトウェアのインストールやスクリプトの実行などのタスクは、カタログとしてまとめられます。 カタログ内でタスクを作成、管理し、新しいタスクを定義して、そのカタログをデベロッパー センターに関連付けます。 Microsoft のクイックスタート カタログを使用すると、ソフトウェアのインストール、DSC のデプロイ、リポジトリの複製、アプリケーションの構成など、一般的なタスクを開始できます。
新しいタスクを定義する
Dev Box チーム カスタマイズ用のタスクを作成および管理するには、次の手順に従います。
タスクを格納するリポジトリを作成します。 必要に応じて、クイック スタート カタログのコピーを独自のリポジトリに作成し、それを使って始めることができます。
既存の PowerShell スクリプトを変更するか、新しいスクリプトを作成して、リポジトリにタスクを作成します。 タスクの作成を開始するには、デベロッパー センターの例と PowerShell ドキュメントの GitHub リポジトリの例を使用できます。
リポジトリをカタログとしてデベロッパー センターにアタッチします。
「チームのカスタマイズを構成する」の手順に従って、これらのタスクの構成ファイルを作成します。
Azure キー コンテナーのシークレットを使用する
YAML 構成で Azure Key Vault のシークレットを使用して、プライベート リポジトリを複製したり、アクセス トークンを必要とするタスクを実行したりできます。 詳細な構成手順と例については、 Azure リソースへの接続またはプライベート リポジトリの複製に関するページを参照してください。
カタログをアタッチする
カタログをプロジェクトにアタッチして、開発者チームがタスクにアクセスできるようにします。 カタログをプロジェクトにアタッチするには、「 Microsoft Dev Box でカタログを追加および管理する」の手順に従います。