Aracılığıyla paylaş


Hızlı Başlangıç: Azure Sanal Makineler(VM) üzerinde JBoss EAP kümesi dağıtma

Bu makalede, Azure portalını kullanarak Azure Sanal Makineler(VM) üzerinde bir JBoss Enterprise Application Platform (EAP) kümesini hızla dağıtma adımları gösterilmektedir.

Bu makalede, Azure VM'lerine yolculuğunuzu hızlandırmak için JBoss EAP Kümesine yönelik Azure Market teklifi kullanılır. Teklif otomatik olarak Azure Red Hat Enterprise Linux (RHEL) VM'leri, her VM'de JBoss EAP örnekleri, her VM'de OpenJDK'nin Red Hat derlemesi, JBoss EAP yönetim konsolu ve isteğe bağlı olarak bir Azure Uygulaması Gateway örneği gibi çeşitli kaynaklar sağlar. Teklifi görmek için Azure portalını kullanarak RHEL VM'lerinde JBoss EAP Kümesi çözümünü ziyaret edin.

Azure Market teklifi tarafından etkinleştirilen otomasyonu kullanmayan Azure VM'lerine Red Hat JBoss EAP Kümesini yüklemek için el ile adım adım kılavuzu tercih ediyorsanız bkz. Öğretici: Azure'a Red Hat JBoss EAP'yi el ile yükleme Sanal Makineler.

Azure çözümleri üzerinde JBoss EAP geliştiren mühendislik ekibiyle geri bildirim sağlamak veya geçiş senaryolarınız üzerinde yakından çalışmak istiyorsanız JBoss EAP geçişiyle ilgili bu kısa anketi doldurun ve iletişim bilgilerinizi ekleyin. Program yöneticileri, mimarlar ve mühendislerden oluşan ekip, yakın işbirliği başlatmak için sizinle hemen iletişime geçecektir.

Önkoşullar

  • Azure aboneliği. Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
  • Oturum açmak için kullandığınız Azure kimliğinin geçerli abonelikte Katkıda Bulunan rolüne veya Sahip rolüne sahip olduğundan emin olun. Azure rollerine genel bakış için bkz. Azure rol tabanlı erişim denetimi (Azure RBAC) nedir?
  • Java Geliştirme Seti (JDK), sürüm 17. Bu kılavuzda, OpenJDK'nin Red Hat Derlemesini öneririz. Ortam değişkeninizin JAVA_HOME komutları çalıştırdığınız kabuklarda doğru ayarlandığından emin olun.
  • Git. Çalışıp çalışmadığını git test etmek için kullanıngit --version. Bu öğretici 2.34.1 sürümüyle test edilmiştir.
  • Maven. Çalışıp çalışmadığını mvn test etmek için kullanınmvn -version. Bu öğretici 3.8.6 sürümüyle test edilmiştir.

Not

Bu makalede kullanacağınız Azure Market teklifi, lisans yönetimi için Red Hat Satellite desteğini içerir. Red Hat Uydu'nun kullanılması bu hızlı başlangıcın kapsamı dışındadır. Red Hat Satellite'a genel bakış için bkz . Red Hat Satellite. Red Hat JBoss EAP ve Red Hat Enterprise Linux aboneliklerinizi Azure'a taşıma hakkında daha fazla bilgi edinmek için bkz . Red Hat Cloud Access programı.

PostgreSQL için Azure Veritabanı esnek sunucu ayarlama

Bu bölümdeki adımlar, sonraki bölümde bir JBoss EAP kümesi ayarlarken veritabanı bağlantısını yapılandırmak için kullandığınız PostgreSQL için Azure Veritabanı esnek bir sunucu dağıtmaya yönlendirir.

İlk olarak, bazı ortam değişkenlerini ayarlamak için aşağıdaki komutu kullanın.

export RG_NAME=<db-resource-group-name>
export SERVER_NAME=<database-server-name>
export ADMIN_PASSWORD=<postgresql-admin-password>

