Azure Geliştirici CLI'sını kullanarak ortam oluşturma

Bu makalede Azure Geliştirici CLI'sini (AZD) yükler, uygulama altyapınızı Azure Dağıtım Ortamlarına sağlayarak yeni bir dağıtım ortamı oluşturur ve uygulama kodunuzu sağlanan dağıtım ortamına dağıtırsınız.

Azure Geliştirici CLI 'sı (AZD), uygulamanızı yerel geliştirme ortamından Azure'a almanız için gereken süreyi hızlandıran açık kaynak bir araçtır. AZD, terminalde, düzenleyicinizde veya tümleşik geliştirme ortamınızda (IDE) veya CI/CD'de (sürekli tümleştirme/sürekli dağıtım) çalışıyor olmanız fark etmeksizin iş akışınızdaki önemli aşamalara eşlenen en iyi uygulama, geliştirici dostu komutlar sağlar.

AZD'yi Azure Dağıtım Ortamları ile çalışacak şekilde ayarlamayı öğrenmek için bkz . Azure Dağıtım Ortamları ile Azure Geliştirici CLI'sini kullanma.

Önkoşullar

Şunu yapmalısınız:

• Azure Dağıtım Ortamları hakkında bilgi sahibi olun. Azure Dağıtım Ortamları nedir? ve Azure Dağıtım Ortamları için temel kavramlar konularını gözden geçirin.
• Proje, ortam türleri ve katalog ile geliştirme merkezi oluşturun ve yapılandırın. Kılavuz olarak aşağıdaki makaleyi kullanın:
  • Hızlı Başlangıç: Azure Dağıtım Ortamları için geliştirme merkezi oluşturma ve yapılandırma.
• Geliştirme merkezinize eklenmiş bir katalog.

AZD ile çalışmaya hazırlanma

AZD ile ilk kez çalışırken, tamamlamanız gereken bazı tek seferlik kurulum görevleri vardır. Bu görevler Arasında Azure Geliştirici CLI'sini yükleme, Azure hesabınızda oturum açma ve Azure Dağıtım Ortamları için AZD desteğini etkinleştirme yer alır.

Visual Studio Code için Azure Geliştirici CLI uzantısını yükleme

azd yüklediğinizde, azd araçları genel olarak değil azd kapsamına yüklenir ve azd kaldırılırsa kaldırılır. azd dosyasını Visual Studio Code'a veya komut satırından yükleyebilirsiniz.

Visual Studio Code

Visual Studio Code'da Azure Geliştirici CLI özelliklerini etkinleştirmek için Azure Geliştirici CLI uzantısı olan v0.8.0-alpha.1-beta.3173884 sürümünü yükleyin. Etkinlik çubuğunda Uzantılar simgesini seçin, Azure Geliştirici CLI'sini arayın ve yükle'yi seçin.

Azure Geliştirici CLI'sı

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Visual Studio

Visual Studio 2022 17.3 Preview 2 veya sonraki sürümlerinde azd ile tümleştirmeyi önizleme özelliği olarak etkinleştirebilirsiniz.

azd özelliğini etkinleştirmek için Araçlar>Seçenekleri>Ortam>Önizleme Özellikleri'negidin ve Azure Geliştirici CLI'sı olan azd ile tümleştirme'yi seçin.

Özellik etkinleştirildiğinde Windows, Linux veya macOS'ta tercih ettiğiniz terminalden Azure Geliştirici CLI'sini kullanabilirsiniz.

Azure Geliştirici CLI ile oturum açma

Oturum açarak Azure kaynaklarınıza erişin. Oturum açmayı başlattığınızda bir tarayıcı penceresi açılır ve Azure'da oturum açmanızı ister. Oturum açtıktan sonra terminal, Azure'da oturum açtığınızı belirten bir ileti görüntüler.

Komut paletini kullanarak AZD'de oturum açın:

Visual Studio Code

Komut paletinden verilen komutların çıkışı aşağıdaki örnekte olduğu gibi azd dev terminalinde görüntülenir:

Azure Geliştirici CLI'sı

Aşağıdaki komutu kullanarak CLI'da Azure'da oturum açın:

 azd auth login

Visual Studio

Oturum açarak Azure kaynaklarınıza erişin. Oturum açmayı başlattığınızda bir tarayıcı penceresi açılır ve Azure'da oturum açmanızı ister. Oturum açtıktan sonra terminal, Azure'da oturum açtığınızı belirten bir ileti görüntüler.

