Azure CLI kullanarak ortam oluşturma ve ortama erişme

Bu makalede, Azure CLI kullanarak mevcut bir Azure Dağıtım Ortamları projesinde ortam oluşturma ve bunlara erişme açıklanmaktadır.

Önkoşullar

Kategori Gereksinim
Kurulum Azure Dağıtım Ortamları için Azure CLI uzantısı.
Prosedür Azure CLI kullanarak geliştirme merkezi oluşturma ve yapılandırma işleminin tamamlanması.
Prosedür Azure CLI kullanarak proje oluşturma ve yapılandırma işleminin tamamlanması.
İzinler Ortam oluşturmak için: Dağıtım Ortamları Kullanıcı rolü, DevCenter Proje Yöneticisi rolü veya uygun izinlere sahip yerleşik bir rol.

Ortam oluşturun

Ortam oluşturmak, bunları depolamak için gerekli kaynakları ve kaynak grubunu otomatik olarak oluşturur. Kaynak grubu adı desenini {projectName}-{environmentName}izler. Kaynak grubunu Azure portalında görüntüleyebilirsiniz.

Ortam oluşturmak ve kaynakları yapılandırmak için Azure CLI'da aşağıdaki adımları tamamlayın. Çıktıları belirli Azure Resource Manager şablonunda (ARM şablonu) tanımlandığı gibi görüntüleyebilirsiniz.

Uyarı

Yalnızca Dağıtım Ortamları Kullanıcı rolüne, DevCenter Proje Yöneticisi rolüne veya uygun izinlere sahip yerleşik bir role sahip kullanıcılar ortam oluşturabilir. Dağıtım Ortamları Okuyucusu rolüne sahip kullanıcılar kendi ortamlarını ve başkaları tarafından oluşturulan ortamları görüntüleyebilir.

  1. Azure CLI'da oturum açın:

    az login
    
  2. CLI için Azure Dev Center uzantısını yükleyin veya yükseltin:

    az extension add --name devcenter --upgrade
    
  3. Erişiminiz olan tüm Azure Dağıtım Ortamları projelerini listeleyin:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
    
  4. Varsayılan aboneliği projeyi içeren abonelik olarak yapılandırın:

    az account set --subscription <subscriptionName>
    
  5. Varsayılan kaynak grubunu projeyi içeren kaynak grubu olarak yapılandırın:

    az config set defaults.group=<resourceGroupName>
    
  6. Belirli bir projede oluşturabileceğiniz ortamların türünü listeleyin:

    az devcenter dev environment-type list --dev-center-name <devcenterName> --project-name <projectName> -o table
    
  7. Belirli bir proje için kullanılabilen ortam tanımlarını listeleyin:

    az devcenter dev environment-definition list --dev-center-name <devcenterName> --project-name <projectName> -o table
    
  8. Kullanılabilir ortam tanımları listesinden bir ortam tanımı ( environment.yaml dosyasında tanımlanan kod olarak altyapı şablonu) kullanarak ortam oluşturun:

    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>
    

    Belirli bir ortam tanımı herhangi bir parametre gerektiriyorsa, kullanın --parameters ve parametreleri JSON dizesi veya JSON dosyası olarak sağlayın. Örneğin:

    $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
    

Uyarı

Herhangi bir komut, kabul edilen bağımsız değişkenler ve örnekler hakkında daha fazla ayrıntı görüntülemek için kullanabilirsiniz --help . Örneğin, ortam oluşturma hakkında daha fazla ayrıntı görüntülemek için kullanın az devcenter dev environment create --help .

İzin hatasıyla ilgili sorunları giderme

Dağıtım Ortamları Kullanıcı rolüne, DevCenter Proje Yöneticisi rolüne veya ortam oluşturmak için gerekli izinlere sahip yerleşik bir role sahip olmanız gerekir.

Doğru izinlere sahip değilseniz ortam oluşturulmaz. Aşağıdaki örneğe benzer bir hata iletisi görüntülenebilir:

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

Sorunu çözmek için doğru izinleri atayın: Geliştirme ekibine erişim verin.

Bir ortama erişme

Bir ortama erişmek için:

  1. Belirli bir projede kullanılabilen mevcut ortamları listeleyin:

     az devcenter dev environment list --dev-center-name <devcenterName> --project-name <projectName>
    
  2. ARM şablonu çıkışlarında tanımlandığı gibi çeşitli kaynaklara erişim uç noktalarını görüntüleyin.

  3. Uç noktaları kullanarak belirli kaynaklara erişin.

Bir ortam dağıt

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

Ortamı silme

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