Bagikan melalui

Bekerja dengan lingkungan Azure Developer CLI

Azure Developer CLI (azd) membantu Anda membuat dan mengelola Lingkungan dengan konfigurasi mereka sendiri, seperti dev, test, dan prod. Artikel ini memperlihatkan cara membuat dan mengelola lingkungan, dan cara menggunakannya dengan file infrastruktur Bicep Anda.

Membuat lingkungan

Buat lingkungan baru menggunakan azd env new perintah :

azd env new <environment-name>

Misalnya, untuk membuat lingkungan pengembangan:

azd env new dev

Saat Anda menjalankan perintah seperti azd up atau azd deploy, azd meminta Anda untuk memilih langganan dan lokasi Azure untuk lingkungan baru. Pengaturan perintah disimpan di lingkungan .env atau config.json file baru.

Anda juga dapat menentukan langganan dan lokasi langsung dalam perintah:

azd env new prod --subscription "My Production Subscription" --location eastus2

Membuat daftar lingkungan

Untuk melihat semua lingkungan yang tersedia untuk proyek Anda, gunakan:

azd env list

Perintah ini menampilkan semua lingkungan yang Anda buat, menyoroti lingkungan aktif saat ini:

NAME      DEFAULT   LOCAL     REMOTE
dev       true      true      false
test      false     true      false
prod      false     true      false

Beralih antar lingkungan

Untuk beralih ke lingkungan lain, gunakan azd env select perintah :

azd env select <environment-name>

Misalnya, untuk beralih ke lingkungan produksi:

azd env select prod

Nota

Perintah ini mengubah lingkungan aktif Anda, yang memengaruhi perintah berikutnya azd seperti provision atau deploy.

Memahami lingkungan default

File .azure/config.json konfigurasi global melacak lingkungan yang Anda pilih saat ini. Saat Anda menjalankan azd init dan belum ada lingkungan, azd secara otomatis membuat lingkungan pertama Anda dan mengaturnya sebagai default. Jika Anda sudah memiliki satu atau beberapa lingkungan dan menjalankan azd env new <name>, azd meminta Anda untuk memilih apakah akan menjadikan lingkungan baru sebagai default. Jika Anda menolak, lingkungan baru dibuat tetapi pilihan Anda saat ini tetap tidak berubah.

Anda dapat mengganti sementara lingkungan default untuk satu perintah dengan menggunakan --environment bendera . Menggunakan bendera ini tidak mengubah default untuk perintah mendatang.

Menyegarkan pengaturan lingkungan

Anda dapat me-refresh variabel lingkungan lokal Anda menggunakan azd env refresh perintah . Perintah ini menemukan penyebaran Azure terbaru untuk aplikasi Anda, mengambil nilai variabel lingkungan berdasarkan nama, lalu memperbarui file lokal .env Anda dengan nilai terbaru tersebut untuk lingkungan tertentu. Misalnya, jika Anda menyediakan dev versi dan prod , dan saat ini Anda memiliki dev lingkungan yang dipilih, ia mengambil output terbaru dari penyebaran tersebut untuk mengisi file .env.

azd env refresh

Nota

Perintah azd env refresh tidak menyebarkan ulang sumber daya. Ini hanya memperbarui konfigurasi lingkungan lokal Anda agar sesuai dengan status saat ini di Azure.

Merefresh lingkungan Anda berguna saat:

  • Anda ingin memastikan file lokal .env Anda mencerminkan output terbaru dari infrastruktur Anda (seperti string koneksi, titik akhir, dll.).
  • Anda perlu menyinkronkan variabel lingkungan setelah rekan satu tim memperbarui lingkungan.

Jika anggota tim lain membuat perubahan pada konfigurasi lingkungan, atau jika Anda membuat perubahan melalui portal Microsoft Azure, Anda dapat me-refresh pengaturan lingkungan lokal Anda dengan:

Menjalankan perintah di lingkungan tertentu

Anda dapat menjalankan banyak azd perintah di lingkungan tertentu tanpa mengubah lingkungan aktif Anda dengan menggunakan --environment bendera atau -e :

azd up --environment dev

Perintah ini menjalankan alur kerja (provisi up dan sebarkan) di dev lingkungan tanpa mengubah lingkungan aktif Anda.

Atau, Anda dapat terlebih dahulu beralih ke lingkungan yang Anda maksudkan:

azd env select test
azd up

Nota

Teams harus mempertimbangkan untuk menggunakan alur CICD melalui azd pipeline config perintah, daripada penyebaran langsung menggunakan perintah seperti azd up atau azd provision.

Menghapus sumber daya lingkungan

Untuk menghapus sumber daya Azure untuk lingkungan tertentu, gunakan azd down perintah :

azd down <environment-name>

Nota

Saat ini tidak dimungkinkan untuk menghapus atau mengganti nama azd lingkungan secara langsung menggunakan perintah. Jika Anda perlu mengganti nama lingkungan:

  • Gunakan azd down untuk menghapus sumber daya lingkungan.
  • Jalankan azd env new <new-name> untuk membuat lingkungan baru.
  • Hapus folder lama .env secara manual dari .azure.

Menggunakan nama lingkungan dalam file infrastruktur

Anda dapat menggunakan AZURE_ENV_NAME variabel dari file lingkungan .env Anda untuk menyesuaikan penyebaran infrastruktur Anda di Bicep. Ini berguna untuk penamaan, pemberian tag, atau konfigurasi sumber daya berdasarkan lingkungan saat ini.

Nota

Kunjungi variabel Bekerja dengan lingkungan untuk mempelajari selengkapnya tentang cara menggunakan variabel lingkungan untuk mengonfigurasi proyek Azure Developer CLI Anda.

  1. azd AZURE_ENV_NAME mengatur variabel lingkungan saat Anda menginisialisasi proyek.

    AZURE_ENV_NAME=dev

  2. Dalam file Anda main.parameters.json , referensikan variabel lingkungan sehingga azd menggantikan nilainya:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "environmentName": {
      "value": "${AZURE_ENV_NAME}"
    }
  }
}

    Saat Anda menyebarkan dengan azd, nilai dari .env diteruskan ke file Bicep Anda dari main.parameters.json.

  3. Di templat Bicep Anda, tentukan parameter untuk nama lingkungan:

    param environmentName string

  4. Anda dapat menggunakan environmentName parameter untuk menandai sumber daya, sehingga mudah untuk mengidentifikasi lingkungan mana yang dimiliki sumber daya:

    param environmentName string

resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
  name: 'mystorage${uniqueString(resourceGroup().id)}'
  location: resourceGroup().location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  tags: {
    Environment: environmentName
    Project: 'myproject'
  }
}

Pendekatan ini membantu manajemen sumber daya, pelacakan biaya, dan otomatisasi dengan mengaitkan setiap sumber daya dengan lingkungan penyebarannya.

Langkah selanjutnya

Mengelola variabel lingkungan di Azure Developer CLI

Mengkustomisasi alur kerja Azure Developer CLI Anda menggunakan hook

  • Last updated on