Java web uygulaması kapsayıcısı oluşturma ve Azure Uygulaması Hizmetine geçiş

Bu makalede, Azure Geçişi: Uygulama Kapsayıcıya Alma aracını kullanarak Java web uygulamalarını kapsayıcıya almayı (Apache Tomcat üzerinde çalışan) ve bunları Azure Uygulaması Hizmetine 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 Uygulaması Hizmeti'ne dağıtılabilir.

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

• Apache Tomcat'te Java Web Apps'i kapsayıcıya alma (Linux sunucularında) ve bunları App Service'te Linux kapsayıcılarına dağıtma.
• Apache Tomcat'te Java Web Apps'i kapsayıcıya alma (Linux sunucularında) ve bunları AKS'de Linux kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• ASP.NET uygulamalarını kapsayıcıya alma ve AKS'de Windows kapsayıcılarına dağıtma. Daha fazla bilgi edinin.
• ASP.NET uygulamalarını kapsayıcıya alma ve App Service'te Windows 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ç, Java web uygulamanızı (Apache Tomcat üzerinde çalışan) ç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 Uygulaması Hizmetine dağıtma: Araç daha sonra kapsayıcılı uygulamayı Azure Uygulaması Hizmeti'ne dağıtmak için gereken dağıtım dosyalarını oluşturur.

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 birlikte, 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 şu şekilde bir Azure kullanıcı hesabına ihtiyacınız olacaktı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. Abonelikte Erişim denetimi (IAM)Erişimi denetle'yi> seçin.

4. Erişimi denetle bölümünde ilgili kullanıcı hesabını arayın.

5. Rol ataması ekle bölümünde Ekle'yi seçin.

   

6. Rol ataması ekle bölümünde Sahip rolünü seçin ve hesabı seçin (örneğimizde azmigrateuser). Kaydet'i seçin.

   

Azure hesabınızın Microsoft Entra uygulamalarını kaydetmek için de izinlere ihtiyacı vardır. 8. Azure portalında Microsoft Entra ID>Kullanıcıları>Kullanıcı Ayarları'na gidin. 9. Kullanıcı ayarlarında, Microsoft Entra kullanıcılarının uygulamaları kaydedip kaydedemediğini doğrulayın (varsayılan olarak Evet olarak ayarlanır).

10. 'Uygulama kayıtları' ayarı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 Tomcat'te Java web uygulamaları'nı seçin.

5. Hedef Azure hizmetini belirtmek için Azure Uygulaması Hizmetinde Kapsayıcılar'ı seçin.

Eksiksiz 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.
   • Secure Shell'i (SSH) etkinleştir: Araç, Kapsayıcılı hale getirilecek Java web uygulamalarını çalıştıran uygulama sunucularında Secure Shell'in (SSH) etkinleştirildiğinden emin olmanız için sizi bilgilendirecektir.

Azure'da oturum açma

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

1. 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.

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

   

3. 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ının web arabirimine dönebilirsiniz.

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

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

Java web uygulamalarını keşfetme

App Containerization yardımcı aracı, sağlanan kimlik bilgilerini kullanarak uygulama sunucularına uzaktan bağlanır ve uygulama sunucularında barındırılan Java web uygulamalarını (Apache Tomcat üzerinde çalışan) bulmayı dener.

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

   • Sağlanan kimlik bilgileri, uygulama sunucusundaki bir kök hesap (Linux) için 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ı'na tıklayın.

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ı aracılığıyla kalıcı depolamaya dışlanması mı gerektiğini belirtin. Dış kalıcı depolamayı kullanmak, 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.

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 kalıcı depolamada kapsayıcının dışında depolanmasını istiyorsanız depolama seçeneği olarak Azure dosya paylaşımı'nı 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

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. Application Insights'ı yapılandırma: Kodunuzu izlemeden App Service'te çalışan Java uygulamalarınız için izlemeyi etkinleştirebilirsiniz. Araç, kapsayıcı görüntüsünün bir parçası olarak Java tek başına aracısını yükler. Dağıtım sırasında yapılandırıldıktan sonra, Java aracısı uygulamanız için Application Insights ile izlemek için kullanılabilecek çok sayıda isteği, bağımlılığı, günlük ve ölçümü otomatik olarak toplar. Bu seçenek tüm Java uygulamaları için varsayılan olarak etkindir.

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

5. Derleme durumunu izleme: Derleme durumu 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.

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

   

kapsayıcılı uygulamayı Azure Uygulaması Hizmeti'ne dağıtma

Kapsayıcı görüntüsü oluşturulduktan sonra, sonraki adım uygulamayı Azure Uygulaması Hizmeti'ne kapsayıcı olarak dağıtmaktır.

1. Azure Uygulaması Hizmet planını seçin: Uygulamanın kullanması gereken Azure Uygulaması Hizmet planını belirtin.

   • App Service planınız yoksa veya kullanmak üzere yeni bir App Service planı oluşturmak istiyorsanız, Yeni App Service planı oluştur'u seçerek araçtan bir plan oluşturmayı seçebilirsiniz.
   • App Service planını seçtikten sonra Devam'ı seçin.

2. Gizli dizi deposunu ve izleme çalışma alanını 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 oluştur'u seçerek araçtan bir anahtar oluşturmayı seçebilirsiniz.
     • Araç, Key Vault aracılığıyla gizli dizileri yönetmek için gerekli izinleri otomatik olarak atar.
   • İzleme çalışma alanı: Application Insights ile izlemeyi etkinleştirmeyi seçtiyseniz, kullanmak istediğiniz Application Insights kaynağını belirtin. İzleme tümleştirmesini devre dışı bırakmışsanız bu seçenek görünmez.
     • Application Insights kaynağınız yoksa veya yeni bir kaynak oluşturmak istiyorsanız Yeni oluştur'u seçerek araçtan oluşturma seçeneğini belirleyebilirsiniz.

3. Azure dosya paylaşımını belirtin: Daha fazla dizin/klasör eklediyseniz ve kalıcı depolama için Azure dosya paylaşımı seçeneğini belirlediyseniz, dağıtım işlemi sırasında Azure Geçişi: Uygulama Kapsayıcısı aracı tarafından kullanılacak Azure dosya paylaşımını belirtin. Araç, Azure Dosyalar için yapılandırılan uygulama dizinleri/klasörlerinin üzerine kopyalayıp dağıtım sırasında bunları uygulama kapsayıcısına bağlar. 

   • 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:

   • Ad: Uygulama için benzersiz bir uygulama adı belirtin. Bu ad, uygulama URL'sini oluşturmak için kullanılır ve bu dağıtımın bir parçası olarak oluşturulan diğer kaynaklar için ön ek olarak kullanılır.
   • 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 yapılandırması: Kalıcı depolama için yapılandırılmış tüm uygulama dizinlerinin/klasörlerinin bilgilerini gözden geçirin.

   

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ın dağıtım yapılandırmasını gözden geçirmek 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.

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 Uygulama Kapsayıcısı\Günlükler klasöründe bulunur.

Sonraki adımlar

• 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
• ASP.NET web uygulamalarını kapsayıcıya alma ve AKS'de Windows kapsayıcılarına dağıtma. Daha fazla bilgi edinin
• ASP.NET web uygulamalarını kapsayıcıya alma ve bunları Azure Uygulaması Hizmeti'nin Windows kapsayıcılarına dağıtma. Daha fazla bilgi edinin