التشغيل السريع: تشغيل أول تطبيق Java في Azure Container Apps
توضح لك هذه المقالة كيفية نشر نموذج تطبيق Spring PetClinic للتشغيل على Azure Container Apps. بدلا من إنشاء Dockerfile يدويا واستخدام سجل حاوية مباشرة، يمكنك نشر تطبيق Java مباشرة من ملف Java Archive (JAR) أو ملف أرشيف تطبيق ويب (WAR).
بنهاية هذا البرنامج التعليمي، يمكنك نشر تطبيق ويب، والذي يمكنك إدارته من خلال مدخل Microsoft Azure.
الصورة التالية هي لقطة شاشة لكيفية ظهور تطبيقك بمجرد نشره في Azure.
المتطلبات الأساسية
| المتطلبات | الإرشادات |
|---|---|
| حساب Azure | إذا لم يكن لديك حساب، فبادر بإنشاء حساب مجانا. تحتاج إلى إذن المساهم أو المالك على اشتراك Azure للمتابعة. راجع تعيين أدوار Azure باستخدام مدخل Microsoft Azure للحصول على التفاصيل. |
| حساب GitHub | احصل على واحد مجانا. |
| git | تثبيت git |
| Azure CLI | قم بتثبيت Azure CLI. |
| ملحق CLI لتطبيقات الحاوية | استخدم الإصدار 0.3.47 أو أعلى. az extension add --name containerapp --upgrade --allow-preview استخدم الأمر لتثبيت أحدث إصدار. |
| Java | تثبيت Java Development Kit. استخدم الإصدار 17 أو أحدث. |
| Apache Maven | قم بتنزيل Apache Maven وتثبيته. |
تحضير المشروع
استنساخ نموذج تطبيق Spring PetClinic إلى جهازك.
git clone https://github.com/spring-projects/spring-petclinic.git
git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
إنشاء المشروع
غير إلى المجلد spring-petclinic .
cd spring-petclinic
قم بتنظيف منطقة بناء Maven، وتحويل التعليمات البرمجية للمشروع برمجيا، وإنشاء ملف JAR، كل ذلك أثناء تخطي أي اختبارات.
mvn clean verify
بعد تنفيذ أمر الإنشاء، يتم إنشاء ملف يسمى petclinic.jar في المجلد /target .
إشعار
إذا لزم الأمر، يمكنك تحديد إصدار Tomcat في متغيرات بيئة بناء Java.
تغيير إلى المجلد spring-framework-petclinic .
cd spring-framework-petclinic
قم بتنظيف منطقة بناء Maven، وتحويل التعليمات البرمجية للمشروع برمجيا، وإنشاء ملف WAR، كل ذلك أثناء تخطي أي اختبارات.
mvn clean verify
بعد تنفيذ أمر الإنشاء، يتم إنشاء ملف يسمى petclinic.war في المجلد /target .
نشر المشروع
نشر حزمة JAR إلى Azure Container Apps.
إشعار
إذا لزم الأمر، يمكنك تحديد إصدار JDK في متغيرات بيئة بناء Java.
الآن يمكنك نشر ملف WAR الخاص بك باستخدام az containerapp up الأمر CLI.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP> \
--subscription <SUBSCRIPTION_ID>\
--location <LOCATION> \
--environment <ENVIRONMENT_NAME> \
--artifact <JAR_FILE_PATH_AND_NAME> \
--ingress external \
--target-port 8080 \
--query properties.configuration.ingress.fqdn
إشعار
إصدار JDK الافتراضي هو 17. إذا كنت بحاجة إلى تغيير إصدار JDK للتوافق مع التطبيق الخاص بك، يمكنك استخدام الوسيطة --build-env-vars BP_JVM_VERSION=<YOUR_JDK_VERSION> لضبط رقم الإصدار.
يمكنك العثور على متغيرات بيئة بناء أكثر قابلية للتطبيق في متغيرات بيئة بناء Java.
نشر حزمة WAR إلى Azure Container Apps.
الآن يمكنك نشر ملف WAR الخاص بك باستخدام az containerapp up الأمر CLI.
az containerapp up \
--name <CONTAINER_APP_NAME> \
--resource-group <RESOURCE_GROUP> \
--subscription <SUBSCRIPTION>\
--location <LOCATION> \
--environment <ENVIRONMENT_NAME> \
--artifact <WAR_FILE_PATH_AND_NAME> \
--build-env-vars BP_TOMCAT_VERSION=10.* \
--ingress external \
--target-port 8080 \
--query properties.configuration.ingress.fqdn
إشعار
إصدار Tomcat الافتراضي هو 9. إذا كنت بحاجة إلى تغيير إصدار Tomcat للتوافق مع التطبيق الخاص بك، يمكنك استخدام الوسيطة --build-env-vars BP_TOMCAT_VERSION=<YOUR_TOMCAT_VERSION> لضبط رقم الإصدار.
في هذا المثال، يتم تعيين إصدار Tomcat إلى 10 (بما في ذلك أي إصدارات ثانوية) عن طريق تعيين BP_TOMCAT_VERSION=10.* متغير البيئة.
يمكنك العثور على متغيرات بيئة بناء أكثر قابلية للتطبيق في متغيرات بيئة بناء Java.
التحقق من حالة التطبيق
في هذا المثال، containerapp up يتضمن الأمر الوسيطة --query properties.configuration.ingress.fqdn التي ترجع اسم المجال المؤهل بالكامل (FQDN)، والمعروف أيضا باسم عنوان URL للتطبيق.
عرض التطبيق عن طريق لصق عنوان URL هذا في مستعرض. يجب أن يشبه تطبيقك لقطة الشاشة التالية.