Uygulama dizininizdeki kodu kullanarak uygulamanıza Azure Geliştirici CLI desteği ekleme

Azure Geliştirici CLI'sı (azd), uygulamanızla kullanılacak bir şablonu başlatmak için iki farklı iş akışı sağlar:

• Geçerli dizinde kod kullanma: Bu yaklaşım uygulamanızı analiz eder ve desteklenen altyapı ve yapılandırma kaynaklarını otomatik olarak oluşturur.
• Şablon seçin: Bu yaklaşım, mevcut bir şablonu uygulamanızla tümleştirmenize veya var olan bir şablonu yeni bir uygulama için başlangıç noktası olarak kullanmanıza olanak tanır.

Bu yaklaşımların her ikisi de Azure Geliştirici CLI şablonları oluşturma genel bakış belgesinde incelenir.

Bu makalede, Geçerli dizinde kod kullanma yaklaşımı aracılığıyla uygulamanıza Azure Geliştirici CLI'sı (azd) desteği eklemeyi öğreneceksiniz. Alternatif yaklaşım hakkında daha fazla bilgi için Mevcut bir şablon kullanarak uygulamanıza destek ekleme azd belgesini ziyaret edin. Şablon oluşturma azd hakkında daha fazla bilgi için Eğitim - oluşturma ve dağıtma azd şablonlarını da ziyaret edebilirsiniz.

Geçerli dizinde kod kullanma

1. Kendi projenizi kullanarak ilerideki adımları izleyebilirsiniz. Ancak, örnek bir uygulama kullanarak takip etmek isterseniz, aşağıdaki başlangıç deposunu bilgisayarınızdaki boş bir dizine kopyalayın:

   git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
   

2. Projenin kök dizinine bir terminal açın.

3. azd init Şablonu başlatmak için komutunu çalıştırın.

   azd init
   

4. İstendiğinde Geçerli dizinde kod kullan seçeneğini belirleyin. azd projeyi analiz eder ve algılanan hizmetlerin ve önerilen Azure barındırma kaynaklarının özetini sağlar.

5. Onayla'yı seçin ve uygulamamı başlatmaya devam edin. azd proje kök dizininde aşağıdaki varlıkları oluşturur:

   • azure.yaml Uygun hizmet tanımlarına sahip bir dosya.
   • Projeyi sağlamak ve Azure'a infra dağıtmak için kod olarak altyapı dosyalarını içeren bir klasör.
   • Bir .azure dosyada ortam değişkenlerinin ayarlandığı bir .env klasör.

   Bu algılama ve oluşturma işlemi hakkında daha fazla ayrıntı makalenin devamında verilmiştir.

6. Oluşturulan dosyalar sağlanan örnek uygulama için olduğu gibi çalışır ve kendi uygulamalarınız için de kullanılabilir. Gerekirse, oluşturulan dosyalar gereksinimlerinize uyacak şekilde değiştirilebilir. Örneğin, uygulamanız tarafından azdtanımlananların ötesinde Azure kaynakları kullanıyorsa klasöründeki infra kod olarak altyapı dosyalarını daha fazla değiştirmeniz gerekebilir.

7. azd up Uygulamanızı sağlamak ve Azure'a dağıtmak için komutunu çalıştırın.

   azd up
   

8. İstendiğinde, sağlama ve dağıtım işlemini başlatmak için istediğiniz aboneliği ve konumu seçin.

9. İşlem tamamlandığında, uygulamayı tarayıcıda açmak için çıkıştaki bağlantıya azd tıklayın.

Başlatma adımlarını keşfetme

Geçerli dizin iş akışında kod kullan'ı seçtiğinizde, azd init komut projenizi analiz eder ve keşfettiklerine göre kodu otomatik olarak oluşturur. Aşağıdaki bölümlerde bu sürecin nasıl çalıştığı ve şu anda hangi teknolojilerin desteklendiğine ilişkin ayrıntılar açıklanmaktadır.

Detection

komutu, azd init proje dizininizde ve alt dizinlerinizde bulunan desteklenen diller için proje dosyalarını algılar. azd ayrıca, uygulamanızın kullandığı web çerçeveleri veya veritabanları hakkında bilgi toplamak için paket bağımlılıklarını tarar. Gerekirse, onay özeti isteminde gösterildiği gibi algılanan bileşenleri el ile ekleyebilir veya düzenleyebilirsiniz.

Geçerli algılama mantığı aşağıdaki gibidir:

• Desteklenen diller:
  • Python
  • JavaScript/TypeScript
  • .NET
  • Java
• Desteklenen veritabanları:
  • MongoDB
  • PostgreSQL
• Python ve JavaScript/TypeScript için web çerçeveleri ve veritabanları otomatik olarak algılenir.
• JavaScript/TypeScript projesi ön uç (veya istemci tarafı) web çerçevesi kullandığında, ön uç hizmeti olarak sınıflandırılır. Hizmetiniz şu anda algılanmayan bir ön uç web çerçevesi kullanıyorsa, eşdeğer ön uç hizmet sınıflandırması ve davranışı sağlamak için JQuery'yi seçebilirsiniz.

Nesil

Algılanan bileşenleri onayladıktan sonra uygulamanızı azd init Azure'a dağıtmak için gereken kod olarak altyapı dosyalarını oluşturur.

Oluşturma mantığı aşağıdaki gibidir:

• Desteklenen konaklar:
  • Azure Container Apps.
• Veritabanları için, veritabanı teknolojisi ile kullanılan hizmet arasında desteklenen eşleme:
  • MongoDB: MongoDB için Azure CosmosDB API'si
  • PostgreSQL: PostgreSQL için Azure Veritabanı esnek sunucu
  • Redis: Azure Container Apps Redis eklentisi
• Veritabanlarını kullanan hizmetler, varsayılan olarak önceden yapılandırılmış veritabanına bağlantı sağlayan ortam değişkenlerine sahip olur.
• Hem ön uç hem de arka uç hizmetleri algılandığında, arka uç hizmetleri için Azure ana bilgisayarında CORS yapılandırması, ön uç hizmetlerinin varsayılan barındırma etki alanına izin verecek şekilde güncelleştirilir. Bu, Kod Olarak Altyapı yapılandırma dosyalarında gerektiğinde değiştirilebilir veya kaldırılabilir.

Geliştirme kapsayıcıları için destek ekleme

Ayrıca şablonunuzu geliştirme kapsayıcıları ve Codespaces ile uyumlu hale getirebilirsiniz. Geliştirme kapsayıcısı, kapsayıcıyı tam özellikli geliştirme ortamı olarak kullanmanıza olanak tanır. Bir uygulamayı çalıştırmak, bir kod tabanıyla çalışmak için gereken araçları, kitaplıkları veya çalışma zamanlarını ayırmak ve sürekli tümleştirme ve teste yardımcı olmak için kullanılabilir. Geliştirme kapsayıcıları özel veya genel bir bulutta yerel veya uzaktan çalıştırılabilir. (Kaynak: https://containers.dev/)

Geliştirme kapsayıcıları için destek eklemek için:

1. Projenizin kökünde bir .devcontainer klasörü oluşturun.

2. İstenen yapılandırmalarla klasörün içinde .devcontainer bir devcontainer.json dosya oluşturun. Başlangıç azd şablonu, projenize kopyalayabileceğiniz ve gerektiğinde değiştirebileceğiniz bir örnek devcontainer.json dosya sağlar.

Visual Studio Code belgelerinde geliştirme kapsayıcılarıyla çalışma hakkında daha fazla bilgi edinin.

CI/CD işlem hattı için destek ekleme

Aşağıdaki adımları kullanarak GitHub eylemlerini veya Azure DevOps'u kullanarak şablonunuza CI/CD desteği de ekleyebilirsiniz:

1. .github Projenizin köküne GitHub eylemleri için bir .ado klasör veya Azure DevOps klasörü ekleyin.

2. Yeni klasöre bir iş akışı dosyası ekleyin. Başlangıç şablonu, azd projenize kopyalayıp gerektiği gibi değiştirebileceğiniz her platform için bir Örnek GitHub Actions iş akışı dosyası ve Örnek Azure DevOps Pipelines dosyaları sağlar.

3. Ayrıca, klasörünüzdeki dosyayı iş akışınızın infra çalışması için gerekli ortam değişkenleriyle güncelleştirmeniz main.parameters.json gerekebilir.