Öğretici: Visual Studio kullanarak Azure Container Apps'e dağıtma

Azure Container Apps sunucusuz bir platformda mikro hizmetler ve kapsayıcılı uygulamalar çalıştırmanıza olanak tanır. Container Apps ile bulut altyapısını ve karmaşık kapsayıcı düzenleyicilerini el ile yapılandırma endişelerini geride bırakırken kapsayıcıları çalıştırmanın avantajlarından yararlanırsınız.

Bu öğreticide, Visual Studio kullanarak Azure Container Apps için kapsayıcılı ASP.NET Core 10.0 uygulaması dağıtacaksınız. Buradaki adımlar ASP.NET Core önceki sürümleri için de geçerlidir.

Önkoşullar

Proje oluşturma

Kapsayıcılı ASP.NET Core uygulamasını oluşturun.

  1. Visual Studio'da Dosya'yı ve ardından Yeni>Project/Çözüm'i seçin.

  2. İletişim kutusunda ASP.NET için arama yapın ve web uygulamasını ASP.NET Core seçin ve İleri'yi seçin.

  3. Proje Adı alanında uygulamayı MyContainerApp olarak adlandırın ve İleri'yi seçin.

  4. Ek Bilgi ekranında Kapsayıcı desteğini etkinleştir'i seçin. Kapsayıcı İşletim Sistemi ayarı için Linux'un seçili olduğundan emin olun.

    Docker'ı etkinleştirme seçeneğini gösteren ekran görüntüsü.

    Bu öğreticide Linux kapsayıcılarını kullanın. Bu seçim, proje şablonunun varsayılan olarak kapsayıcıya alma işlemini desteklemesini sağlar. Etkinleştirildiğinde proje, çalıştırılırken veya derlenirken bir kapsayıcı kullanır.

  5. Kapsayıcı derleme türü içinDockerfile'ı seçin.

  6. Oluştur'u seçin ve Visual Studio projeyi oluşturur ve yükler.

Azure Container Apps'e dağıt

Proje şablonunda Docker'ın Etkinleştir ayarının seçili olması nedeniyle uygulama bir Dockerfile içerir. Visual Studio, Azure Container Apps'da çalışan kapsayıcı görüntüsünü oluşturmak için Dockerfile'ı kullanır.

Bu işlemin ayrıntıları hakkında daha fazla bilgi edinmek için bkz. Visual Studio kapsayıcıları özelleştirme.

Artık uygulamayı Azure Container Apps'e dağıtmaya hazırsınız.

Kaynakları oluşturma

Visual Studio'de yayımlama pencereleri, mevcut Azure kaynaklarını seçmenize veya dağıtım için yenilerini oluşturmanıza olanak sağlar. Bu işlem ayrıca kapsayıcı görüntüsünü oluşturur, görüntüyü Azure Container Registry'a iletir ve yeni kapsayıcı uygulaması görüntüsünü dağıtır.

  1. MyContainerApp proje düğümüne sağ tıklayın ve Yayımla'yı seçin.

  2. İletişim kutusunda yayımlama seçenekleri listesinden Azure'ı ve ardından İleri'yi seçin.

    Azure'da yayımlamayı gösteren ekran görüntüsü.

  3. Belirli hedef ekranında Azure Container Apps (Linux) öğesini ve ardından İleri'yi seçin.

    Container Apps'in seçili olduğunu gösteren ekran görüntüsü.

  4. Projeyi barındırmak için bir Azure Kapsayıcı Uygulaması oluşturun. Yeşil simgenin yanındaki + seçin. Yeni oluştur iletişim kutusunda aşağıdaki değerleri girin:

    • Kapsayıcı Uygulaması adı: adını msdocscontainerappgirin.

    • Abonelik adı: Uygulamanızı barındıracak aboneliği seçin.

    • Kaynak grubu: Kaynak grubu, Azure'daki ilgili kaynakları düzenlemek için mantıksal kapsayıcı görevi görür. Mevcut bir kaynak grubunu seçebilir veya Yeni'yi seçerek seçtiğiniz bir adla (örneğin msdocscontainerapps) bir kaynak grubu oluşturabilirsiniz.

    • Container Apps Ortamı: Her kapsayıcı uygulaması bir kapsayıcı uygulaması ortamının parçası olmalıdır. Ortam, bir veya daha fazla kapsayıcı uygulaması için yalıtılmış bir ağ sağlayarak birbirlerini kolayca çağırmalarını sağlar. Kapsayıcı uygulaması ortamınızın iletişim kutusunu açmak için Yeni'yi seçin. Varsayılan değerleri bırakın ve Ortam iletişim kutusunu kapatmak için Tamam'ı seçin.

    • Kapsayıcı Adı: Bu değer, bu kapsayıcı uygulaması için çalışan kapsayıcının kolay adıdır. Bu hızlı başlangıç için msdocscontainer1 adını kullanın. Kapsayıcı uygulaması genellikle tek bir kapsayıcı çalıştırır, ancak birden fazla kapsayıcıya ihtiyaç duyulduğu zamanlar vardır. Böyle bir örnek, özelleşmiş günlükleme veya iletişim gibi bir görevi yerine getirmek için bir sidecar kapsayıcısının gerektiği durumlardan biridir.

      Yeni Container Apps'in nasıl oluşturulacağını gösteren ekran görüntüsü.

  5. Kapsayıcı uygulamanızın oluşturulmasını sonlandırmak için Oluştur'u seçin. Visual Studio ve Azure sizin yerinize gerekli kaynakları oluşturur. Bu işlem birkaç dakika sürebilir. Devam etmeden önce çalışmasına izin verin.

  6. Kaynaklar oluşturulduktan sonra İleri'yi seçin.

    Oluşturulan kaynağı seçmeyi gösteren ekran görüntüsü.

  7. Kayıt Defteri ekranında, varsa mevcut bir Kayıt Defteri'ni seçebilir veya yeni bir kayıt defteri oluşturabilirsiniz. Yeni bir tane oluşturmak için yeşil simgenin yanındaki + seçin. Yeni oluştur ekranında aşağıdaki değerleri doldurun:

    • DNS ön eki: Seçtiğiniz değeri msdocscontainerregistry veya adı girin.
    • Abonelik Adı: Kullanmak istediğiniz aboneliği seçin. Aralarından seçim yapabileceğiniz tek bir seçenek olabilir.
    • Kaynak Grubu: Daha önce oluşturduğunuz msdocs kaynak grubunu seçin.
    • Sku: Standart'ı seçin.
    • Kayıt Defteri Konumu: Coğrafi olarak size yakın bir bölge seçin.

    Kapsayıcı kayıt defterinin nasıl oluşturulacağını gösteren ekran görüntüsü.

  8. Bu değerleri doldurduktan sonra Oluştur'u seçin. Visual Studio ve Azure'ın kayıt defterini oluşturması biraz zaman alır.

  9. Kapsayıcı kayıt defteri oluşturulduktan sonra seçili olduğundan emin olun ve ardından Son'u seçin. Visual Studio'da yayımlama profilinin oluşturulması biraz zaman alır. Bu yayımlama profili, Visual Studio'da seçtiğiniz yayımlama seçeneklerini ve kaynaklarını depolar, böylece istediğiniz zaman hızla yeniden yayımlayabilirsiniz. Tamamlandıktan sonra iletişim kutusunu kapatabilirsiniz.

    Oluşturulan kayıt defterini seçmeyi gösteren ekran görüntüsü.

