Freigeben über


Schnellstart: Konfigurieren von Microsoft Dev Box mithilfe einer ARM-Vorlage

In dieser Schnellstartanleitung wird beschrieben, wie Sie eine Azure Resource Manager (ARM)-Vorlage zum Einrichten des Microsoft Dev Box-Diensts in Azure verwenden.

Eine Azure Resource Manager-Vorlage ist eine JSON (JavaScript Object Notation)-Datei, welche die Infrastruktur und die Konfiguration für Ihr Projekt definiert. Die Vorlage verwendet eine deklarative Syntax. Sie beschreiben Ihre geplante Bereitstellung, ohne die Abfolge der Programmierbefehle zu schreiben, mit denen die Bereitstellung erstellt wird.

Diese Dev Box mit angepasster Imagevorlage stellt eine einfache Dev Box-Umgebung bereit, die Sie zum Testen und Erkunden des Diensts verwenden können.

Es erstellt die folgenden Dev Box-Ressourcen: Dev Center, Projekt, Netzwerkverbindung, Definition von Dev Box und Dev Box Pool. Nachdem die Vorlage bereitgestellt wurde, können Sie zum Entwicklerportal wechseln, um Ihr Entwicklerfeld zu erstellen.

Wenn Ihre Umgebung die Voraussetzungen erfüllt und Sie mit der Verwendung von ARM-Vorlagen vertraut sind, wählen Sie die Schaltfläche Deploy to Azure aus. Die Vorlage wird im Azure-Portal geöffnet.

Schaltfläche zum Bereitstellen der Resource Manager-Vorlage in Azure.

Voraussetzungen

  • Wenn Sie noch kein Azure-Abonnement haben, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
  • Die Rolle „Besitzer“ oder „Mitwirkender“ für ein Azure-Abonnement oder eine bestimmte Ressourcengruppe
  • Microsoft Entra AD. Ihre Organisation muss Microsoft Entra AD für die Identitäts- und Zugriffsverwaltung verwenden.
  • Microsoft Intune-Abonnement. Ihre Organisation muss Microsoft Intune für die Geräteverwaltung verwenden.

Überprüfen der Vorlage

Die in dieser Schnellstartanleitung verwendete Vorlage stammt aus Azure-Schnellstartvorlagen.

Die Vorlage für diesen Artikel ist zu lang, um hier zu zeigen. Um die Vorlage anzuzeigen, siehe azuredeploy.json

In der Vorlage sind mehrere Azure-Ressourcen definiert:

Implementieren der Vorlage

  1. Wählen Sie "Cloudshell öffnen" aus dem folgenden Codeblock aus, um Azure Cloud Shell zu öffnen, und folgen Sie dann den Anweisungen, um sich bei Azure anzumelden.

    $userPrincipalName = Read-Host "Please enter user principal name e.g. alias@xxx.com"
    $resourceGroupName = Read-Host "Please enter resource group name e.g. rg-devbox-dev"
    $location = Read-Host "Please enter region name e.g. eastus"
    $templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/devbox-with-customized-image/azuredeploy.json" 
    $userPrincipalId=(Get-AzADUser -UserPrincipalName $userPrincipalName).Id
    if($userPrincipalId){
        Write-Host "Start provisioning..."
        az group create -l $location -n $resourceGroupName
        az deployment group create -g $resourceGroupName --template-uri $templateUri  --parameters userPrincipalId=$userPrincipalId
    }else {
        Write-Host "User Principal Name cannot be found."
    }
    
    Write-Host "Provisioning Completed."
    
    

    Warten Sie, bis die Aufforderung in der Konsole angezeigt wird.

  2. Wählen Sie Copy (Kopieren) im vorherigen Codeblock aus, um das PowerShell-Skript zu kopieren.

  3. Klicken Sie mit der rechten Maustaste auf den Shellkonsolenbereich, und wählen Sie Einfügen aus.

  4. Geben Sie die Werte ein.

Das Bereitstellen der Vorlage dauert etwa 30 Minuten.

Azure PowerShell wird verwendet, um die Vorlage bereitzustellen. Sie können auch das Azure-Portal und die Azure CLI verwenden. Informationen zu anderen Bereitstellungsmethoden finden Sie unter Bereitstellen von Vorlagen.

Erforderliche Parameter:

  • Benutzerprinzipal-ID: Die Benutzerprinzipal-ID des Benutzers oder der Gruppe, der die Devcenter DevCenter Dev Box-Benutzerrolle gewährt wird.
  • Benutzerprinzipaltyp: Der Typ des Benutzerprinzipals. Gültige Werte sind Benutzer oder Gruppe.
  • Speicherort: Der Speicherort, an dem die Ressourcen bereitgestellt werden. Wählen Sie einen Speicherort in der Nähe der Entwicklerfelder aus, um die Latenz zu verringern.

Alternativ können Sie zugriff auf ein Dev Box-Projekt im Azure-Portal bereitstellen. Weitere Informationen finden Sie unter Bereitstellen des Zugriffs auf Benutzerebene auf Projekte für Entwickler.

Überlegungen zum virtuellen Netzwerk

  • Sicherheit: Die Planung einer Microsoft Dev Box-Bereitstellung umfasst viele Bereiche, einschließlich der Sicherung des virtuellen Netzwerks (VNet). Weitere Informationen finden Sie in der Übersicht über die Azure-Netzwerksicherheit.

  • NIC-Ressourcengruppe: Microsoft Dev Box erstellt automatisch eine Ressourcengruppe für jede Netzwerkverbindung, die die Netzwerkschnittstellenkarten (NICs) enthält, die das virtuelle Netzwerk verwenden, das der Netzwerkverbindung zugewiesen ist. Die Ressourcengruppe hat einen festen Namen basierend auf dem Namen und der Region der Netzwerkverbindung. Sie können den Namen der Ressourcengruppe nicht ändern und keine vorhandene Ressourcengruppe angeben.

Überprüfen der bereitgestellten Ressourcen

  1. Melden Sie sich beim Azure-Portal an.

  2. Wählen Sie im linken Bereich Ressourcengruppen aus.

  3. Wählen Sie die Ressourcengruppe aus, die Sie im vorherigen Abschnitt erstellt haben.

    Screenshot der neu erstellten Ressourcengruppe

Bereinigen von Ressourcen

Wenn Sie diese Ressourcen nicht mehr benötigen, können Sie die Ressourcengruppe löschen.

Wechseln Sie zum Azure-Portal, wählen Sie die Ressourcengruppe aus, die die Ressourcen enthält, und wählen Sie dann "Löschen" aus.

Weitere Vorlagen suchen

Weitere Vorlagen für Microsoft Dev Box finden Sie unter Azure-Schnellstartvorlagen.

Sie können beispielsweise eine Vorlage verwenden, um weitere angepasste Bilder für Base, Java, .NET und Data hinzuzufügen. Diese Images haben die folgende Software und Tools installiert:

Imagetyp Software und Tools
Basis Git, Azure CLI, VS Code, VS Code Extension für GitHub Copilot
Java Git, Azure CLI, VS Code, Maven, OpenJdk11, VS Code Extension for Java Pack
.NET Git, Azure CLI, VS Code,.NET SDK, Visual Studio
Daten Git, Azure CLI, VS Code,Python 3, VS Code Extension für Python und Jupyter