Geliştirici Komut istemini açmak için:

1. Araçlar menüsünden Terminal'i seçin.

2. Terminal penceresinde Geliştirici Komut İstemi'ni seçin.

   

Geliştirici Komut Terminali'ni kullanarak AZD'de oturum açın:

 azd auth login

ADE için AZD desteğini etkinleştirme

VEYA gibi azd upazd provisionstandart komutları kullanarak AZD'yi dağıtım ortamlarınıza kaynak sağlamak ve dağıtmak için yapılandırabilirsiniz. platform.type olarak ayarlandığındadevcenter, tüm AZD uzak ortam durumu ve sağlama, geliştirme merkezi bileşenlerini kullanır. AZD, kaynak sağlama için geliştirme merkezi kataloğunuzda tanımlanan altyapı şablonlarından birini kullanır. Bu yapılandırmada , yerel şablonlarınızdaki infra klasörü kullanılmaz.

Visual Studio Code

Azure Geliştirici CLI'sı

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

Mevcut koddan ortam oluşturma

Artık çalışmak için bir ortam oluşturmaya hazırsınız. Yerel bir klasördeki kodla başlayabilir veya var olan bir depoyu kopyalayabilirsiniz. Bu örnekte, yerel bir klasördeki kodu kullanarak bir ortam oluşturursunuz.

Yeni uygulama başlatma

Yeni bir uygulamanın başlatılması, AZD'nin uygulamanızla çalışması için gereken dosya ve klasörleri oluşturur.

AZD, ortamı tanımlamak için bir azure.yaml dosyası kullanır. azure.yaml dosyası, uygulamanın kullandığı Azure kaynaklarının uygulamalarını ve türlerini tanımlar ve açıklar. azure.yaml hakkında daha fazla bilgi edinmek için bkz . Azure Geliştirici CLI'sı azure.yaml şeması.

Visual Studio Code

1. Visual Studio Code'da uygulama kodunuzu içeren klasörü açın.

2. Komut paletini açın ve Azure Developer CLI init yazın, ardından listeden Azure Developer CLI (azd): init'i seçin.

   

3. Şablon listesinde, şablon seçmeden devam etmek için ENTER tuşuna iki kez basın.

4. AZD terminalinde Geçerli dizinde kod kullan'ı seçin.

   

5. azd init uygulama kodunuzda tanımlanan hizmetleri tanımlar ve onaylamanızı ve devam etmenizi, bir hizmeti kaldırmanızı veya hizmet eklemenizi ister. Onayla'yı seçin ve uygulamamı başlatmaya devam edin.

   

6. azd init uygulamanızı yapılandırmak için bilgi toplamaya devam eder. Bu örnek uygulama için MongoDB veritabanı örneğinizin adı ve hizmetlerin dinlediğini bağlantı noktaları istenir.

   

7. Yerel AZD ortamınız için bir ad girin.

   

8. azd init erişiminiz olan projelerin listesini görüntüler. Ortamınız için projeyi seçin

   

9. azd init projedeki ortam tanımlarının listesini görüntüler. Bir ortam tanımı seçin.

   

   AZD, projenizin kökünde bir azure.yaml dosyası da dahil olmak üzere proje kaynaklarını oluşturur.

Azure Geliştirici CLI'sı

1. CLI'da, uygulama kodunuzu içeren klasöre gidin.

2. Uygulamanızı başlatmak ve istendiğinde bilgi sağlamak için aşağıdaki komutu çalıştırın:

   azd init
   

3. AZD terminalinde Geçerli dizinde kod kullan'ı seçin.

   

   AZD, oluşturduğunuz uygulamanın türüne bağlı olarak geçerli dizini tarar ve daha fazla bilgi toplar. AZD ortamınızı yapılandırmak için istemleri izleyin.

4. azd init uygulama kodunuzda tanımlanan hizmetleri tanımlar ve onaylamanızı ve devam etmenizi, bir hizmeti kaldırmanızı veya hizmet eklemenizi ister. Onayla'yı seçin ve uygulamamı başlatmaya devam edin.

   

5. azd init uygulamanızı yapılandırmak için bilgi toplamaya devam eder. Bu örnek uygulama için MongoDB veritabanı örneğinizin adı ve hizmetlerin dinlediğini bağlantı noktaları istenir.

   

6. Yerel AZD ortamınız için bir ad girin.

   

7. azd init erişiminiz olan projelerin listesini görüntüler. Ortamınız için projeyi seçin.

   

8. azd init projedeki ortam tanımlarının listesini görüntüler. Bir ortam tanımı seçin.

   

   AZD, projenizin kökünde bir azure.yaml dosyası da dahil olmak üzere proje kaynaklarını oluşturur.

Visual Studio

1. CLI'da, uygulama kodunuzu içeren klasöre gidin.

2. Uygulamanızı başlatmak ve istendiğinde bilgi sağlamak için aşağıdaki komutu çalıştırın:

   azd init
   

3. AZD terminalinde Geçerli dizinde kod kullan'ı seçin.

   

   AZD, oluşturduğunuz uygulamanın türüne bağlı olarak geçerli dizini tarar ve daha fazla bilgi toplar. AZD ortamınızı yapılandırmak için istemleri izleyin.

4. azd init uygulama kodunuzda tanımlanan hizmetleri tanımlar ve onaylamanızı ve devam etmenizi, bir hizmeti kaldırmanızı veya hizmet eklemenizi ister. Onayla'yı seçin ve uygulamamı başlatmaya devam edin.

   

5. azd init uygulamanızı yapılandırmak için bilgi toplamaya devam eder. Bu örnek uygulama için MongoDB veritabanı örneğinizin adı ve hizmetlerin dinlediğini bağlantı noktaları istenir.

   

6. Yerel AZD ortamınız için bir ad girin.

   

7. azd init erişiminiz olan projelerin listesini görüntüler. Ortamınız için projeyi seçin.

   

8. azd init projedeki ortam tanımlarının listesini görüntüler. Bir ortam tanımı seçin.

   AZD, projenizin kökünde bir azure.yaml dosyası da dahil olmak üzere proje kaynaklarını oluşturur.

Azure Dağıtım Ortamı'na altyapı sağlama

Hazır olduğunuzda yerel ortamınızı Azure'daki uzak bir Azure Dağıtım Ortamları ortamına sağlayabilirsiniz. Bu işlem, geliştirme merkezi kataloğunuzda ortam tanımında tanımlanan altyapıyı ve kaynakları sağlar.

Visual Studio Code

1. Gezgin'de azure.yaml dosyasına sağ tıklayın ve ardından Azure Geliştirici CLI (azd)>Azure Kaynakları Sağlama (sağlama) öğesini seçin.

   

2. AZD, erişiminiz olan projeler için Azure Dağıtım Ortamlarını tarar. AZD terminalinde aşağıdaki bilgileri seçin veya girin:

   1. Project
   2. Ortam tanımı
   3. Ortam türü
   4. Konum

3. AZD, ADE'ye önceki adımda vermiş olduğunuz bilgilere göre yeni bir ortam oluşturma talimatını verdi.

4. Oluşturulan kaynakları Azure portalında veya geliştirici portalında görüntüleyebilirsiniz.

Azure Geliştirici CLI'sı

Aşağıdaki komutu kullanarak uygulamanızı Azure'a sağlayın:

azd provision

1. 'azd provision', erişiminiz olan projelerin listesini sağlar. Uygulamanızı sağlamak istediğiniz projeyi seçin.

   

2. 'azd provision' seçili projedeki ortam tanımlarının listesini sağlar. Uygulamanızı sağlamak için kullanmak istediğiniz ortam tanımını seçin.

   

3. 'azd provision' seçili projedeki ortam türlerinin listesini sağlar. Uygulamanızı sağlamak için kullanmak istediğiniz ortam türünü seçin.

   

4. AZD, ADE'ye önceki adımda vermiş olduğunuz bilgilere göre yeni bir ortam oluşturma talimatını verdi.

   

5. Oluşturulan kaynakları Azure portalında veya geliştirici portalında görüntüleyebilirsiniz.

Visual Studio

Aşağıdaki komutu kullanarak uygulamanızı Azure'a sağlayın:

azd provision

1. 'azd provision', erişiminiz olan projelerin listesini sağlar. Uygulamanızı sağlamak istediğiniz projeyi seçin.

   

2. 'azd provision' seçili projedeki ortam tanımlarının listesini sağlar. Uygulamanızı sağlamak için kullanmak istediğiniz ortam tanımını seçin.

   

