نموذج البرنامج النصي قبل وبعد النشر

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

يوضح النموذج التالي كيفية استخدام برنامج نصي لما قبل النشر وبعده مع التكامل والتسليم المستمر في Azure Data Factory.

تثبيت برنامج Azure PowerShell

ثبّت أحدث وحدات نمطية Azure PowerShell باتباع الإرشادات الواردة في كيفية تثبيتAzure PowerShell وتكوينه.

تحذير

تأكد من استخدام PowerShell Core في مهمة ADO لتشغيل البرنامج النصي

البرنامج النصي لما قبل النشر وبعده

توجد نماذج البرامج النصية لإيقاف/بدء المشغلات وتحديث المعلمات العامة خلال عملية الإصدار (CICD) في صفحة GitHub الرسمية لـ Azure Data Factory.

إشعار

استخدم PrePostDeploymentScript.Ver2.ps1 إذا كنت ترغب في إيقاف تشغيل/ تشغيل المشغلات التي تم تعديلها فقط بدلاً من إيقاف تشغيل/ تشغيل جميع المشغلات أثناء CI/CD.

تنفيذ البرنامج النصي والمعلمات

يمكن استخدام البرنامج النصي للنموذج التالي لإيقاف المشغلات قبل النشر وإعادة تشغيلها بعد ذلك. يتضمن النص البرمجي أيضاً تعليمات برمجية لحذف الموارد التي تمت إزالتها. احفظ البرنامج النصي في مستودع Azure DevOps git وقم بالرجوع إليه عبر مهمة Azure PowerShell بأحدث إصدار من Azure PowerShell.

عند تشغيل برنامج نصي للتشغيل المسبق، تحتاج إلى تحديد تباين المعلمات التالية في حقل وسيطات البرنامج النصي.

-armTemplate "$(System.DefaultWorkingDirectory)/<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false

عند تشغيل برنامج نصي postdeployment، تحتاج إلى تحديد تباين المعلمات التالية في حقل Script Arguments .

-armTemplate "$(System.DefaultWorkingDirectory)/<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $false -deleteDeployment $true

إشعار

تُستخدم العلامة -deleteDeployment لتحديد حذف مدخل نشر ADF من محفوظات النشر في ARM.

مهمة Azure PowerShell

تنفيذ البرنامج النصي والمعلمات - مسارات YAML

تقوم التعليمات البرمجية YAML التالية بتنفيذ برنامج نصي يمكن استخدامه لإيقاف المشغلات قبل النشر وإعادة تشغيلها بعد ذلك. يتضمن النص البرمجي أيضاً تعليمات برمجية لحذف الموارد التي تمت إزالتها. إذا كنت تتبع الخطوات الموضحة في تدفق CI/CD جديد، يتم تصدير هذا البرنامج النصي كجزء من البيانات الاصطناعية التي تم إنشاؤها عبر حزمة نشر npm.

إيقاف مشغلات ADF

 - task: AzurePowerShell@5
            displayName: Stop ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../

بدء تشغيل مشغلات ADF

          - task: AzurePowerShell@5
            displayName: Start ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name>-predeployment $false -deleteDeployment $true
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../