AzureSpringCloud@0 - مهمة Azure Spring Apps v0

تنشر هذه المهمة التطبيقات إلى Azure Spring Apps وتدير عمليات التوزيع هذه.

هام

هذه المهمة مدعومة في خطط Azure Spring Apps Basic/Standard وEnterprise. لمزيد من المعلومات، راجع أتمتة عمليات توزيع التطبيقات إلى Azure Spring Apps.

بناء الجملة

# Azure Spring Apps v0
# Deploy applications to Azure Spring Apps and manage deployments.
- task: AzureSpringCloud@0
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    Action: 'Deploy' # 'Deploy' | 'Set Production' | 'Delete Staging Deployment'. Required. Action. Default: Deploy.
    AzureSpringCloud: # string. Required. Azure Spring Apps Name. 
    AppName: # string. Required. App. 
    #DeploymentType: 'Artifacts' # 'Artifacts' | 'CustomContainer'. Optional. Use when Action = Deploy. Deployment Type. Default: Artifacts.
    #UseStagingDeployment: true # boolean. Optional. Use when Action = Deploy || Action = Set Production. Use Staging Deployment. Default: true.
    #CreateNewDeployment: false # boolean. Optional. Use when Action = Deploy && UseStagingDeployment = false. Create a new staging deployment if one does not exist. Default: false.
    #DeploymentName: # string. Optional. Use when UseStagingDeployment = false && Action != Delete Staging Deployment. Deployment. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.jar' # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.jar.
    #RegistryServer: 'docker.io' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Server. Default: docker.io.
    #RegistryUsername: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Username. 
    #RegistryPassword: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Registry Password. 
    #ImageName: 'hello-world:v1' # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Name and Tag. Default: hello-world:v1.
    #ImageCommand: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Command. 
    #ImageArgs: # string. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Image Arguments. 
    #ImageLanguageFramework: # 'springboot'. Optional. Use when Action = Deploy && DeploymentType = CustomContainer. Language Framework. 
  # Application and Configuration Settings
    #Builder: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Builder. 
    #EnvironmentVariables: # string. Optional. Use when Action = Deploy. Environment Variables. 
    #JvmOptions: # string. Optional. Use when Action = Deploy && DeploymentType = Artifacts. JVM Options. 
    #RuntimeVersion: 'Java_11' # 'Java_8' | 'Java_11' | 'Java_17' | 'Java_21' | 'NetCore_31'. Optional. Use when Action = Deploy && DeploymentType = Artifacts. Runtime Version. Default: Java_11.
    #DotNetCoreMainEntryPath: # string. Optional. Use when RuntimeVersion = NetCore_31. Main Entry Path. 
    #Version: # string. Optional. Use when Action = Deploy. Version.

الإدخالات

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب

يحدد اشتراك Azure Resource Manager للتوزيع.

Action - العمل
string. مطلوب القيم المسموح بها: Deploy، Set Production (تعيين توزيع الإنتاج)، Delete Staging Deployment. القيمة الافتراضية: Deploy.

الإجراء الذي سيتم تنفيذه على Azure Spring Apps.

AzureSpringCloud - اسم Azure Spring Apps
string. مطلوب

اسم أو معرف المورد لمثيل Azure Spring Apps المراد توزيعه.

AppName - التطبيق
string. مطلوب

اسم تطبيق Azure Spring Apps المراد نشره. يجب أن يكون التطبيق موجودا قبل تنفيذ المهمة.

DeploymentType - نوع التوزيع
string. ‏‏اختياري. استخدم عندما Action = Deploy. القيم المسموح بها: Artifacts، CustomContainer (حاوية مخصصة). القيمة الافتراضية: Artifacts.

للتوزيع باستخدام التعليمات البرمجية المصدر أو حزمة Java، اختر "Artifacts"؛ للنشر باستخدام صورة الحاوية، اختر "حاوية مخصصة".

