ASP.NET uygulama kapsayıcısı oluşturma ve Azure Kubernetes Service'e geçiş

Bu makalede, Azure Geçişi: Uygulama Kapsayıcısı Oluşturma aracını kullanarak ASP.NET uygulamaları kapsayıcıya almayı ve Azure Kubernetes Service'e (AKS) geçirmeyi öğreneceksiniz. Kapsayıcıya alma işlemi kod tabanınıza erişim gerektirmez ve mevcut uygulamaları kapsayıcıya almak için kolay bir yol sağlar. Araç, uygulama bileşenlerini belirlemek için sunucudaki uygulamaların çalışma durumunu kullanarak çalışır ve bunları bir kapsayıcı görüntüsünde paketlemenize yardımcı olur. Kapsayıcılı uygulama daha sonra Azure Kubernetes Service'te (AKS) dağıtılabilir.

Azure Geçişi: Uygulama Kapsayıcısı aracı şu anda aşağıdakileri desteklemektedir:

• ASP.NET uygulamalarını kapsayıcıya alma ve Azure Kubernetes Service'te Windows kapsayıcılarına dağıtma.
• ASP.NET uygulamalarını kapsayıcıya alma ve Azure Uygulaması Hizmeti'nin Windows kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• Apache Tomcat'te (Linux sunucularında) Java Web uygulamalarını kapsayıcıya alma ve AKS'de Linux kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• Java Web uygulamalarını Apache Tomcat'te (Linux sunucularında) kapsayıcıya alma ve App Service'te Linux kapsayıcılarına dağıtma. Daha fazla bilgi edinin.

Azure Geçişi: Uygulama Kapsayıcısı aracı şunları gerçekleştirmenize yardımcı olur:

• Uygulamanızı keşfedin: Araç, ASP.NET uygulamanızı çalıştıran uygulama sunucularına uzaktan bağlanır ve uygulama bileşenlerini bulur. Araç, uygulama için kapsayıcı görüntüsü oluşturmak için kullanılabilecek bir Dockerfile oluşturur.
• Kapsayıcı görüntüsünü derleme: Dockerfile'ı uygulama gereksinimlerinize göre inceleyip daha fazla özelleştirebilir ve bunu kullanarak uygulama kapsayıcı görüntünüzü oluşturabilirsiniz. Uygulama kapsayıcı görüntüsü, belirttiğiniz bir Azure Container Registry'ye gönderilir.
• Azure Kubernetes Service'e dağıtma: Araç daha sonra kapsayıcılı uygulamayı Azure Kubernetes Service kümenize dağıtmak için gereken Kubernetes kaynak tanımı YAML dosyalarını oluşturur. YAML dosyalarını özelleştirebilir ve uygulamayı AKS'ye dağıtmak için kullanabilirsiniz.

Tüm uygulamalar önemli bir yeniden tasarlama olmadan kapsayıcılara doğrudan geçişten yararlanamaz, ancak mevcut uygulamaları yeniden yazmadan kapsayıcılara taşımanın bazı avantajları şunlardır:

• Geliştirilmiş altyapı kullanımı - Kapsayıcılarla birden çok uygulama kaynakları paylaşabilir ve aynı altyapıda barındırılabilir. Bu, altyapıyı birleştirmenize ve kullanımı geliştirmenize yardımcı olabilir.
• Basitleştirilmiş yönetim - Uygulamalarınızı AKS ve App Service gibi modern bir yönetilen platformda barındırarak yönetim uygulamalarınızı basitleştirebilirsiniz. Geleneksel olarak sahip olduğunuz altyapıyla gerçekleştirdiğiniz altyapı bakım ve yönetim işlemlerini emekliye kaldırarak veya azaltarak bunu yapabilirsiniz.
• Uygulama taşınabilirliği - Kapsayıcı belirtim biçimlerinin ve platformlarının daha fazla benimsenmesi ve standartlaştırılmasıyla, uygulama taşınabilirliği artık önemli değildir.
• DevOps ile modern yönetimi benimseme - Yönetim ve güvenlik ile DevOps'a geçiş için modern uygulamaları benimsemenize ve standartlaştırmanıza yardımcı olur.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Önkoşullar

