Maven ile Azure Uygulaması Hizmetine KumuluzEE Web Uygulaması Dağıtma
Bu hızlı başlangıçta, Bir KumuluzEE uygulamasını Linux üzerinde Azure Uygulaması Service'e dağıtmak üzere Azure Uygulaması Service Web Apps için Maven Eklentisi'ni kullanacaksınız. Uygulamanızın bağımlılıklarını, çalışma zamanını ve yapılandırmasını dağıtılabilir tek bir yapıtta birleştirmek istediğinizde Tomcat ve WAR dosyaları yerine Java SE dağıtımını seçebilirsiniz.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Önkoşullar
- Yerel olarak veya Azure Cloud Shell aracılığıyla Azure CLI.
- Desteklenen bir Java Development Kit (JDK). Azure'da geliştirme yaparken kullanılabilecek JDK'ler hakkında daha fazla bilgi için bkz . Azure ve Azure Stack'te Java desteği.
- Apache Maven, sürüm 3.
Azure CLI'da oturum açma
KumuluzEE uygulamanızı dağıtan Maven Eklentisini edinmenin en basit ve en kolay yolu Azure CLI kullanmaktır.
Azure CLI’yi kullanarak Azure hesabınızda oturum açın:
az login
Yönergeleri izleyerek oturum açma işlemlerini tamamlayın.
MicroProfile Starter'dan örnek uygulama oluşturma
Bu bölümde bir KumuluzEE uygulaması oluşturacak ve yerel olarak test edeceğiz.
Java SE 8 temel Projesi oluşturma
Bir web tarayıcısı açın ve MicroProfile Starter sitesine gidin.
Aşağıdaki gibi bir alan girin veya seçin.
Alan Değer groupId com.microsoft.azure.samples.kumuluzee Artifactıd kumuluzEE-hello-azure MicroProfile Sürümü MP 3.2 Java SE Sürümü Java 8 MicroProfile Runtime KumuluzEE Belirtim örnekleri Ölçümler, OpenAPI Projeyi indirmek için İnDİr'i seçin.
Arşiv dosyasının sıkıştırmasını açın; örneğin:
unzip kumuluzEE-hello-azure.zip
Uygulamayı Yerel ortamda çalıştırma
Tamamlanmış projenin dizinine geçin; örneğin:
cd kumuluzEE-hello-azure/
Maven kullanarak projeyi oluşturma; örneğin:
mvn clean package
Aşağıdaki komutu kullanarak Uygulamayı çalıştırın:
java -jar target/kumuluzEE-hello-azure.jar
Web tarayıcısını kullanıp web uygulamasına yerel olarak göz atarak uygulamayı test edin. Örneğin curl kullanılabiliyorsa aşağıdaki komutu kullanabilirsiniz:
curl http://localhost:8080/data/hello
Şu iletinin görüntülendiğini görmeniz gerekir: Merhaba Dünya.
Azure App Service için Maven Eklentisi’ni yapılandırma
Bu bölümde KumuluzEE proje pom.xml dosyasını maven'in uygulamayı Linux üzerinde Azure Uygulaması Hizmeti'ne dağıtabilmesi için yapılandıracaksınız.
pom.xml dosyasını bir kod düzenleyicisinde açın.
<build>
pom.xml dosyasının bölümünde etiketin içine aşağıdaki<plugin>
girdiyi<plugins>
ekleyin.<build> <finalName>kumuluzEE-hello-azure</finalName> <plugins> <plugin> <groupId>com.microsoft.azure</groupId> <artifactId>azure-webapp-maven-plugin</artifactId> <version>1.10.0</version> </plugin> </plugins> </build>
Ardından dağıtımı yapılandırabilirsiniz. Aşağıdaki Maven komutunu çalıştırın:
mvn azure-webapp:config
İstendiğinde aşağıdaki seçenekleri belirtin:
Giriş Alanı Giriş/Değer Seçme İşletim sistemi için değer tanımlama(Varsayılan: Linux): 1. linux javaVersion için değer tanımlama(Varsayılan: Java 8): 2. Java 8 Onayla (E/H) y Bu komut aşağıdaki örneğe benzer bir çıktı oluşturur:
[INFO] Scanning for projects... [INFO] [INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >----- [INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure --- 1. linux [*] 2. windows 3. docker Enter index to use: 1 Define value for javaVersion(Default: Java 8): 1. Java 11 2. Java 8 [*] Enter index to use: 2 Please confirm webapp properties AppName : kumuluzEE-hello-azure-1601006602397 ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg Region : westeurope PricingTier : PremiumV2_P1v2 OS : Linux RuntimeStack : JAVA 8-jre8 Deploy to slot : false Confirm (Y/N)? : y [INFO] Saving configuration to pom. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 44.223 s [INFO] Finished at: 2020-09-25T13:04:02+09:00 [INFO] ------------------------------------------------------------------------
<appSettings>
bölümünü ,WEBSITES_PORT
veWEBSITES_CONTAINER_START_TIME_LIMIT
bölümlerine<configuration>
PORT
ekleyin. içinazure-webapp-maven-plugin
XML girdiniz aşağıdaki örneğe benzer olacaktır:<plugin> <groupId>com.microsoft.azure</groupId> <artifactId>azure-webapp-maven-plugin</artifactId> <version>1.10.0</version> <configuration> <schemaVersion>V2</schemaVersion> <resourceGroup>microprofile</resourceGroup> <appName>kumuluzEE-hello-azure-1601006602397</appName> <pricingTier>P1v2</pricingTier> <region>japaneast</region> <runtime> <os>linux</os> <javaVersion>jre8</javaVersion> <webContainer>jre8</webContainer> </runtime> <appSettings> <property> <name>PORT</name> <value>8080</value> </property> <property> <name>WEBSITES_PORT</name> <value>8080</value> </property> <property> <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name> <value>600</value> </property> </appSettings> <deployment> <resources> <resource> <directory>${project.basedir}/target</directory> <includes> <include>*.jar</include> </includes> </resource> </resources> </deployment> </configuration> </plugin>
Uygulamayı Azure’da dağıtma
Bu makalenin önceki bölümlerinde yer alan tüm ayarları yapılandırdıktan sonra web uygulamanızı Azure'a dağıtmaya hazırsınız demektir. Bunu yapmak için aşağıdaki adımları kullanın:
Pom.xml dosyasında herhangi bir değişiklik yaptıysanız, daha önce kullandığınız komut isteminde veya terminal penceresinde Maven’i kullanarak JAR dosyasını yeniden derleyin; örneğin:
mvn clean package
Maven’i kullanarak web uygulamanızı Azure’a dağıtın; örneğin:
mvn azure-webapp:deploy
Dağıtım başarılı olursa aşağıdaki çıkışı görürsünüz.
[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------
Maven, web uygulamanızı Azure'a dağıtır. Web uygulaması veya web uygulaması planı henüz yoksa, sizin için oluşturulur. Web uygulamasının çıkışta gösterilen URL’de görünür olması birkaç dakika sürebilir. Web tarayıcısında URL’ye gidin. Aşağıdaki ekranı görmeniz gerekir.
Web'iniz dağıtıldığında Azure portalı üzerinden yönetebilirsiniz.
Web uygulamanız mikroprofil kaynak grubunda listelenir.
Web uygulamanızın Genel Bakış sayfasında Gözat'ı seçerek web uygulamanıza erişebilirsiniz. Dağıtımın başarılı ve Çalışıyor olduğunu doğrulayın.
Çalışan App Service'ten günlük akışını onaylayın
Çalışan App Service'ten günlükleri görebilirsiniz (veya "takip edebilirsiniz"). Site kodundaki tüm çağrılar console.log
terminalde görüntülenir.
az webapp log tail \
--resource-group microprofile \
--name kumuluzEE-hello-azure-1601006602397
Kaynakları temizleme
Artık Azure kaynakları gerekli değilse, kaynak grubunu silerek dağıttığınız kaynakları temizleyin.
- Azure portalında sol menüden Kaynak grubu’nu seçin.
- Ada göre filtrele alanına mikroprofil girin; bu öğreticide oluşturulan kaynak grubunda bu ön ek olmalıdır.
- Bu öğreticide oluşturulan kaynak grubunu seçin.
- Üstteki menüden Kaynak grubunu sil’i seçin.
Sonraki adımlar
MicroProfile ve Azure hakkında daha fazla bilgi edinmek için Azure'da MicroProfile belge merkezine geçin.
Ek kaynaklar
Bu makalede tartışılan çeşitli teknolojiler hakkında daha fazla bilgi için aşağıdaki makalelere bakın: