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

Azure Geliştirici CLI'sı (azd), uygulamanızla birlikte 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, azd yaklaşımı aracılığıyla uygulamanıza Azure Geliştirici CLI'sı () desteği eklemeyi öğreneceksiniz. Alternatif yaklaşımla ilgili daha fazla bilgi için mevcut bir şablonu kullanarak uygulamanıza destek ekleme azd belgesine göz atın. Şablon oluşturma azd hakkında daha fazla bilgi için 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. azdprojeyi 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.
   • infra Proje için kaynak sağlamaya ve projeyi Azure'a dağıtmaya yönelik 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, sunulan örnek uygulama için olduğu gibi çalışır ve kendi uygulamalarınız için de çalışabilir. Gerekirse, oluşturulan dosyalar gereksinimlerinize uyacak şekilde değiştirilebilir. Örneğin, uygulamanız infra tarafından belirlenenlerin ötesindeki Azure kaynaklarına dayanıyorsa, azd klasöründeki kod olarak altyapı dosyalarını daha fazla değiştirmeniz gerekebilir.

7. Uygulamanızı hazırlamak ve Azure'a dağıtmak için azd up 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.

Algılama

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ılar.
• 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.

Generation

Algılanan bileşenleri onayladıktan sonra azd init, uygulamanızı Azure’a dağıtmak için gereken altyapı-kod 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 Veri Tabanı esnek sunucu
  • Redis: Azure Container Apps için 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 konağındaki 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, devcontainer.json klasörünün içine .devcontainer dosyası 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 eylemleri veya Azure DevOps kullanarak şablonunuza CI/CD desteği de ekleyebilirsiniz:

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

2. Yeni klasöre bir iş akışı dosyası ekleyin. Başlangıç azd şablonu, her platform için örnek bir GitHub Actions iş akışı dosyası ve örnek Azure DevOps Pipelines dosyası sağlar. Bu dosyaları projenize kopyalayabilir ve gerektiğinde değiştirebilirsiniz.

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