Azure Geliştirici CLI ortamları genel bakış

Azure Geliştirici CLI'sı (azd), yapılandırmaları geliştirme, test ve üretim için ayrı tutmak amacıyla projeleriniz için birden çok dağıtım ortamı yönetmenize olanak tanır. Bu makalede, geliştirme ve dağıtım sürecinizi yönetmek için ortamları nasıl kullanabileceğinizle ilgili temel kavramlar açıklanmaktadır.

Ortamlar nedir?

Azure Geliştirici CLI'sindeki (azd) ortam, uygulamanızın dağıtımı için geliştirme, test veya üretim gibi adlandırılmış bir yapılandırma kümesidir. Farklı ortamlar farklı değerlerle yapılandırılabilir. Ortamlar birkaç önemli amaca hizmet eder:

• Yalıtım: Geliştirme, test ve üretim dağıtımlarını ayrı tutun.
• Yapılandırma yönetimi: Her ortam için farklı ayarları koruyun.
• İşbirliği: Ekip üyelerinin kendi ortamlarıyla çalışmasını sağlayın.
• Kaynak düzenleme: Azure kaynaklarını ortama göre gruplandırma ve sağlama.
• Yeniden üretilebilirlik: Farklı aşamalarda tutarlı dağıtımlar olduğundan emin olun.

Her ortamın kendi Azure kaynak grubu ve yapılandırma ayarları vardır. Bu ortam yalıtımı, bir ortamdaki değişikliklerin diğerlerini etkilemesini önlemeye yardımcı olur.

Ortam yapısı ve yapılandırması

Azure Geliştirici CLI (azd) ortamları projenizin içindeki bir dizin yapısında yer almaktadır:

├── .azure                          [Created when you run azd init or azd up]
│   ├── <environment-name-1>        [Directory for environment-specific configurations]
│   │   ├── .env                    [Environment variables for this environment]
│   │   └── config.json             [Additional configuration parameters for this environment]
│   ├── <environment-name-2>        [Another environment]
│   │   ├── .env                    
│   │   └── config.json
│   └── config.json                 [Global azd configuration]

Bu yapının temel bileşenleri şunlardır:

• .azure directory: Tüm ortam yapılandırmaları için kök dizin. Varsayılan olarak dosya tarafından .gitignore kaynak denetiminden dışlanır.
• Ortama özgü dizinler: Ortamlarınızın adını taşıyan dizinler, örneğindev, , testprod.
• .env file: Uygulamanız tarafından ve dağıtım sırasında kullanılan ortama özgü değişkenleri içerir.
• config.json: Komut davranışını ve özelliklerini etkileyen azd ayarları yönlendirmek için kullanılır. Bu dosyanın doğrudan son kullanıcılar tarafından kullanılması amaçlanmamıştır.

Ortam adları

Ortam adlandırma genellikle şu desenleri izler:

• Takım projeleri: <project-name-[dev/int/prod]>
• Kişisel projeler: <personal-unique-alias-[dev/int/prod]>

Bu adlandırma kuralları tarafından azd zorunlu tutulmaz ve kullanıcı tarafından yapılandırılabilir.

Ortam değişkenleri

Azure Geliştirici CLI Ortamı değişkenleri, ortamları etkileyen ve ortamlar arasında farklılık gösterebilen yapılandırma ayarlarını depolamak için bir yol sağlar. Azure Geliştirici CLI komutlarını çalıştırdığınızda, bu değişkenler şunları yapmak için kullanılır:

• Azure hizmetlerinin uç noktaları gibi uygulama ayarlarınızı yapılandırın.
• Sağlama işlemini etkilemek için altyapı parametrelerini tanımlayın.

Dosya şu .env değişkenleri standart biçimde içerir:

AZURE_ENV_NAME=dev
AZURE_LOCATION=eastus
AZURE_SUBSCRIPTION_ID=00000000-0000-0000-0000-000000000000
AZURE_RESOURCE_GROUP=rg-dev-12345
SERVICE_WEB_HOSTNAME=web-dev-12345.azurewebsites.net
SERVICE_API_HOSTNAME=api-dev-12345.azurewebsites.net

Yaygın ortam değişkenleri şunlardır:

Değişken	Açıklama
AZURE_ENV_NAME	Geçerli ortamın adı
AZURE_LOCATION	Kaynakların dağıtıldığı Azure bölgesi
AZURE_SUBSCRIPTION_ID	Bu ortam için kullanılan Azure aboneliğinin kimliği
AZURE_RESOURCE_GROUP	Bu ortam için kaynak grubunun adı

İpucu

Diğer yaygın ortam değişkenleri ve hizmete özgü örnekler için Ortam değişkenleri belgelerini ziyaret edin.

Ortam değişkenleriyle çalışırken:

• Dosyaları kaynak denetimine kaydetmekten .env kaçının. Ortam yapılandırmasının kalıcı olması veya paylaşılması gerekiyorsa, kullanıcılar Uzak ortamları kullanmalıdır.
• Ortamlar arasında tutarlı adlandırma kullanın.
• azd env set Değişkenleri güvenli bir şekilde güncelleştirmek için komutunu kullanın.

Uyarı

Gizli dizileri hiçbir zaman bir Azure Geliştirici CLI .env dosyasında depolamayın. Bu dosyalar kolayca paylaşılabilir veya yetkisiz konumlara kopyalanabilir ya da kaynak denetimine iade edilebilir. Korumalı veya gizli olmayan çözümler için Azure Key Vault veya Azure Rol Tabanlı Erişim Denetimi (RBAC) gibi hizmetleri kullanın.

Diğer çerçeve ortamlarını karşılaştırma

yapılandırma için Node.js, Django veya React gibi birçok programlama çerçevesi ve aracı kullanma .env dosyaları. Azure Geliştirici CLI'sı (azd) dosyaları da kullansa .env da önemli farklılıklar vardır:

Konsept	Azure Geliştirici CLI'sı .env	Çerçeve .env Dosyaları
Location	.azure/<environment-name>/.env'de depolanır	Genellikle proje kök dizininde depolanır
Ortam Desteği	Kullanıcı tanımlı birden çok ortam için destek (geliştirme, test, üretim)	Genellikle el ile dosya değiştirme veya adlandırma kuralları gerektirir (.env.development, .env.production)
Yükleme Mekanizması	Komutlar tarafından azd otomatik olarak yüklenir	Genellikle uygulama kodunda veya derleme betiklerinde açık yükleme gerektirir
Entegrasyon	Azure hizmetleri ve kaynak sağlama ile derinlemesine tümleşik	Azure'a özgü değil genel amaçlı yapılandırma
Değişken Yönetimi	Komutlar aracılığıyla azd env yönetilir	Genellikle el ile veya özel betikler aracılığıyla düzenlenir

Her ikisi de benzer amaçlara hizmet etse de Azure Geliştirici CLI'sı .env yaklaşımı, birden çok dağıtım ortamı ve Azure kaynağını yönetmek için tasarlanmış yapı ve araçlar ekler.

Uyarı

Projeniz çerçeveye özgü .env dosyaları zaten kullanıyorsa, her iki yapılandırma sistemini de çakışma olmadan tutabilirsiniz. azd ortam değişkenleri, bazı işlemler için aynı adlı sistem ortamı değişkenlerini geçersiz kılar.

Sonraki Adımlar

Ortamlarla çalışma

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