Aracılığıyla paylaş

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

  • Makale

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

Önkoşullar

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.

Dekont

Yalnızca Dağıtım Ortamları Kullanıcı rolüne, DevCenter Projesi Yönetici 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 Geliştirme Merkezi uzantısını yükleyin.

    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 <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 <devcenterName> --project-name <projectName> -o table

  8. Kullanılabilir ortam tanımları listesinden bir ortam tanımı (environment.yaml dosyasında tanımlanan kod şablonu olarak bir altyapı) 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. Örnek olarak:

    $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

Dekont

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 Projesi Yönetici 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 <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.

Ortam dağıtma

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

İlgili içerik