Bu öğreticiye başlamadan önce karşılamanız gereken ön koşullar şunlardır:

Azure kullanıcı hesabı hazırlama

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Aboneliğiniz ayarlandıktan sonra şunları içeren bir Azure kullanıcı hesabına ihtiyacınız vardır:

• Azure aboneliğinde sahip izinleri.
• Microsoft Entra uygulamalarını kaydetme izinleri.

Ücretsiz Azure hesabı oluşturduysanız aboneliğinizin sahibi siz olursunuz. Abonelik sahibi değilseniz, izinleri aşağıdaki gibi atamak için sahiple birlikte çalışın:

1. Azure portalında "abonelikler" için arama yapın ve Hizmetler'in altında Abonelikler'i seçin.

   

2. Abonelikler sayfasında, Azure Geçişi projesi oluşturmak istediğiniz aboneliği seçin.

3. Erişim denetimi (IAM) öğesini seçin.

4. Rol ataması ekle sayfasını açmak için Rol ataması ekle'yi> seçin.

5. Aşağıdaki rolü atayın. Ayrıntılı adımlar için bkz . Azure portalını kullanarak Azure rolleri atama.

   Ayar	Value
   Role	Sahip
   Şu kişiye erişim ata:	User
   Üyeler	azmigrateuser (bu örnekte)

   

6. Azure hesabınızın Microsoft Entra uygulamalarını kaydetmek için de izinlere ihtiyacı vardır .

7. Azure portalında Microsoft Entra ID>Kullanıcıları>Kullanıcı Ayarları'na gidin.

8. Kullanıcı ayarlarında, Microsoft Entra kullanıcılarının uygulamaları kaydedebildiğini doğrulayın (varsayılan olarak Evet olarak ayarlanır).

   

   Önemli

   Microsoft, rolleri en az izinle kullanmanızı önerir. Bu, kuruluşunuzun güvenliğini artırmaya yardımcı olur. Genel Yönetici, mevcut bir rolü kullanamıyorsanız acil durum senaryolarıyla sınırlı olması gereken yüksek ayrıcalıklı bir roldür.

9. 'Uygulama kayıtları' ayarlarının 'Hayır' olarak ayarlanması durumunda kiracıdan/genel yöneticiden gerekli izni atamasını isteyin. Alternatif olarak, kiracı/genel yönetici Microsoft Entra Uygulamasının kaydına izin vermek için bir hesaba Uygulama Geliştirici rolünü atayabilir. Daha fazla bilgi edinin.

Azure Geçişi: Uygulama Kapsayıcısı Aracı'nı indirme ve yükleme

1. Windows makinesinde Azure Geçişi: Uygulama Kapsayıcısı yükleyicisini indirin.

2. PowerShell'i yönetici modunda başlatın ve PowerShell dizinini yükleyiciyi içeren klasörle değiştirin.

3. komutunu kullanarak yükleme betiğini çalıştırın

   .\AppContainerizationInstaller.ps1
   

Uygulama Kapsayıcısı oluşturma aracını başlatma

1. Uygulama Kapsayıcısı aracı çalıştıran Windows makinesine bağlanabilen herhangi bir makinede bir tarayıcı açın ve araç URL'sini açın: https:// makine adı veya IP adresi: 44369.

   Alternatif olarak, uygulama kısayolunu seçerek uygulamayı masaüstünden açabilirsiniz.

2. Bağlantınızın özel olmadığını belirten bir uyarı görürseniz Gelişmiş'i seçin ve web sitesine devam etmeyi seçin. Bu uyarı, web arabirimi otomatik olarak imzalanan bir TLS/SSL sertifikası kullandığında görünür.

3. Oturum açma ekranında, oturum açmak için makinedeki yerel yönetici hesabını kullanın.

4. Kapsayıcıya almak istediğiniz uygulama türü olarak web uygulamalarını ASP.NET seçin.

5. Hedef Azure hizmetini belirtmek için Azure Kubernetes Service'te Kapsayıcılar'ı seçin.

   

Tam araç önkoşulları

1. Lisans koşullarını kabul edin ve üçüncü taraf bilgilerini okuyun.
2. Araç web uygulamasında >Önkoşulları ayarlama bölümünde aşağıdaki adımları uygulayın:
   • Bağlantı: Araç, Windows makinesinin İnternet erişimine sahip olduğunu denetler. Makine bir ara sunucu kullanıyorsa:
     • Ara sunucu adresini (IP adresi veya FQDN biçiminde) ve dinleme bağlantı noktasını belirtmek için Ara sunucuyu ayarla'yı seçin.
     • Proxy için kimlik doğrulaması gerekiyorsa kimlik bilgilerini gerekin.
     • Yalnızca HTTP proxy’si desteklenir.
     • Ara sunucu ayrıntılarını eklediyseniz veya ara sunucuyu ve/veya kimlik doğrulamasını devre dışı bırakmışsanız, bağlantı denetimini yeniden tetiklemek için Kaydet'i seçin.
   • Güncelleştirmeleri yükleme: Araç en son güncelleştirmeleri otomatik olarak denetler ve yükler. Aracın en son sürümünü buradan el ile de yükleyebilirsiniz.
   • Microsoft Web Dağıtımı aracını yükleme: Araç, Azure Geçişi: Uygulama Kapsayıcısı aracı çalıştıran Windows makinesinde Microsoft Web Dağıtımı aracının yüklü olup olmadığını denetler.
   • PowerShell uzaktan iletişimini etkinleştirme: Araç, kapsayıcıya alınabilecek ASP.NET uygulamaları çalıştıran uygulama sunucularında PowerShell uzaktan iletişiminin etkinleştirildiğinden emin olmanız için sizi bilgilendirecektir.

Azure'da oturum açma

1. Azure hesabınızda oturum açmak için Oturum aç'ı seçin.

2. Azure'da kimlik doğrulaması yapmak için bir cihaz kodu gerekir. Oturum aç'ı seçtiğinizde cihaz koduyla bir kalıcı açılır.

3. Cihaz kodunu kopyalamak ve yeni bir tarayıcı sekmesinde azure oturum açma istemi açmak için Kodu kopyala ve oturum aç'ı seçin. Görünmezse, tarayıcıda açılır pencere engelleyicisini devre dışı bırakmış olduğunuzdan emin olun.

   

4. Yeni sekmede cihaz kodunu yapıştırın ve Azure hesabı kimlik bilgilerinizi kullanarak oturum açmayı tamamlayın. Oturum açma tamamlandıktan sonra tarayıcı sekmesini kapatabilir ve Uygulama Kapsayıcısı aracı ekranına dönebilirsiniz.

5. Kullanmak istediğiniz Azure kiracısını seçin.

6. Kullanmak istediğiniz Azure aboneliğini belirtin.

ASP.NET uygulamaları keşfedin

Uygulama Kapsayıcısı oluşturma yardımcı aracı, sağlanan kimlik bilgilerini kullanarak uygulama sunucularına uzaktan bağlanır ve uygulama sunucularında barındırılan ASP.NET uygulamaları bulmayı dener.

1. Uygulama bulma için sunucuya uzaktan bağlanmak için kullanılması gereken IP adresini/FQDN'yi ve ASP.NET uygulamasını çalıştıran sunucunun kimlik bilgilerini belirtin.

   • Sağlanan kimlik bilgileri uygulama sunucusundaki bir yerel yöneticiye (Windows) ait olmalıdır.
   • Etki alanı hesapları için (kullanıcının uygulama sunucusunda yönetici olması gerekir), etki alanı adıyla etki alanı\kullanıcı adı biçiminde <ön ek ekleyin>.
   • Aynı anda en fazla beş sunucu için uygulama bulma çalıştırabilirsiniz.

2. Uygulama sunucusunun aracı çalıştıran makineden erişilebilir olduğunu ve kimlik bilgilerinin geçerli olduğunu doğrulamak için Doğrula'yı seçin. Doğrulama başarılı olursa, durum sütunu durumu Eşlendi olarak gösterir.

   

3. Seçili uygulama sunucularında uygulama bulmayı başlatmak için Devam'ı seçin.

4. Uygulama bulmayı başarıyla tamamladığınızda kapsayıcıya almak için uygulamaların listesini seçebilirsiniz.

   

5. Kapsayıcıya eklenecek uygulamaları seçmek için onay kutusunu kullanın.

6. Kapsayıcı adını belirtin: Seçilen her uygulama için hedef kapsayıcı için bir ad belirtin. Kapsayıcı adı, etiketin kapsayıcı görüntüsü için kullanıldığı name:tag> olarak <belirtilmelidir. Örneğin, hedef kapsayıcı adını appname:v1 olarak belirtebilirsiniz.

Uygulama yapılandırmalarını parametreleştirme

Yapılandırmayı parametrelendirmek, bir dağıtım zamanı parametresi olarak kullanılabilir hale getirir. Bu, uygulamayı kapsayıcı görüntüsündeki belirli bir değere sabit olarak kodlanmasından farklı olarak dağıtırken bu ayarı yapılandırmanıza olanak tanır. Örneğin, bu seçenek veritabanı bağlantı dizesi gibi parametreler için kullanışlıdır.

1. Algılanan yapılandırmaları gözden geçirmek için uygulama yapılandırmalarını seçin.

2. Algılanan uygulama yapılandırmalarını parametreleştirmek için onay kutusunu seçin.

3. Parametreleştirecek yapılandırmaları seçtikten sonra Uygula'yı seçin.

   

Dosya sistemi bağımlılıklarını dışlaştırma

Uygulamanızın kullandığı diğer klasörleri ekleyebilirsiniz. Kapsayıcı görüntüsünün parçası olması mı yoksa Azure dosya paylaşımındaki kalıcı birimler aracılığıyla dışlanması mı gerektiğini belirtin. Kalıcı birimlerin kullanılması, kapsayıcının dışında durum depolayan veya dosya sisteminde depolanan diğer statik içeriğe sahip durum bilgisi olan uygulamalar için harika çalışır. Daha fazla bilgi edinin.

1. Algılanan uygulama klasörlerini gözden geçirmek için Uygulama Klasörleri'nin altında Düzenle'yi seçin. Algılanan uygulama klasörleri, uygulama tarafından gerekli olan zorunlu yapıtlar olarak tanımlandı ve kapsayıcı görüntüsüne kopyalanacak.

2. Klasör ekle'yi seçin ve eklenecek klasör yollarını belirtin.

3. Aynı birime birden çok klasör eklemek için virgülle (,) ayrılmış değerler sağlayın.

4. Klasörlerin Bir Kalıcı Birim üzerindeki kapsayıcının dışında depolanmasını istiyorsanız depolama seçeneği olarak Kalıcı Birim'i seçin.

5. Uygulama klasörlerini gözden geçirdikten sonra Kaydet'i seçin.

6. Kapsayıcı görüntüsü derleme aşamasına geçmek için Devam'ı seçin.

Kapsayıcı görüntüsü oluşturma

# Run entrypoint script.
COPY ./Entryscript.ps1 c:/Entryscript.ps1
ENTRYPOINT powershell c:/Entryscript.ps1

# Run entrypoint script.
COPY ["./Entryscript.ps1", "c:/Entryscript.ps1"]
ENTRYPOINT ["powershell", "c:/Entryscript.ps1"]

Kapsayıcı görüntüsü oluşturmak için şu adımları izleyin:

1. Azure Container Registry'yi seçin: Uygulamalar için kapsayıcı görüntülerini oluşturmak ve depolamak için kullanılacak bir Azure Container Registry seçmek için açılan listeyi kullanın. Mevcut bir Azure Container Registry'yi kullanabilir veya Yeni kayıt defteri oluştur seçeneğini kullanarak yeni bir kayıt defteri oluşturmayı seçebilirsiniz.

   

2. Dockerfile: Seçilen her uygulama için kapsayıcı görüntülerini oluşturmak için gereken Dockerfile derleme adımının başında oluşturulur. Dockerfile dosyasını gözden geçirmek için Gözden Geçir'i seçin. Ayrıca, derleme işlemine başlamadan önce inceleme adımında Dockerfile dosyasına gerekli özelleştirmeleri ekleyebilir ve değişiklikleri kaydedebilirsiniz.

3. Derleme işlemini tetikleme: Görüntülerin derlendiği uygulamaları seçin ve Ardından Derle'yi seçin. Derleme seçildiğinde her uygulama için kapsayıcı görüntüsü derlemesi başlatılır. Araç, derleme durumunu sürekli izlemeye devam eder ve derlemeyi başarıyla tamamladığınızda sonraki adıma geçmenizi sağlar.

4. Derleme durumunu izleme: Durum sütununun altındaki Devam Eden Derleme bağlantısını seçerek de derleme adımının ilerleme durumunu izleyebilirsiniz. Derleme işlemini tetikledikten sonra bağlantının etkin olması birkaç dakika sürer.

5. Derleme tamamlandıktan sonra dağıtım ayarlarını belirtmek için Devam'ı seçin.

   

AKS'de kapsayıcılı uygulamayı dağıtma

Kapsayıcı görüntüsü oluşturulduktan sonra, sonraki adım uygulamayı Azure Kubernetes Service'te (AKS) kapsayıcı olarak dağıtmaktır.

1. Azure Kubernetes Service Kümesini seçin: Uygulamanın dağıtılması gereken AKS kümesini belirtin.

   • Seçili AKS kümesinin bir Windows düğüm havuzu olmalıdır.
   • Küme, görüntüleri depolamak için seçilen Azure Container Registry'den görüntülerin çekilmesine izin verecek şekilde yapılandırılmalıdır.
     • AKS kümesini ACR'ye eklemek için Azure CLI'da aşağıdaki komutu çalıştırın.

       az aks update -n <cluster-name> -g <cluster-resource-group> --attach-acr <acr-name>
       

   • AKS kümeniz yoksa veya uygulamayı dağıtmak için yeni bir AKS kümesi oluşturmak istiyorsanız, Yeni AKS kümesi oluştur'u seçerek araçtan üzerinde oluşturmayı seçebilirsiniz.
     • Araç kullanılarak oluşturulan AKS kümesi bir Windows düğüm havuzuyla oluşturulur. Küme, daha önce oluşturulan Azure Container Registry'den görüntü çekmesine izin verecek şekilde yapılandırılır (yeni kayıt defteri oluştur seçeneği belirlenmişse).
   • AKS kümesini seçtikten sonra Devam'ı seçin.

2. Gizli dizi deposunu belirtin: Uygulama yapılandırmalarını parametreleştirmeyi seçtiyseniz, uygulama için kullanılacak gizli dizi deposunu belirtin. Uygulama gizli dizilerinizi yönetmek için Azure Key Vault veya App Service uygulama ayarlarını seçebilirsiniz. Daha fazla bilgi edinin

   • Gizli dizileri yönetmek için App Service uygulama ayarlarını seçtiyseniz Devam'ı seçin.
   • Uygulama gizli dizilerinizi yönetmek için bir Azure Key Vault kullanmak istiyorsanız kullanmak istediğiniz Azure Key Vault'ı belirtin.
     • Azure Key Vault'nuz yoksa veya yeni bir Key Vault oluşturmak istiyorsanız, Yeni Azure Key Vault oluştur'u seçerek araçtan oluşturmayı seçebilirsiniz.
     • Araç, Key Vault aracılığıyla gizli dizileri yönetmek için gerekli izinleri otomatik olarak atar.

3. Azure dosya paylaşımını belirtin: Daha fazla klasör eklediyseniz ve Kalıcı Birim seçeneğini belirlediyseniz, dağıtım işlemi sırasında Azure Geçişi: Uygulama Kapsayıcısı aracı tarafından kullanılması gereken Azure dosya paylaşımını belirtin. Araç, Kalıcı Birim depolama için yapılandırılmış uygulama klasörlerinin üzerine kopyalamak için bu Azure dosya paylaşımında yeni dizinler oluşturur. Uygulama dağıtımı tamamlandıktan sonra araç, oluşturduğu dizinleri silerek Azure dosya paylaşımını temizler.

   • Azure dosya paylaşımınız yoksa veya yeni bir Azure dosya paylaşımı oluşturmak istiyorsanız, Yeni Depolama Hesabı ve dosya paylaşımı oluştur'u seçerek araçtan oluşturmayı seçebilirsiniz.

4. Uygulama dağıtım yapılandırması: Yukarıdaki adımları tamamladıktan sonra uygulama için dağıtım yapılandırmasını belirtmeniz gerekir. Uygulamanın dağıtımını özelleştirmek için Yapılandır'ı seçin. Yapılandırma adımında aşağıdaki özelleştirmeleri sağlayabilirsiniz:

   • Ön ek dizesi: AKS kümesindeki kapsayıcılı uygulama için oluşturulan tüm kaynaklar için adında kullanılacak bir ön ek dizesi belirtin.
   • SSL sertifikası: Uygulamanız bir https site bağlaması gerektiriyorsa, bağlama için kullanılacak sertifikayı içeren PFX dosyasını belirtin. PFX dosyasının parola korumalı olmaması ve özgün sitenin birden çok bağlaması olmamalıdır.
   • Çoğaltma Kümeleri: Kapsayıcıların içinde çalıştırılması gereken uygulama örneklerinin (pod) sayısını belirtin.
   • Yük dengeleyici türü: Kapsayıcılı uygulamaya genel ağlardan ulaşılması gerekiyorsa Dış'ı seçin.
   • Uygulama Yapılandırması: Parametreleştirilmiş tüm uygulama yapılandırmaları için geçerli dağıtım için kullanılacak değerleri sağlayın.
   • Depolama: Kalıcı Birim depolaması için yapılandırılmış tüm uygulama klasörleri için birimin uygulama örnekleri arasında paylaşılıp paylaşılmayacağını veya kapsayıcıdaki her örnekle ayrı ayrı başlatılıp başlatılmayacağını belirtin. Varsayılan olarak, Kalıcı Birimlerdeki tüm uygulama klasörleri paylaşılan olarak yapılandırılır.
   • Dağıtım yapılandırmasını kaydetmek için Uygula'yı seçin.
   • Uygulamayı dağıtmak için Devam'ı seçin.

   

5. Uygulamayı dağıtma: Uygulamanın dağıtım yapılandırması kaydedildikten sonra araç, uygulama için Kubernetes dağıtımı YAML'sini oluşturur.

   • Uygulamalar için Kubernetes dağıtımı YAML'sini gözden geçirmek ve özelleştirmek için Gözden Geçir'i seçin.

   • Dağıtılacak uygulamayı seçin.

   • Seçilen uygulamalar için dağıtımları başlatmak için Dağıt'ı seçin

     

   • Uygulama dağıtıldıktan sonra, uygulama için dağıtılan kaynakları izlemek için Dağıtım durumu sütununu seçebilirsiniz.

Oluşturulan yapıtları indirme

Dockerfile ve Kubernetes YAML belirtim dosyaları da dahil olmak üzere uygulamayı AKS'ye derlemek ve dağıtmak için kullanılan tüm yapıtlar, aracı çalıştıran makinede depolanır. Yapıtlar C:\ProgramData\Microsoft Azure Geçişi Uygulama Kapsayıcısı'nda bulunur.

Her uygulama sunucusu için tek bir klasör oluşturulur. Bu klasöre giderek kapsayıcıya alma işleminde kullanılan tüm ara yapıtları görüntüleyebilir ve indirebilirsiniz. Uygulama sunucusuna karşılık gelen klasör, belirli bir sunucu için aracın her çalıştırmasının başlangıcında temizlenir.

Sorunları giderme

Araçla ilgili sorunları gidermek için, Uygulama Kapsayıcısı aracını çalıştıran Windows makinesindeki günlük dosyalarına bakabilirsiniz. Araç günlük dosyaları C:\ProgramData\Microsoft Azure Geçişi Uygulaması Containerization\Logs klasöründe bulunur.

Sonraki adımlar

• ASP.NET web uygulamalarını kapsayıcıya alma ve App Service'te Windows kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• Apache Tomcat'te (Linux sunucularında) Java web uygulamalarını kapsayıcıya alma ve AKS'de Linux kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• Java web uygulamalarını Apache Tomcat'te (Linux sunucularında) kapsayıcıya alma ve App Service'te Linux kapsayıcılarına dağıtma. Daha fazla bilgi edinin.