3. 'azd provision' seçili projedeki ortam türlerinin listesini sağlar. Uygulamanızı sağlamak için kullanmak istediğiniz ortam türünü seçin.

4. AZD, ADE'ye önceki adımda vermiş olduğunuz bilgilere göre yeni bir ortam oluşturma talimatını verdi.

5. Oluşturulan kaynakları Azure portalında veya geliştirici portalında görüntüleyebilirsiniz.

Mevcut ortamları listeleme (isteğe bağlı)

Mevcut ortamları listeleyerek ortamınızın oluşturulduğunu doğrulayın.

Visual Studio Code

1. Gezgin'de azure.yaml dosyasına sağ tıklayın ve ardından Azure Geliştirici CLI'sı (azd)>Yerel ve Uzak Ortamları Görüntüle (env listesi)'i seçin.

   

   Proje ve ortam tanımı seçmeniz istenir.

Azure Geliştirici CLI'sı

Erişiminiz olan ortamları görüntülemek için aşağıdaki komutu kullanın: yerel AZD ortamı ve uzak Azure Dağıtım Ortamları ortamı.

azd env list

azd env list bir proje ve ortam tanımı seçmenizi ister.

Visual Studio

Erişiminiz olan ortamları görüntülemek için aşağıdaki komutu kullanın: yerel AZD ortamı ve uzak Azure Dağıtım Ortamları ortamı.

azd env list

azd env list bir proje ve ortam tanımı seçmenizi ister.

Azure Dağıtım Ortamlarına kod dağıtma

Ortamınız sağlandığında, kodunuzu ortama dağıtabilirsiniz.

Visual Studio Code

1. Gezgin'de azure.yaml dosyasına sağ tıklayın ve ardından Azure Geliştirici CLI 'sı (azd)>Azure Kaynaklarını Dağıt (dağıt)'ı seçin.

   

2. AZD terminalinde listelenen bitiş noktası URL'lerini seçerek kodunuzun dağıtıldığını doğrulayabilirsiniz.

Azure Geliştirici CLI'sı

Uygulama kodunuzu aşağıdaki komutu kullanarak sağladığınız uzak Azure Dağıtım Ortamları ortamına dağıtın:

azd deploy

Kodunuzu uzak ortama dağıtmak birkaç dakika sürebilir.

Dağıtımın ilerleme durumunu Azure portalında görüntüleyebilirsiniz:

Dağıtım tamamlandığında Azure portalında sağlanan kaynakları görüntüleyebilirsiniz:

AZD terminalinde listelenen bitiş noktası URL'lerini seçerek kodunuzun dağıtıldığını doğrulayabilirsiniz.

Bu örnek uygulama için aşağıdakine benzer bir şey görürsünüz:

Visual Studio

Uygulama kodunuzu aşağıdaki komutu kullanarak sağladığınız uzak Azure Dağıtım Ortamları ortamına dağıtın:

azd deploy

Kodunuzu uzak ortama dağıtmak birkaç dakika sürebilir.

Dağıtımın ilerleme durumunu Azure portalında görüntüleyebilirsiniz:

Dağıtım tamamlandığında Azure portalında sağlanan kaynakları görüntüleyebilirsiniz:

AZD terminalinde listelenen bitiş noktası URL'lerini seçerek kodunuzun dağıtıldığını doğrulayabilirsiniz.

Kaynakları temizleme

Ortamınızla işiniz bittiğinde Azure kaynaklarını silebilirsiniz.

Visual Studio Code

Gezgin'de azure.yaml dosyasına sağ tıklayın ve ardından Azure Geliştirici CLI 'sı (azd)>Dağıtımı ve Kaynakları Sil (aşağı) öğesini seçin.

İstendiğinde girerek y ortamı silmek istediğinizi onaylayın.

Azure Geliştirici CLI'sı

Aşağıdaki komutu kullanarak Azure kaynaklarınızı silin:

azd down --environment <environmentName>

Visual Studio

Aşağıdaki komutu kullanarak Azure kaynaklarınızı silin:

azd down --environment <environmentName>

İlgili içerik

• Geliştirme merkezi oluşturma ve yapılandırma
• Azure Geliştirici CLI'sı nedir?
• Azure Geliştirici CLI'sını yükleme veya güncelleştirme