UseStagingDeployment - استخدام التوزيع المرحلي
boolean. ‏‏اختياري. استخدم عندما Action = Deploy || Action = Set Production. القيمة الافتراضية: true.

في وقت تشغيل المهمة، يحدد هذا الإدخال تلقائيا التوزيع الذي تم تعيينه ك staging.

إذا تم تعيينها إلى true، فقم بتطبيق المهمة على التوزيع الذي تم تعيينه كنشر مرحلي في وقت التنفيذ. إذا تم حذفها، يجب تعيين المعلمة DeploymentName .

CreateNewDeployment - إنشاء توزيع مرحلي جديد إذا لم يكن موجودا.
boolean. ‏‏اختياري. استخدم عندما Action = Deploy && UseStagingDeployment = false. القيمة الافتراضية: false.

إذا تم تعيينه إلى true، وكان التوزيع المحدد من قبل DeploymentName غير موجود في وقت التنفيذ، فسيتم إنشاؤه. إذا تم حذفها، يجب تعيين المعلمة DeploymentName .

DeploymentName - نشر
string. ‏‏اختياري. استخدم عندما UseStagingDeployment = false && Action != Delete Staging Deployment.

التوزيع الذي سيتم تطبيق هذه المهمة عليه. إذا لم تكن تستخدم عمليات النشر باللونين الأزرق والأخضر، فقم بتعيين هذا الحقل إلى default. يجب أن تبدأ القيمة بحرف وأن تتكون من أحرف صغيرة وأرقام فقط.

Package - الحزمة أو المجلد
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = Artifacts. القيمة الافتراضية: $(System.DefaultWorkingDirectory)/**/*.jar.

مسار الملف إلى الحزمة أو المجلد الذي يحتوي على محتويات تطبيق Azure Spring Apps (.jar ملف ل Java، .zip ل .NET Core).
المتغيرات (إصدار البناء | ) وأحرف البدل مدعومة.
على سبيل المثال،⁧$(System.DefaultWorkingDirectory)/**/*.jar⁩

Builder - منشئ
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = Artifacts.

حدد منشئ VMware Tanzu® Build Service™، ويمكن استخدام هذا في مستوى المؤسسة.
للحصول على وصف مفصل، يرجى التحقق من استخدام خدمة بناء Tanzu.

RegistryServer - خادم التسجيل
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer. القيمة الافتراضية: docker.io.

سجل صورة الحاوية. الافتراضي: docker.io.

RegistryUsername - اسم مستخدم السجل
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer.

اسم المستخدم لسجل الحاوية.

RegistryPassword - كلمة مرور السجل
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer.

كلمة مرور سجل الحاوية.

ImageName - اسم الصورة والعلامة
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer. القيمة الافتراضية: hello-world:v1.

علامة صورة الحاوية.

ImageCommand - أمر الصورة
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer.

أمر صورة الحاوية.

ImageArgs - وسيطات الصور
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer.

وسيطات صورة الحاوية.

ImageLanguageFramework - إطار عمل اللغة
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = CustomContainer. القيم المسموح بها: springboot.

EnvironmentVariables - متغيرات البيئة
string. ‏‏اختياري. استخدم عندما Action = Deploy.

متغيرات البيئة التي سيتم إدخالها باستخدام بناء الجملة -key value (على سبيل المثال: -CUSTOMER_NAME Contoso-WEBSITE_TIME_ZONE). يجب إحاطة القيم التي تحتوي على مسافات بعلامات اقتباس مزدوجة (على سبيل المثال: "Eastern Standard Time").

JvmOptions - خيارات JVM
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = Artifacts.

تحرير خيارات JVM للتطبيق. سلسلة تحتوي على خيارات JVM، مثل -Xms1024m -Xmx2048m.

RuntimeVersion - إصدار وقت التشغيل
string. ‏‏اختياري. استخدم عندما Action = Deploy && DeploymentType = Artifacts. القيم المسموح بها: Java_8 (Java 8)، Java_11 (Java 11)، Java_17 (Java 17)، Java_21 (Java 21)، NetCore_31 (.Net Core 3.1). القيمة الافتراضية: Java_11.

