Skapa och konfigurera ett projekt med hjälp av Azure CLI

I den här snabbstarten skapar du ett projekt i Azure Deployment Environments. Sedan associerar du projektet med utvecklingscentret som du skapade i Skapa och konfigurera ett utvecklingscenter med hjälp av Azure CLI.

Ett plattformsutvecklingsteam skapar vanligtvis projekt och ger projektåtkomst till utvecklingsteam. Utvecklingsteam skapar sedan miljöer med hjälp av miljödefinitioner, ansluter till enskilda resurser och distribuerar program.

Förutsättningar

Kategori Krav
Prenumeration Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
behörigheter Rollbaserad åtkomstkontrollroll i Azure med behörighet att skapa och hantera resurser i prenumerationen, till exempel Deltagare eller Ägare.
Resurs - Ett utvecklingscenter.

Skapa ett projekt

Så här skapar du ett projekt i utvecklingscentret:

  1. Logga in på Azure CLI:

    az login
    
  2. Installera Azure CLI devcenter-tillägget

    az extension add --name devcenter --upgrade
    
  3. Konfigurera standardprenumerationen som den prenumeration där ditt utvecklingscenter finns:

    az account set --subscription <subscriptionName>
    
  4. Konfigurera standardresursgruppen som den resursgrupp där utvecklingscentret finns:

    az configure --defaults group=<resourceGroupName>
    
  5. Konfigurera standardplatsen som den plats där utvecklingscentret finns. Platsen för projektet måste matcha platsen för utvecklingscentret.

    az configure --defaults location=eastus
    
  6. Hämta utvecklingscentrets resurs-ID:

    $DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
    Write-Output $DEVCID
    
  7. Skapa projektet i utvecklingscentret:

    az devcenter admin project create -n <projectName> `
    --description "My first project." `
    --dev-center-id $DEVCID
    
  8. Bekräfta att projektet har skapats framgångsrikt.

    az devcenter admin project show -n <projectName>
    

Tilldela rollen Ägare till en hanterad identitet

Innan du kan skapa miljötyper måste du ge den hanterade identitet som representerar utvecklingscentret åtkomst till de prenumerationer där du konfigurerar projektmiljötyperna.

I den här snabbstarten tilldelar du rollen Ägare till den systemtilldelade hanterade identiteten som du konfigurerade tidigare: Koppla en systemtilldelad hanterad identitet.

  1. Hämta prenumerations-ID:t:

    $SUBID = az account show --name <subscriptionName> --query id -o tsv
    Write-Output $SUBID
    
  2. Hämta objekt-ID:t för dev center-identiteten med hjälp av namnet på dev center-resursen:

    $OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
    Write-Output $OID
    
  3. Tilldela ägarrollen till utvecklingscentret i prenumerationen.

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

Konfigurera ett projekt

Om du vill konfigurera ett projekt lägger du till en projektmiljötyp:

  1. Hämta roll-ID:t för prenumerationens ägare:

    # 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. Visa tillåtna miljötyper för projektet:

    az devcenter admin project-allowed-environment-type list --project <projectName> --query [].name
    
  3. Välj en miljötyp och skapa den för projektet:

    $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
    

Anmärkning

Minst en identitet (systemtilldelad eller användartilldelad) måste vara aktiverad för distributionsidentitet. Identiteten används för att utföra distribution av miljön åt utvecklaren. Dessutom bör identiteten som är kopplad till utvecklingscentret tilldelas rollen Ägare för åtkomst till distributionsprenumerationen för varje miljötyp.

Tilldela miljöåtkomst

I den här snabbstarten ger du åtkomst till ditt eget ID. Valfritt kan du ersätta värdet --assignee för följande kommandon med en annan medlems objekt-ID.

  1. Hämta ditt eget objekt-ID:

    $MYOID = az ad signed-in-user show --query id -o tsv
    Write-Output $MYOID
    
  2. Tilldela administratörsåtkomst:

    az role assignment create --assignee $MYOID `
    --role "DevCenter Project Admin" `
    --scope "/subscriptions/$SUBID"
    
  3. Du kan också tilldela rollen Utvecklingsmiljöanvändare:

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

Anmärkning

Endast användare som har användarrollen Distributionsmiljöer, rollen DevCenter-projektadministratör eller en inbyggd roll som har lämpliga behörigheter kan skapa en miljö. Användare som har rollen Läsare för distributionsmiljöer kan visa sina egna miljöer och de miljöer som skapats av andra.

Nästa steg

I den här snabbstarten skapade du ett projekt och gav projektåtkomst till utvecklingsteamet. Om du vill veta hur dina medlemmar i utvecklingsteamet kan skapa miljöer går du till nästa snabbstart: