Erstellen und Konfigurieren eines Projekts mithilfe der Azure CLI

In dieser Schnellstartanleitung erstellen Sie ein Projekt in Azure-Bereitstellungsumgebungen. Anschließend ordnen Sie das Projekt dem Dev Center zu, das Sie im Erstellen und Konfigurieren eines Dev Centers mithilfe der Azure CLI erstellt und konfiguriert haben.

Ein Plattform-Engineering-Team erstellt in der Regel Projekte und bietet Projektzugriff auf Entwicklungsteams. Entwicklungsteams erstellen anschließend Umgebungen mithilfe von Umgebungsdefinitionen, stellen eine Verbindung mit einzelnen Ressourcen her und Anwendungen bereit.

Voraussetzungen

Kategorie	Anforderung
Abonnement	Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Berechtigungen	Eine Azure RBAC-Rolle mit Berechtigungen zum Erstellen und Verwalten von Ressourcen im Abonnement, z. B. Mitwirkender oder Besitzer
Ressource	– Ein Dev Center.

Erstellen eines Projekts

So erstellen Sie ein Projekt in Ihrem Dev Center:

1. Melden Sie sich bei der Azure CLI an:

   az login
   

2. Installieren Sie die Azure CLI Devcenter-Erweiterung :

   az extension add --name devcenter --upgrade
   

3. Konfigurieren Sie das Standardabonnement als Abonnement, in dem sich Ihr Dev Center befindet:

   az account set --subscription <subscriptionName>
   

4. Konfigurieren Sie die Standardressourcengruppe als Ressourcengruppe, in der sich Ihr Dev Center befindet:

   az configure --defaults group=<resourceGroupName>
   

5. Konfigurieren Sie den Standardspeicherort als Speicherort, an dem sich Ihr Dev Center befindet. Der Speicherort des Projekts muss mit dem Speicherort des Dev Centers übereinstimmen.

   az configure --defaults location=eastus
   

6. Abrufen der Dev Center-Ressourcen-ID:

   $DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
   Write-Output $DEVCID
   

7. Erstellen Sie das Projekt im Dev Center:

   az devcenter admin project create -n <projectName> `
   --description "My first project." `
   --dev-center-id $DEVCID
   

8. Vergewissern Sie sich, dass das Projekt erfolgreich erstellt wurde:

   az devcenter admin project show -n <projectName>
   

Zuweisen der Rolle „Besitzer“ zu einer verwalteten Identität

Bevor Sie Umgebungstypen erstellen können, müssen Sie der verwalteten Identität, die Ihren Dev Center repräsentiert, Zugriff auf die Abonnements gewähren, in denen Sie die Projektumgebungstypen konfigurieren.

In dieser Schnellstartanleitung weisen Sie die Rolle "Besitzer" der zuvor konfigurierten verwalteten Identität des Systems zu: Anfügen einer vom System zugewiesenen verwalteten Identität.

1. Abrufen der Abonnement-ID:

   $SUBID = az account show --name <subscriptionName> --query id -o tsv
   Write-Output $SUBID
   

2. Rufen Sie die Objekt-ID der Dev Center-Identität mithilfe des Namens der Dev Center-Ressource ab:

   $OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
   Write-Output $OID
   

3. Weisen Sie die Rolle des Besitzers dem Dev Center im Abonnement zu:

   az role assignment create --assignee $OID `
   --role "Owner" `
   --scope "/subscriptions/$SUBID"
   

Konfigurieren eines Projekts

Fügen Sie zum Konfigurieren eines Projekts einen Projektumgebungstyp hinzu:

1. Rufen Sie die Rollen-ID für die Person im Besitz des Abonnements ab:

   # Remove the group default scope for next the command. 
   az configure --defaults group=
   
   $ROID = az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv
   Write-Output $ROID
   
   # Set the default resource group again.
   az configure --defaults group=<resourceGroupName>
   

2. Zulässige Umgebungstypen für das Projekt anzeigen:

   az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name
   

3. Wählen Sie einen Umgebungstyp aus, und erstellen Sie ihn für das Projekt:

   $roles = "{`"$($ROID)`":{}}"
   az devcenter admin project-environment-type create `
       -n <availableEnvironmentType> `
       --project <projectName> `
       --identity-type "SystemAssigned" `
       --roles $roles `
       --deployment-target-id "/subscriptions/$SUBID" `
       --status Enabled
   

Hinweis

Mindestens eine (system- oder benutzerseitig zugewiesene) Identität muss für die Bereitstellungsidentität aktiviert sein. Sie wird verwendet, um die Umgebungsbereitstellung im Auftrag des Entwicklers durchzuführen. Der an das Dev Center angefügten Identität muss für den Zugriff auf das Bereitstellungsabonnement für jeden Umgebungstyp die Rolle „Besitzer“ zugewiesen werden.

Zuweisen des Umgebungszugriffs

In dieser Schnellstartanleitung gewähren Sie Zugriff auf Ihre eigene ID. Optional können Sie den Wert --assignee für die folgenden Befehle durch die Objekt-ID eines anderen Elements ersetzen.

1. Die eigene Objekt-ID abrufen.

   $MYOID = az ad signed-in-user show --query id -o tsv
   Write-Output $MYOID
   

2. Administratorzugriff zuweisen:

   az role assignment create --assignee $MYOID `
   --role "DevCenter Project Admin" `
   --scope "/subscriptions/$SUBID"
   

3. Optional können Sie die Rolle "Dev Environment-Benutzer" zuweisen:

   az role assignment create --assignee $MYOID `
   --role "Deployment Environments User" `
   --scope "/subscriptions/$SUBID"
   

Hinweis

Nur Benutzer, die über die Rolle Deployment Environments User-Rolle, die DevCenter Project Admin-Rolle oder eine integrierte Rolle verfügen, die über entsprechende Berechtigungen verfügt, können eine Umgebung erstellen. Benutzer mit der Rolle "Deployment Environments Reader " können ihre eigenen Umgebungen und Umgebungen anzeigen, die von anderen Benutzern erstellt wurden.

Nächster Schritt

In dieser Schnellstartanleitung haben Sie ein Projekt erstellt und Ihrem Entwicklungsteam Zugriff gewährt. Wenn Sie erfahren möchten, wie Ihre Entwicklungsteammitglieder Umgebungen erstellen können, gehen Sie zur nächsten Schnellstartanleitung:

Erstellen einer Umgebung und Zugreifen darauf mithilfe der Azure-Befehlszeilenschnittstelle