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

Artikel
12/09/2023

Den här snabbstartsguiden visar hur du skapar 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

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

Skapa ett projekt

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

Logga in på Azure CLI:
```
az login
```

Installera Azure CLI devcenter-tillägget .

az extension add --name devcenter --upgrade

Konfigurera standardprenumerationen som den prenumeration där ditt utvecklingscenter finns:
```
az account set --subscription <subscriptionName>
```
Konfigurera standardresursgruppen som den resursgrupp där utvecklingscentret finns:
```
az configure --defaults group=<resourceGroupName>
```
Konfigurera standardplatsen som den plats där utvecklingscentret finns. Platsen för projektet måste matcha platsen för dev center:
```
az configure --defaults location=eastus
```

Hämta utvecklingscentrets resurs-ID:

DEVCID=$(az devcenter admin devcenter show -n <devcenterName> --query id -o tsv)
echo $DEVCID

Skapa projekt i dev center:

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

Bekräfta att projektet har skapats:

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.

Hämta prenumerations-ID:

SUBID=$(az account show --name <subscriptionName> --query id -o tsv)
echo $SUBID

Hämta objekt-ID:t för dev center-identiteten med namnet på dev center-resursen:

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

Tilldela rollen Ägare till utvecklingscentret för 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:

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

# 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>

Visa den tillåtna miljötypen för projektet:

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

Välj en miljötyp och skapa den för projektet:

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

Kommentar

Minst en identitet (systemtilldelad eller användartilldelad) måste vara aktiverad för distributionsidentitet. Identiteten används för att utföra miljödistributionen å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. Du kan också ersätta värdet --assignee för för följande kommandon med en annan medlems objekt-ID.

Hämta ditt eget objekt-ID:

MYOID=$(az ad signed-in-user show --query id -o tsv)
echo $MYOID

Tilldela administratörsåtkomst:

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

Du kan också tilldela rollen Dev Environment-användare:

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

Kommentar

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 Distributionsmiljöer läsare kan visa sina egna miljöer och 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 vidare till nästa snabbstart.

Skapa och komma åt en miljö med hjälp av Azure CLI

Dela via