Yer tutucuları makale boyunca kullanılan aşağıdaki değerlerle değiştirin:

  • <db-resource-group-name>: PostgreSQL esnek sunucusu için kullanılacak kaynak grubunun adı ; örneğin, ejb040323postgresrg.
  • <database-server-name>: PostgreSQL sunucunuzun adıdır ve Azure genelinde benzersiz olmalıdır. Örneğin, ejb040323postgresqlserver.
  • <postgresql-admin-password>: PostgreSQL sunucunuzun parolası. Bu parola en az sekiz karakter ve en çok 128 karakter olmalıdır. Karakterler şu üç kategoriden olmalıdır: İngilizce büyük harfler, İngilizce küçük harfler, sayılar (0-9) ve büyük harf olmayan karakterler (!, $, #, %, vb.).

Ardından, PostgreSQL için Azure Veritabanı esnek sunucu oluşturmak için aşağıdaki adımları kullanın:

  1. PostgreSQL için Azure Veritabanı esnek sunucu oluşturmak için aşağıdaki komutu kullanın:

    az postgres flexible-server create \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME} \
        --database-name testdb \
        --public-access 0.0.0.0  \
        --admin-user testuser \
        --admin-password ${ADMIN_PASSWORD} \
        --yes
    
  2. PostgreSQL sunucusunun ana bilgisayarını almak için aşağıdaki komutu kullanın:

    export DB_HOST=$(az postgres flexible-server show \
        --resource-group ${RG_NAME} \
        --name ${SERVER_NAME} \
        --query "fullyQualifiedDomainName" \
        --output tsv)
    
  3. PostgreSQL sunucusunun Java Veritabanı Bağlantısı (JDBC) bağlantı URL'sini almak için aşağıdaki komutu kullanın:

    echo jdbc:postgresql://${DB_HOST}:5432/testdb
    

    Bu makalenin devamında PostgreSQL sunucusunun veri kaynağı bağlantı dizesi olarak kullandığınız çıkışı not edin.

Azure VM'lerinde JBoss EAP kümesi dağıtma

Bu bölümdeki adımlar sizi Azure VM'lerinde JBoss EAP kümesi dağıtmaya yönlendirir.

Azure VM'lerinde JBoss EAP Kümesi teklifini bulmak için aşağıdaki adımları kullanın:

  1. adresini ziyaret ederek https://aka.ms/publicportalAzure portalında oturum açın.

  2. Azure portalının üst kısmındaki arama çubuğuna JBoss EAP yazın. Arama sonuçlarında, Market bölümünde VM'lerde JBoss EAP Kümesi'ni seçin.

    Arama sonuçlarında Azure VM üzerinde JBoss EAP Sunucusu'nu gösteren Azure portalının ekran görüntüsü.

  3. Açılan menüde PAYG'nin seçili olduğundan emin olun.

Alternatif olarak, doğrudan Azure VM'lerinde JBoss EAP Kümesi teklifine de gidebilirsiniz. Bu durumda, sizin için doğru plan zaten seçilmiştir.

Her iki durumda da bu teklif, dağıtım zamanında Red Hat aboneliğinizi sağlayarak Azure VM'lerinde bir JBoss EAP kümesi dağıtır. Teklif, temel VM'ler için kullandıkça öde ödeme yapılandırması kullanarak kümeyi Red Hat Enterprise Linux üzerinde çalıştırır.

Aşağıdaki adımlar, aşağıdaki ekran görüntüsünde gösterilen Temel Bilgiler bölmesini nasıl doldurabileceğinizi gösterir.

