Condividi tramite

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

  • Articolo

Questa guida 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.

Completare i passaggi seguenti nell'interfaccia della riga di comando di Azure per creare un ambiente e configurare le risorse. È possibile visualizzare gli output come definito nel modello di Azure Resource Manager specifico.

Nota

Solo gli utenti con il ruolo utente Ambienti di distribuzione, il ruolo Di progetto DevCenter Amministrazione o un ruolo predefinito con autorizzazioni appropriate possono creare un ambiente. Gli utenti con ruolo lettore ambienti di distribuzione possono visualizzare i propri ambienti e gli ambienti creati da altri utenti.

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

    az login

  2. Installare l'estensione 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 <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 <devcenterName> --project-name <projectName> -o table

  8. Creare un ambiente usando una definizione di ambiente (un'infrastruttura come modello di codice definito nel file environment.yaml ) 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 specificare i parametri come stringa JSON o come file JSON. Ad 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

Nota

È possibile usare --help per visualizzare altri dettagli su qualsiasi comando, argomenti accettati ed esempi. Ad esempio, usare az devcenter dev environment create --help per visualizzare altri dettagli sulla creazione di un ambiente.

Risolvere un errore di autorizzazioni

È necessario avere il ruolo utente Ambienti di distribuzione, il ruolo Di progetto DevCenter Amministrazione 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: 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 <devcenterName> --project-name <projectName>

  2. Visualizzare gli endpoint di accesso a varie risorse, come definito negli output del modello di Resource Manager.

  3. Accedere alle risorse specifiche usando gli endpoint.

Distribuire un ambiente

az devcenter dev environment deploy-action --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"

Contenuto correlato