إصدار وقت التشغيل الذي سيتم تشغيل التطبيق عليه.

DotNetCoreMainEntryPath - مسار الإدخال الرئيسي
string. ‏‏اختياري. استخدم عندما RuntimeVersion = NetCore_31.

المسار إلى .NET القابل للتنفيذ بالنسبة إلى الجذر المضغوط.

Version - الإصدار
string. ‏‏اختياري. استخدم عندما Action = Deploy.

إصدار التوزيع. إذا لم يتم تعيينه، يتم ترك الإصدار دون تغيير.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

تحدد هذه المهمة متغيرات الإخراج التالية، والتي يمكنك استهلاكها في خطوات انتقال البيانات من الخادم والوظائف والمراحل.

testEndpoint
بعد إجراء "التوزيع" فقط. يحتوي على عنوان URL خاص للوصول إلى النشر المحدث.

الملاحظات

استخدم هذه المهمة لنشر التطبيقات إلى Azure Spring Apps وإدارة عمليات توزيع Azure Spring Cloud.

هام

هذه المهمة مدعومة في خطط Azure Spring Apps Basic/Standard وEnterprise. لمزيد من المعلومات، راجع أتمتة عمليات توزيع التطبيقات إلى Azure Spring Apps.

أمثلة

توضح الأمثلة التالية سيناريوهات الاستخدام الشائعة. لمزيد من المعلومات، راجع أتمتة عمليات توزيع التطبيقات إلى Azure Spring Apps.

حذف نشر مرحلي

يسمح لك الإجراء "حذف النشر المرحلي" بحذف النشر الذي لا يتلقى حركة مرور الإنتاج. يؤدي هذا إلى تحرير الموارد المستخدمة من النشر، ويفسح المجال لنشر مرحلي جديد:

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
  continueOnError: true # Don't fail the pipeline if a staging deployment doesn't already exist.
  inputs:
    continueOnError: true
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Delete Staging Deployment'
    AppName: customer-api
    AzureSpringCloud: contoso-dev-az-spr-cld

النشر

للإنتاج

يتم توزيع المثال التالي إلى توزيع الإنتاج الافتراضي في Azure Spring Apps. هذا هو سيناريو النشر الوحيد الممكن عند استخدام Basic SKU:

ملاحظة

يجب أن يرجع نمط البحث في الحزمة حزمة واحدة بالضبط. إذا كانت مهمة الإنشاء تنتج حزم JAR متعددة مثل sources.jarjavadoc.jar، فأنت بحاجة إلى تحسين نمط البحث بحيث يتطابق فقط مع البيانات الاصطناعية الثنائية للتطبيق.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: false
    DeploymentName: default
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

أزرق-أخضر

يتم توزيع المثال التالي إلى توزيع مرحلي موجود مسبقا. لن يتلقى هذا التوزيع حركة مرور الإنتاج حتى يتم تعيينه كنشر إنتاج.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Deploy'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true
    Package: '$(System.DefaultWorkingDirectory)/**/*customer-api*.jar'

لمزيد من التفاصيل حول عمليات النشر باللونين الأزرق والأخضر، بما في ذلك نهج بديل، راجع استراتيجيات التوزيع الأزرق والأخضر.

تعيين نشر الإنتاج

يعين المثال التالي التوزيع المرحلي الحالي كتشغيل، ما يؤدي إلى تبديل التوزيع الذي يتلقى حركة مرور الإنتاج بشكل فعال.

variables:
  azureSubscription: Contoso

steps:
- task: AzureSpringCloud@0
    inputs:
    azureSubscription: $(azureSubscription)
    Action: 'Set Production'
    AzureSpringCloud: contoso-dev-az-spr-cld
    AppName: customer-api
    UseStagingDeployment: true

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	2.104.1 أو أحدث
فئة المهمة	نشر