Creare e accedere a un ambiente usando l'interfaccia della riga di comando di Azure

Questo articolo illustra come creare e accedere a un ambiente in un progetto di ambienti di distribuzione di Azure esistente usando l'interfaccia della riga di comando di Azure.

Prerequisiti

Crea un ambiente

La creazione di un ambiente crea automaticamente le risorse necessarie e un gruppo di risorse per archiviarle. Il nome del gruppo di risorse segue il modello {projectName}-{environmentName}. È possibile visualizzare il gruppo di risorse nel portale di Azure.

Per creare un ambiente e configurare le risorse, completare i passaggi seguenti nella interfaccia della riga di comando di Azure. È possibile visualizzare gli output come definito nel modello di Azure Resource Manager specifico.

1. Accedere all'interfaccia della riga di comando di Azure:

   az login
   

2. Installare o aggiornare l'estensione di Azure Dev Center per l'interfaccia della riga di comando:

   az extension add --name devcenter --upgrade
   

3. Elencare tutti i progetti ambienti di distribuzione di Azure a cui si ha accesso:

   az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
   

4. Configurare la sottoscrizione predefinita come sottoscrizione che contiene il progetto:

   az account set --subscription <subscriptionName>
   

5. Configurare il gruppo di risorse predefinito come gruppo di risorse che contiene il progetto:

   az config set defaults.group=<resourceGroupName>
   

6. Elencare il tipo di ambienti che è possibile creare in un progetto specifico:

   az devcenter dev environment-type list --dev-center-name <devcenterName> --project-name <projectName> -o table
   

7. Elencare le definizioni di ambiente disponibili per un progetto specifico:

   az devcenter dev environment-definition list --dev-center-name <devcenterName> --project-name <projectName> -o table
   

8. Una definizione di ambiente è un modello di infrastruttura come codice definito nel file environment.yaml . Creare un ambiente usando una definizione di ambiente dall'elenco delle definizioni di ambiente disponibili:

   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
   

   Se la definizione di ambiente specifica* richiede parametri, usare --parameters e fornire i parametri come stringa JSON o un file JSON. Per esempio:

   $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
   az devcenter dev environment create --dev-center-name <devcenterName>
       --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
       --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
       --parameters $params
   

Risolvere un errore di autorizzazioni

È necessario avere il ruolo utente Ambienti di distribuzione , il ruolo di amministratore del progetto DevCenter o un ruolo predefinito con le autorizzazioni necessarie per creare un ambiente.

Se non si dispone delle autorizzazioni corrette, l'ambiente non viene creato. Potrebbe essere visualizzato un messaggio di errore simile all'esempio seguente:

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

Per risolvere il problema, assegnare le autorizzazioni corrette. Vedere Concedere l'accesso al team di sviluppo.

Accedere a un ambiente

Per accedere a un ambiente:

1. Elencare gli ambienti esistenti disponibili in un progetto specifico:

   az devcenter dev environment list --dev-center-name <devcenterName> --project-name <projectName>
   

2. Visualizza gli endpoint di accesso alle varie risorse come definito negli output del modello ARM.

3. Accedere alle risorse specifiche usando gli endpoint.

Distribuire un ambiente

az devcenter dev environment deploy --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Eliminare un ambiente

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Contenuti correlati

• Aggiungere e configurare un catalogo da GitHub o Azure DevOps
• Aggiungere e configurare una definizione di ambiente