Een project maken en configureren met behulp van de Azure CLI

Artikel
12/09/2023

Deze snelstartgids laat zien hoe u een project maakt in Azure Deployment Environments. Vervolgens koppelt u het project aan het ontwikkelaarscentrum dat u hebt gemaakt in Een ontwikkelaarscentrum maken en configureren met behulp van de Azure CLI.

Een platformengineeringsteam maakt doorgaans projecten en biedt projecttoegang tot ontwikkelteams. Ontwikkelteams maken vervolgens omgevingen met behulp van omgevingsdefinities, maken verbinding met afzonderlijke resources en implementeren van toepassingen.

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Op rollen gebaseerd toegangsbeheer van Azure met machtigingen voor het maken en beheren van resources in het abonnement, zoals Inzender of Eigenaar.

Een project maken

Ga als volgende te werk om een project te maken in uw ontwikkelaarscentrum:

Meld u aan bij de Azure CLI:
```
az login
```

Installeer de Azure CLI devcenter-extensie.

az extension add --name devcenter --upgrade

Configureer het standaardabonnement als het abonnement waarin uw ontwikkelaarscentrum zich bevindt:
```
az account set --subscription <subscriptionName>
```
Configureer de standaardresourcegroep als de resourcegroep waarin uw ontwikkelaarscentrum zich bevindt:
```
az configure --defaults group=<resourceGroupName>
```
Configureer de standaardlocatie als de locatie waar uw ontwikkelaarscentrum zich bevindt. De locatie van het project moet overeenkomen met de locatie van het ontwikkelaarscentrum:
```
az configure --defaults location=eastus
```

Resource-id van ontwikkelaarscentrum ophalen:

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

Project maken in ontwikkelaarscentrum:

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

Controleer of het project is gemaakt:

az devcenter admin project show -n <projectName>

De rol Eigenaar toewijzen aan een beheerde identiteit

Voordat u omgevingstypen kunt maken, moet u de beheerde identiteit die uw ontwikkelaarscentrum vertegenwoordigt toegang geven tot de abonnementen waarin u de projectomgevingstypen configureert.

In deze quickstart wijst u de rol Eigenaar toe aan de door het systeem toegewezen beheerde identiteit die u eerder hebt geconfigureerd: Een door het systeem toegewezen beheerde identiteit koppelen.

Abonnements-id ophalen:

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

Haal de object-id van de identiteit van het ontwikkelaarscentrum op met behulp van de naam van de resource van het ontwikkelaarscentrum:
```
OID=$(az ad sp list --display-name <devcenterName> --query [].id -o tsv)
echo $OID
```

Wijs de rol van eigenaar toe aan het ontwikkelaarscentrum voor het abonnement:

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

Een project configureren

Als u een project wilt configureren, voegt u een projectomgevingstype toe:

Haal de rol-id op voor de eigenaar van het abonnement:

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

Het toegestane omgevingstype voor het project weergeven:

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

Kies een omgevingstype en maak het voor het project:

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

Notitie

Ten minste één identiteit (door het systeem toegewezen of door de gebruiker toegewezen) moet zijn ingeschakeld voor de implementatie-id. De identiteit wordt gebruikt om de omgevingsimplementatie namens de ontwikkelaar uit te voeren. Daarnaast moet aan de identiteit die is gekoppeld aan het ontwikkelaarscentrum de rol Eigenaar worden toegewezen voor toegang tot het implementatieabonnement voor elk omgevingstype.

Omgevingstoegang toewijzen

In deze quickstart geeft u toegang tot uw eigen id. U kunt desgewenst de waarde voor de volgende opdrachten vervangen door de object-id van --assignee een ander lid.

Haal uw eigen object-id op:

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

Beheerderstoegang toewijzen:

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

U kunt desgewenst de gebruikersrol Dev Environment toewijzen:

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

Notitie

Alleen gebruikers met de gebruikersrol Implementatieomgevingen, het DevCenter-project Beheer of een ingebouwde rol met de juiste machtigingen kunnen een omgeving maken. Gebruikers met de rol Lezer voor implementatieomgevingen kunnen hun eigen omgevingen en omgevingen bekijken die door anderen zijn gemaakt.

Volgende stappen

In deze quickstart hebt u een project gemaakt en projecttoegang verleend tot uw ontwikkelteam. Als u wilt weten hoe leden van uw ontwikkelteam omgevingen kunnen maken, gaat u verder met de volgende quickstart.

Een omgeving maken en openen met behulp van de Azure CLI

Delen via