Condividi tramite

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

Categoria Requisito
Installazione Estensione dell'interfaccia della riga di comando di Azure per ambienti di distribuzione di Azure.
Procedure Completamento di Creare e configurare un dev center usando l'Azure CLI.
Procedure Completamento di Creazione e configurazione di un progetto usando l'Azure CLI.
Permissions Per creare un ambiente: ruolo utente ambienti di distribuzione , ruolo di amministratore del progetto DevCenter o ruolo predefinito con autorizzazioni appropriate.

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.

Annotazioni

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

  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 <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 modello di infrastruttura come 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. 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

Annotazioni

È 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 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: 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. 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

  • Last updated on