VM'lerde JBoss EAP Kümesi Temel Bilgiler bölmesini gösteren Azure portalının ekran görüntüsü.

  1. Teklif sayfasında Oluştur'u seçin.
  2. Temel Bilgiler bölmesinde, Abonelik alanında gösterilen değerin önkoşullar bölümünde listelenen rollere sahip değerle aynı olduğundan emin olun.
  3. Teklifi boş bir kaynak grubuna dağıtmanız gerekir. Kaynak grubu alanında Yeni oluştur'u seçin ve kaynak grubu için bir değer girin. Kaynak gruplarının bir abonelik içinde benzersiz olması gerektiğinden, benzersiz bir ad seçin. Benzersiz adlara sahip olmak için, baş harflerinizin, bugünün tarihinin ve bazı tanımlayıcıların birleşimini kullanmak kolay bir yoldur. Örneğin, ejb040323jbosseapcluster.
  4. Örnek ayrıntıları'nın altında dağıtım için bölgeyi seçin.
  5. Sanal makine boyutu için varsayılan VM boyutunu değiştirmeyin.
  6. JDK sürümü için OpenJDK 17 varsayılan seçeneğini değiştirmeyin.
  7. Kullanıcı adı için varsayılan jbossuser değerini değiştirmeyin.
  8. Kimlik doğrulama türü için varsayılan Parola seçeneğini değiştirmeyin.
  9. Parola için bir parola girin. Parolayı onayla için aynı değeri kullanın.
  10. Oluşturulacak sanal makine sayısı için 3 kullanın.
  11. İsteğe Bağlı Temel Yapılandırma'nın altında, isteğe bağlı yapılandırma için Varsayılanları kabul et için evet seçeneğini bırakın.
  12. Temel Bilgiler bölmesinin en altına gidin ve Rapor sorunları, yardım alma ve geri bildirim paylaşma için yararlı bağlantılara dikkat edin.
  13. İleri: JBoss EAP Ayarları'nı seçin.

Aşağıdaki adımlar, aşağıdaki ekran görüntüsünde gösterilen JBoss EAP Ayarları bölmesini nasıl doldurabileceğinizi gösterir.

VM'ler JBoss EAP Ayarları bölmesinde JBoss EAP Kümesini gösteren Azure portalının ekran görüntüsü.

  1. Küme oluşturmak için Yönetilen etki alanı veya tek başına konakları kullanma için varsayılan Yönetilen etki alanı seçeneğini değiştirmeyin.
  2. JBoss EAP Yöneticisi kullanıcı adı için varsayılan jbossadmin değerini değiştirmeyin.
  3. JBoss EAP parolası için bir JBoss EAP parolası sağlayın. Parolayı onayla için aynı değeri kullanın. Değeri daha sonra kullanmak üzere bir kenara kaydedin.
  4. Mevcut Red Hat Uydu Sunucusuna Bağlan için varsayılan Hayır seçeneğini değiştirmeyin.
  5. İleri: Azure Uygulaması Lication Gateway'i seçin.

Aşağıdaki adımlar, aşağıdaki ekran görüntüsünde gösterilen Azure Uygulaması Lication Gateway bölmesini nasıl doldurabileceğinizi gösterir.

VM'lerde JBoss EAP Kümesi Azure Uygulaması lication Ağ Geçidi bölmesini gösteren Azure portalının ekran görüntüsü.

  1. Azure Uygulaması lication Gateway'e bağlanın mı? için Evet'i seçin.

  2. İleri: Ağ'ı seçin.

    Bu bölme, JBoss EAP kümesinin dağıtıldığı sanal ağı ve alt ağı özelleştirmenizi sağlar. Sanal ağlar hakkında bilgi için bkz . Sanal ağ oluşturma, değiştirme veya silme. Bu bölmedeki varsayılan değerleri kabul edin.

  3. İleri: Veritabanı'ı seçin.

Aşağıdaki adımlarda, aşağıdaki ekran görüntüsünde gösterilen Veritabanı bölmesini doldurma ve dağıtımı başlatma adımları gösterilmektedir.

VM'ler Veritabanı bölmesinde JBoss EAP Kümesini gösteren Azure portalının ekran görüntüsü.

  1. Veritabanına bağlanın mı? için Evet'i seçin.
  2. Veritabanı türünü seçin için PostgreSQL'i seçin.
  3. JNDI adı için java:jboss/datasources/JavaEECafeDB yazın.
  4. Veri kaynağı bağlantı dizesi (jdbc:postgresql://host:port/<database>)için daha önce kaydettiğiniz PostgreSQL sunucusunun JDBC bağlantı URL'sini> sağlayın.<><
  5. Veritabanı kullanıcı adı için testuser değerini doldurun.
  6. Veritabanı parolası için daha önce belirttiğiniz yer tutucunun <postgresql-admin-password>değerini belirtin. Parolayı onayla için aynı değeri kullanın.
  7. Gözden geçir ve oluştur’u seçin. Yeşil Doğrulama Başarılı iletisinin en üstte göründüğünden emin olun. İleti görünmüyorsa doğrulama sorunlarını düzeltin ve gözden geçir ve yeniden oluştur'u seçin.
  8. Oluştur'u belirleyin.
  9. Dağıtım devam ediyor sayfasında dağıtımın ilerleme durumunu izleyin.

Seçtiğiniz bölgedeki ağ koşullarına ve diğer etkinliklere bağlı olarak dağıtımın tamamlanması 35 dakika kadar sürebilir. Bundan sonra dağıtım sayfasında Dağıtımınız tamamlandı metnini görmeniz gerekir.

Dağıtımın işlevselliğini doğrulama

Red Hat JBoss Enterprise Application Platform yönetim konsolundan Azure VM'lerinde bir JBoss EAP kümesi için dağıtımın işlevselliğini doğrulamak için aşağıdaki adımları kullanın:

  1. Dağıtım sayfasında Çıkışlar'ı seçin.

  2. adminConsole öğesinin yanındaki kopyala simgesini seçin.

    adminConsole URL'sinin vurgulandığı dağıtım çıkışlarını gösteren Azure portalının ekran görüntüsü.

  3. URL'yi İnternet'e bağlı bir web tarayıcısına yapıştırın ve Enter tuşuna basın. Aşağıdaki ekran görüntüsünde gösterildiği gibi tanıdık Red Hat JBoss Enterprise Application Platform yönetim konsolu oturum açma ekranını görmeniz gerekir.

    JBoss EAP yönetim konsolu oturum açma ekranının ekran görüntüsü.

  4. JBoss EAP Yöneticisi kullanıcı adı için jbossadmin girin Parola için daha önce belirttiğiniz JBoss EAP parolasının değerini belirtin, ardından Oturum aç'ı seçin.

  5. Aşağıdaki ekran görüntüsünde gösterildiği gibi tanıdık Red Hat JBoss Enterprise Application Platform yönetim konsolu karşılama sayfasını görmeniz gerekir.

    JBoss EAP yönetim konsolu karşılama sayfasının ekran görüntüsü.

  6. Çalışma Zamanı sekmesini seçin. Gezinti bölmesinde Topoloji'yi seçin. Aşağıdaki ekran görüntüsünde gösterildiği gibi kümenin bir etki alanı denetleyicisi yöneticisi ve iki çalışan düğümü içerdiğini görmeniz gerekir:

    JBoss EAP yönetim konsolu Çalışma Zamanı topolojisinin ekran görüntüsü.

  7. Yapılandırma sekmesini seçin. Gezinti bölmesinde Profiller>ha>Datasources & Drivers>Datasources'ı seçin. Aşağıdaki ekran görüntüsünde gösterildiği gibi dataSource-postgresql veri kaynağının listelendiğini görmeniz gerekir:

    Veri Kaynakları'nın seçili olduğu JBoss EAP yönetim konsolu Yapılandırma sekmesinin ekran görüntüsü.

Yönetim konsolunu açık bırakın. Sonraki bölümde JBoss EAP kümesine örnek bir uygulama dağıtmak için bu uygulamayı kullanırsınız.

Uygulamayı JBoss EAP kümesine dağıtma

Java EE Cafe örnek uygulamasını Red Hat JBoss EAP kümesine dağıtmak için aşağıdaki adımları kullanın:

  1. Java EE Cafe örneğini oluşturmak için aşağıdaki adımları kullanın. Bu adımlarda Git ve Maven yüklü yerel bir ortamınız olduğu varsayılır:

    1. GitHub'dan kaynak kodu kopyalamak için aşağıdaki komutu kullanın ve makalenin bu sürümüne karşılık gelen etiketi gözden geçirin:

      git clone https://github.com/Azure/rhel-jboss-templates.git --branch 20240904 --single-branch
      

      metnini You are in 'detached HEAD' stateiçeren bir hata iletisi görürseniz, bunu güvenle yoksayabilirsiniz.

    2. Kaynak kodu oluşturmak için aşağıdaki komutu kullanın:

      mvn clean install --file rhel-jboss-templates/eap-coffee-app/pom.xml
      

      Bu komut rhel-jboss-templates/eap-coffee-app/target/javaee-café.war dosyasını oluşturur. Bu dosyayı sonraki adımda karşıya yükleyeceksiniz.

  2. Javaee-café.war dosyasını İçerik Deposuna yüklemek için Red Hat JBoss Enterprise Application Platform yönetim konsolunda aşağıdaki adımları kullanın.

    1. Red Hat JBoss EAP yönetim konsolunun Dağıtımlar sekmesinden gezinti panelinde İçerik Deposu'nu seçin.

    2. Ekle'yi ve ardından İçeriği Karşıya Yükle'yi seçin.

      İçeriği Karşıya Yükle menü öğesinin vurgulandığı JBoss EAP yönetim konsolu Dağıtımlar sekmesinin ekran görüntüsü.

    3. Javaee-café.war dosyasını seçmek için tarayıcı dosya seçicisini kullanın.

    4. İleri'yi seçin.

    5. Sonraki ekranda varsayılanları kabul edin ve ardından Son'u seçin.

    6. İçeriği görüntüle'yi seçin.

  3. Uygulamasına dağıtmak main-server-groupiçin aşağıdaki adımları kullanın:

    1. İçerik Deposu'ndan javaee-café.war öğesini seçin.

    2. Açılan menüyü açın ve Dağıt'ı seçin.

    3. javaee-café.war dağıtmak için sunucu grubu olarak main-server-group öğesini seçin.

    4. Dağıtımı başlatmak için Dağıt'ı seçin. Aşağıdaki ekran görüntüsüne benzer bir bildirim görmeniz gerekir:

      Başarılı dağıtım bildiriminin ekran görüntüsü.

Java EE uygulamasını dağıtmayı tamamladınız. Uygulamaya erişmek ve tüm ayarları doğrulamak için aşağıdaki adımları kullanın:

  1. Azure Uygulaması lication Gateway'in genel IP adresini almak için aşağıdaki komutu kullanın. Yer tutucuyu <resource-group-name> JBoss EAP kümesinin dağıtıldığı kaynak grubunun adıyla değiştirin.

    az network public-ip show \
        --resource-group <resource-group-name> \
        --name gwip \
        --query '[ipAddress]' \
        --output tsv
    
  2. Dağıtılan Azure Uygulaması lication Gateway'in genel IP adresi olan çıktıyı kopyalayın.

  3. İnternet'e bağlı bir web tarayıcısı açın.

  4. URL'si http://<gateway-public-ip-address>/javaee-cafeile uygulamaya gidin. Yer tutucuyu<gateway-public-ip-address>, daha önce kopyaladığınız Azure Uygulaması Lication Gateway'in genel IP adresiyle değiştirin.

  5. Kahve eklemeyi ve kaldırmayı deneyin.

Kaynakları temizleme

Azure ücretlerinden kaçınmak için gereksiz kaynakları temizlemeniz gerekir. Azure VM'lerinde dağıtılan JBoss EAP kümesine artık ihtiyacınız kalmadığında JBoss EAP sunucularının kaydını kaldırın ve Azure kaynaklarını kaldırın.

JBoss EAP sunucularının ve VM'lerin kaydını Red Hat abonelik yönetiminden kaldırmak için aşağıdaki komutu çalıştırın. Yer tutucuyu <resource-group-name> JBoss EAP kümesinin dağıtıldığı kaynak grubunun adıyla değiştirin.

# Unregister domain controller
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm-adminVM \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

# Unregister host controllers
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"
az vm run-command invoke \
    --resource-group <resource-group-name> \
    --name jbosseapVm1 \
    --command-id RunShellScript \
    --scripts "sudo subscription-manager unregister"

JBoss EAP kümesinin ve PostgreSQL için Azure Veritabanı esnek sunucusunun dağıtıldığı iki kaynak grubunu kaldırmak için aşağıdaki komutları çalıştırın. Yer tutucuyu <resource-group-name> JBoss EAP kümesinin dağıtıldığı kaynak grubunun adıyla değiştirin. Ortam değişkeninin $RG_NAME PostgreSQL esnek sunucusunun dağıtıldığı kaynak grubunun adıyla ayarlandığından emin olun.

az group delete --name <resource-group-name> --yes --no-wait
az group delete --name $RG_NAME --yes --no-wait

Sonraki adımlar

Azure'da JBoss EAP dağıtma seçenekleriniz hakkında daha fazla bilgi edinin: