Freigeben über


Erstellen und Konfigurieren eines Projekts mithilfe der Azure-Befehlszeilenschnittstelle

In diesem Schnellstarthandbuch erfahren Sie, wie Sie ein Projekt in Azure-Bereitstellungsumgebungen erstellen. 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 für die Plattform-Entwicklungsteam erstellt in der Regel Projekte und bietet Entwicklungsteams Zugriff auf die Projekte. Entwicklungsteams erstellen anschließend Umgebungen mithilfe von Umgebungsdefinitionen, stellen eine Verbindung mit einzelnen Ressourcen her und Anwendungen bereit.

Voraussetzungen

Erstellen eines Projekts

So erstellen Sie in Ihrem Dev Center ein Projekt

  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 als Standardabonnement das Abonnement, in dem sich Ihr Dev Center befindet:

    az account set --subscription <subscriptionName>
    
  4. Konfigurieren Sie als Standardressourcengruppe die Ressourcengruppe, in der sich Ihr Dev Center befindet:

    az configure --defaults group=<resourceGroupName>
    
  5. Konfigurieren Sie als Standardspeicherort den Speicherort, in dem sich Ihr Dev Center befindet. Der Speicherort des Projekts muss mit dem Speicherort des Dev Centers übereinstimmen:

    az configure --defaults location=eastus
    
  6. Rufen Sie die Dev Center-Ressourcen-ID ab:

    DEVCID=$(az devcenter admin devcenter show -n <devcenterName> --query id -o tsv)
    echo $DEVCID
    
  7. Erstellen Sie ein 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 Ihr Dev Center darstellt, Zugriff auf die Abonnements gewähren, in denen Sie die Projektumgebungstypen konfigurieren.

In diesem Schnellstart weisen Sie der systemseitig zugewiesenen verwalteten Identität die Rolle „Besitzer“ zu, die Sie zuvor in Anfügen einer systemseitig zugewiesenen verwalteten Identität konfiguriert haben.

  1. Rufen Sie die Abonnement-ID ab:

    SUBID=$(az account show --name <subscriptionName> --query id -o tsv)
    echo $SUBID
    
  2. Rufen Sie die Objekt-ID der Identität des Dev Centers mithilfe des Namens der Dev Center-Ressource ab:

    OID=$(az ad sp list --display-name <devcenterName> --query [].id -o tsv)
    echo $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. Abrufen der Rollen-ID für den Besitzer des Abonnements:

    # Remove group default scope for next command. Leave blank for group.
    az configure --defaults group=
    
    ROID=$(az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv)
    echo $ROID
    
    # Set default resource group again
    az configure --defaults group=<resourceGroupName>
    
  2. Zulässiger Umgebungstyp 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:

    az devcenter admin project-environment-type create -n <availableEnvironmentType> \
    --project <projectName> \
    --identity-type "SystemAssigned" \
    --roles "{\"${ROID}\":{}}" \
    --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 diesem Schnellstart gewähren Sie Zugriff auf Ihre eigene ID. Optional können Sie den Wert von --assignee für die folgenden Befehle durch die Objekt-ID eines anderen Mitglieds ersetzen.

  1. Rufen Sie Ihre eigene Objekt-ID ab:

    MYOID=$(az ad signed-in-user show --query id -o tsv)
    echo $MYOID
    
  2. Weisen Sie Administratorzugriff zu:

    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, die über die Deployment Environments Reader-Rolle verfügen, können ihre eigenen Umgebungen und Von anderen erstellten Umgebungen anzeigen.

Nächste Schritte

In diesem Schnellstart haben Sie ein Projekt erstellt und Ihrem Entwicklungsteam Zugriff darauf gewährt. Um zu erfahren, wie Ihre Entwicklungsteammitglieder Umgebungen erstellen können, wechseln Sie zur nächsten Schnellstartanleitung.