Visual Studio kullanarak uygulamayı yayımlama

Kaynaklar ve yayımlama profili oluşturulurken, yine de uygulamayı yayımlamanız ve Azure'a dağıtmanız gerekir.

Azure'da oluşturduğunuz kapsayıcı uygulamasına dağıtmak için yayımlama profili ekranının sağ üst kısmındaki Yayımla'yı seçin. Bu işlem biraz zaman alabilir, bu nedenle tamamlanmasını bekleyin.

Uygulamanın nasıl yayım yapılacağını gösteren ekran görüntüsü.

Uygulamanın dağıtımı tamamlandığında Visual Studio, dağıtılan sitenizin URL'sinin tarayıcısını açar. Düzgün kaynakların tümü sağlanmamışsa bu sayfa başlangıçta bir hata görüntüleyebilir. Dağıtımın tam olarak tamamlayıp tamamlanmadiğini denetlemek için tarayıcıyı düzenli aralıklarla yenileyin.

Yayımlanan siteyi gösteren ekran görüntüsü.

GitHub Actions kullanarak uygulamayı yayımlama

GitHub Actions aracılığıyla CI/CD kullanarak Container Apps'i de dağıtabilirsiniz. GitHub Actions, geliştirme iş akışlarını doğrudan projenizin GitHub deposu aracılığıyla otomatikleştirmek, özelleştirmek ve yürütmek için güçlü bir araçtır.

Visual Studio yayımladığınız projenin GitHub'de barındırılıyor olduğunu algılarsa yayımlama akışı başka bir Dağıtım türü adımı sunar. Bu aşama, geliştiricilerin hızlı başlangıçta daha önce gösterilen adımları kullanarak doğrudan Visual Studio aracılığıyla mı yoksa GitHub Actions iş akışı aracılığıyla mı yayımlayacaklarını seçmesine olanak tanır.

Dağıtım türünü gösteren ekran görüntüsü.

GitHub Actions iş akışını seçerseniz, Visual Studio oluşturulan bir YAML dosyası da dahil olmak üzere projenin kök dizininde bir .github klasörü oluşturur. YAML dosyası, kodunuzu her gönderişinizde uygulamanızı derlemek ve Azure'a dağıtmak için GitHub Actions yapılandırmalarını içerir.

Bir değişiklik yaptıktan ve kodunuzu gönderdikten sonra GitHub'da Eylemler sekmesinin altında derleme ve dağıtma işleminin ilerleme durumunu görebilirsiniz. Bu sayfada, iş akışının ilerleme durumu ve durumuyla ilgili ayrıntılı günlükler ve göstergeler sağlanır.

GitHub eylemlerini gösteren ekran görüntüsü.

derleme ve dağıtma işlerinin yanında yeşil bir onay işareti gördüğünüzde iş akışı tamamlanır. Container Apps sitenize göz atarken en son değişikliklerin uygulandığını görmeniz gerekir. Azure portal sayfasını kullanarak kapsayıcı uygulamanızın URL'sini her zaman bulabilirsiniz.

Kaynakları temizleme

Bu uygulamayı kullanmayı planlamıyorsanız, kaynak grubunu kaldırarak Azure Container Apps örneğini ve ilişkili tüm hizmetleri silebilirsiniz.

Oluşturduğunuz kaynakları kaldırmak için Azure portalında şu adımları izleyin:

  1. Genel Bakış bölümünden msdocscontainerapps kaynak grubunu seçin.

  2. Kaynak grubu Genel Bakış sayfasının üst kısmındaki Kaynak grubunu sil düğmesini seçin.

  3. Silme işlemini onaylamak için msdocscontainerapps kaynak grubu adını girin.

  4. Sil'i seçin.

    Kaynak grubunu silme işleminin tamamlanması birkaç dakika sürebilir.

İpucu

Sorun mu yaşıyorsunuz? Azure Container Apps deposunda bir sorun açarak GitHub'da bize bildirin.

Sonraki adım