Bagikan melalui


Membuat dan mengakses lingkungan dengan menggunakan Azure CLI

Artikel ini menjelaskan cara membuat dan mengakses lingkungan dalam proyek Lingkungan Penyebaran Azure yang ada dengan menggunakan Azure CLI.

Prasyarat

Kategori Persyaratan
Instalasi Ekstensi Azure CLI untuk Lingkungan Penyebaran Azure.
Prosedur Penyelesaian Membuat dan mengonfigurasi pusat pengembangan dengan menggunakan Azure CLI.
Prosedur Penyelesaian Membuat dan mengonfigurasi proyek dengan menggunakan Azure CLI.
Hak akses Untuk membuat lingkungan: Peran Pengguna Lingkungan Penyebaran , peran Admin Proyek DevCenter , atau peran bawaan yang memiliki izin yang sesuai.

Membuat lingkungan

Membuat lingkungan secara otomatis membuat sumber daya yang diperlukan dan grup sumber daya untuk menyimpannya. Nama grup sumber daya mengikuti pola {projectName}-{environmentName}. Anda dapat melihat grup sumber daya di portal Azure.

Selesaikan langkah-langkah berikut di Azure CLI untuk membuat lingkungan dan mengonfigurasi sumber daya. Anda dapat melihat output seperti yang didefinisikan dalam templat Azure Resource Manager tertentu (templat ARM).

Nota

Hanya pengguna yang memiliki peran Pengguna Lingkungan Penyebaran, peran Admin Proyek DevCenter, atau peran bawaan yang memiliki izin yang sesuai yang dapat membuat lingkungan. Pengguna yang memiliki peran Pembaca Lingkungan Penyebaran dapat melihat lingkungan mereka sendiri dan lingkungan yang dibuat oleh orang lain.

  1. Masuk ke Azure CLI:

    az login
    
  2. Instal atau tingkatkan ekstensi Azure Dev Center untuk CLI:

    az extension add --name devcenter --upgrade
    
  3. Cantumkan semua proyek Lingkungan Penyebaran Azure yang dapat Anda akses:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table
    
  4. Konfigurasikan langganan default sebagai langganan yang berisi proyek:

    az account set --subscription <subscriptionName>
    
  5. Konfigurasikan grup sumber daya default sebagai grup sumber daya yang berisi proyek:

    az config set defaults.group=<resourceGroupName>
    
  6. Cantumkan jenis lingkungan yang dapat Anda buat dalam proyek tertentu:

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table
    
  7. Cantumkan definisi lingkungan yang tersedia untuk proyek tertentu:

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table
    
  8. Buat lingkungan dengan menggunakan definisi lingkungan (templat infrastruktur sebagai kode yang ditentukan dalam file environment.yaml ) dari daftar definisi lingkungan yang tersedia:

    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>
    

    Jika definisi lingkungan tertentu memerlukan parameter apa pun, gunakan --parameters dan berikan parameter sebagai string JSON atau file JSON. Contohnya:

    $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

Anda dapat menggunakan --help untuk melihat detail selengkapnya tentang perintah apa pun, argumen yang diterima, dan contoh. Misalnya, gunakan az devcenter dev environment create --help untuk melihat detail selengkapnya tentang membuat lingkungan.

Memecahkan masalah kesalahan izin

Anda harus memiliki peran Pengguna Lingkungan Penyebaran , peran Admin Proyek DevCenter , atau peran bawaan yang memiliki izin yang diperlukan untuk membuat lingkungan.

Jika Anda tidak memiliki izin yang sesuai, lingkungan tidak akan dibuat. Pesan kesalahan seperti contoh berikut mungkin muncul:

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

Untuk mengatasi masalah ini, tetapkan izin yang benar: Berikan akses ke tim pengembangan.

Mengakses lingkungan

Untuk mengakses lingkungan:

  1. Cantumkan lingkungan yang ada yang tersedia dalam proyek tertentu:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>
    
  2. Lihat titik akhir akses ke berbagai sumber daya seperti yang didefinisikan dalam output templat ARM.

  3. Akses sumber daya tertentu dengan menggunakan endpoint.

Mengonfigurasi lingkungan

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

Menghapus lingkungan

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