Aracılığıyla paylaş

Azure Geliştirici CLI ortamlarıyla çalışma

Azure Geliştirici CLI'sı (azd), Geliştirme, test ve üretim gibi kendi yapılandırmalarıyla Ortamlar oluşturmanıza ve yönetmenize yardımcı olur. Bu makalede ortamların nasıl oluşturulup yönetileceğini ve bunların Bicep altyapı dosyalarınız ile nasıl kullanılacağı gösterilmektedir.

Ortamlar oluşturma

komutunu kullanarak azd env new yeni bir ortam oluşturun:

azd env new <environment-name>

Örneğin, bir geliştirme ortamı oluşturmak için:

azd env new dev

veya azd deploygibi azd up bir komut çalıştırdığınızda, azd yeni ortam için bir Azure aboneliği ve konumu seçmeniz istenir. İstem ayarları yeni ortamda .env veya config.json dosyalarda depolanır.

Aboneliği ve konumu doğrudan komutta da belirtebilirsiniz:

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

Ortamları listeleme

Projenize yönelik tüm kullanılabilir ortamları görmek için şunu kullanın:

azd env list

Bu komut, oluşturduğunuz tüm ortamları görüntüler ve geçerli etkin ortamı vurgular:

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

Ortamlar arasında geçiş yapma

Farklı bir ortama geçmek için komutunu azd env select kullanın:

azd env select <environment-name>

Örneğin, bir üretim ortamına geçmek için:

azd env select prod

Uyarı

Bu komut, veya deploygibi provision sonraki azd komutları etkileyen etkin ortamınızı değiştirir.

Varsayılan ortamı anlama

Genel yapılandırma dosyası .azure/config.json , seçili durumdaki ortamınızı izler. Çalıştırdığınızda azd init ve henüz ortam olmadığında, azd ilk ortamınızı otomatik olarak oluşturur ve varsayılan olarak ayarlar. Zaten bir veya daha fazla ortamınız varsa ve çalıştırıyorsanız azd env new <name>, azd yeni ortamın varsayılan ayar olup olmayacağını seçmenizi ister. Reddederseniz yeni ortam oluşturulur ancak geçerli seçiminiz değişmeden kalır.

bayrağını kullanarak --environment tek bir komut için varsayılan ortamı geçici olarak geçersiz kılabilirsiniz. Bu bayrağın kullanılması, gelecekteki komutlar için varsayılanı değiştirmez.

Ortam ayarlarını yenileme

komutunu kullanarak azd env refresh yerel ortam değişkenlerinizi yenileyebilirsiniz. Bu komut uygulamanız için en son Azure dağıtımını bulur, ortam değişkeni değerlerini ada göre alır ve yerel dosyanızı .env seçme ortamı için bu en son değerlerle güncelleştirir. Örneğin, hem hem devprod de sürümünü sağladıysanız ve şu anda dev ortamı seçtiyseniz, .env dosyasını doldurmak için bu dağıtımdan en son çıkışı alır.

azd env refresh

Uyarı

azd env refresh Komutu kaynakları yeniden dağıtmaz. Yalnızca yerel ortam yapılandırmanızı Azure'daki geçerli durumla eşleşecek şekilde güncelleştirir.

Ortamınızı yenilemek şu durumlarda kullanışlıdır:

  • Yerel .env dosyanızın altyapınızdan en son çıkışları (bağlantı dizeleri, uç noktalar vb.) yansıtdığından emin olmak istiyorsunuz.
  • Bir ekip arkadaşı ortamı güncelleştirdikten sonra ortam değişkenlerini eşitlemeniz gerekir.

Diğer ekip üyeleri ortam yapılandırmalarında değişiklik yaptıysa veya Azure portalı üzerinden değişiklik yaptıysanız, yerel ortam ayarlarınızı şu şekilde yenileyebilirsiniz:

Komutları belirli ortamlarda çalıştırma

veya -e bayrağını kullanarak --environment etkin ortamınızı değiştirmeden belirli bir ortamda birçok azd komut çalıştırabilirsiniz:

azd up --environment dev

Bu komut, etkin ortamınızı değiştirmeden ortamda iş akışını (sağlama ve dağıtma) dev çalıştırırup.

Alternatif olarak, önce hedeflenen ortamınıza geçebilirsiniz:

azd env select test
azd up

Uyarı

Teams, veya azd provisiongibi azd up komutları kullanarak doğrudan dağıtımlar yerine komutu aracılığıyla azd pipeline config CICD işlem hatlarını kullanmayı düşünmelidir.

Ortam kaynaklarını silme

Komutunu kullanarak azd down belirli bir ortamın Azure kaynaklarını silmek için:

azd down <environment-name>

Uyarı

Şu anda komutları kullanarak ortamları doğrudan silmek veya yeniden adlandırmak azd mümkün değildir. Bir ortamı yeniden adlandırmanız gerekiyorsa:

  • Ortam kaynaklarını silmek için kullanın azd down .
  • Yeni ortamı oluşturmak için komutunu çalıştırın azd env new <new-name> .
  • Eski .env klasörü uygulamasından .azureel ile silin.

Altyapı dosyalarında ortam adını kullanma

Bicep'teki .env altyapı dağıtımlarınızı özelleştirmek için ortamınızın dosyasındaki değişkeni kullanabilirsinizAZURE_ENV_NAME. Bu, kaynakları geçerli ortama göre adlandırmak, etiketlemek veya yapılandırmak için kullanışlıdır.

Uyarı

Azure Geliştirici CLI projelerinizi yapılandırmak için ortam değişkenlerini kullanma hakkında daha fazla bilgi edinmek için Ortam değişkenleriyle çalışma'ya bakın.

  1. azd AZURE_ENV_NAME bir projeyi başlatırken ortam değişkenini ayarlar.

    AZURE_ENV_NAME=dev

  2. Dosyanızda main.parameters.json ortam değişkenine azd başvurarak değerini değiştirin:

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

    ile azddağıttığınızda, değerinin .env değeri içinden main.parameters.jsonBicep dosyanıza geçirilir.

  3. Bicep şablonunuzda ortam adı için bir parametre tanımlayın:

    param environmentName string

  4. Parametreyi environmentName kullanarak kaynakları etiketleyebilir ve bir kaynağın hangi ortama ait olduğunu belirlemeyi kolaylaştırabilirsiniz:

    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'
  }
}

Bu yaklaşım, her kaynağı kendi dağıtım ortamıyla ilişkilendirerek kaynak yönetimi, maliyet izleme ve otomasyona yardımcı olur.

Sonraki Adımlar

Azure Geliştirici CLI'sında ortam değişkenlerini yönetme

Kancaları kullanarak Azure Geliştirici CLI iş akışlarınızı özelleştirme

  • Last updated on