إدارة حزم Python 3 في Azure Automation

توضح هذه المقالة كيفية استيراد وإدارة واستخدام حزم Python 3 في Azure Automation التي تعمل على بيئة الاختبار المعزولة ل Azure وعمال دفتر التشغيل المختلط. يجب تنزيل حزم Python على عمال دفتر التشغيل المختلط لتنفيذ المهمة بنجاح. للمساعدة في تبسيط دفاتر التشغيل، يمكنك استخدام حزم Python لاستيراد الوحدات التي تحتاجها.

للحصول على معلومات حول إدارة حزم Python 2، راجع إدارة حزم Python 2.

حزم Python الافتراضية

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

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

إشعار

لا توجد حزم افتراضية مثبتة ل Python 3.10 (معاينة).

الحزم كملفات مصدر

تدعم Azure Automation حزمة Python التي تحتوي فقط على رمز Python ولا تتضمن ملحقات لغة أخرى أو تعليمات برمجية بلغات أخرى. ومع ذلك، قد لا تحتوي بيئة Azure Sandbox على المحولات البرمجية المطلوبة لثنائيات C/C++، لذلك يوصى باستخدام ملفات العجلة بدلا من ذلك.

إشعار

حاليا، يدعم Python 3.10 (معاينة) ملفات العجلة فقط.

فهرس حزمة Python (PyPI) هو مستودع للبرامج للغة برمجة Python. عند تحديد حزمة Python 3 لاستيرادها إلى حساب التنفيذ التلقائي الخاص بك من PyPI، لاحظ أجزاء اسم الملف التالية:

حدد إصدار Python:

Python 3.8 (GA)

جزء اسم الملف	‏‏الوصف
cp38	يدعم التنفيذ التلقائي Python 3.8 لوظائف السحابة.
amd64	عمليات بيئة الاختبار المعزولة في Azure هي بنية Windows 64 بت .

على سبيل المثال:

• لاستيراد pandas - حدد ملف عجلة باسم مشابه ل pandas-1.2.3-cp38-win_amd64.whl.

لا توفر بعض حزم Python المتوفرة على PyPI ملف عجلة. في هذه الحالة، قم بتنزيل المصدر (ملف .zip أو ملف .tar.gz) وقم بإنشاء ملف العجلة باستخدام pip.

نفذ الخطوات التالية باستخدام جهاز Windows 64 بت مع تثبيت Python 3.8.x وحزمة العجلة:

1. قم بتنزيل الملف pandas-1.2.4.tar.gzالمصدر .
2. شغل pip للحصول على ملف العجلة باستخدام الأمر التالي: pip wheel --no-deps pandas-1.2.4.tar.gz

Python 3.10 (معاينة)

جزء اسم الملف	‏‏الوصف
cp310	يدعم التنفيذ التلقائي Python 3.10 (معاينة) لوظائف السحابة.
manylinux_x86_64	عمليات بيئة الاختبار المعزولة في Azure هي بنية 64 بت المستندة إلى Linux لدفاتر تشغيل Python 3.10 (معاينة).

على سبيل المثال:

• لاستيراد pandas - حدد ملف عجلة باسم مشابه pandas-1.5.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

لا توفر بعض حزم Python المتوفرة على PyPI ملف عجلة. في هذه الحالة، قم بتنزيل المصدر (ملف .zip أو ملف .tar.gz) وقم بإنشاء ملف العجلة باستخدام pip.

نفذ الخطوات التالية باستخدام جهاز Linux 64 بت مع Python 3.10.x وحزمة العجلة المثبتة:

1. تنزيل الملف المصدر pandas-1.2.4.tar.gz.
2. شغل pip للحصول على ملف العجلة باستخدام الأمر التالي: pip wheel --no-deps pandas-1.2.4.tar.gz

قم باستيراد حزمة

1. في حساب Automation الخاص بك، حدد حزم Python ضمن الموارد المشتركة. ثم حدد + إضافة حزمة Python.

   

2. في صفحة إضافة حزمة Python، حدد حزمة محلية لتحميلها. يمكن أن تكون الحزمة ملف .whl أو .tar.gz لملف Python 3.8 و.whlل Python 3.10 (معاينة).

3. أدخل اسما وحدد إصدار وقت التشغيل ك Python 3.8 أو Python 3.10 (معاينة).

   إشعار

   حاليا، يتم دعم إصدار وقت تشغيل Python 3.10 (معاينة) لكل من السحابة والوظائف المختلطة في جميع المناطق العامة باستثناء أستراليا الوسطى 2 وكوريا الجنوبية والسويد الجنوبية وJio India Central وجنوب شرق البرازيل ووسط الهند وغرب الهند والإمارات العربية المتحدة الوسطى وسحب Gov.

4. حدد استيراد.

   

بعد استيراد حزمة، يتم سردها في صفحة حزم Python في حساب Automation الخاص بك. لإزالة حزمة، حدد الحزمة وحدد حذف.

استيراد حزمة ذات تبعيات

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

الهوية المُدارة التي يُعيّنها النظام

https://github.com/azureautomation/runbooks/blob/master/Utility/Python/import_py3package_from_pypi.py

الهوية المدارة المعينة من قبل المستخدم

import requests
import sys
import pip
import os
import re
import shutil
import json
import time
import getopt

#region Constants
PYPI_ENDPOINT = "https://pypi.org/simple"
FILENAME_PATTERN = "[\\w]+"
#endregion

def get_automation_usi_token():
    """ Returns a token that can be used to authenticate against Azure resources """
    import json

    # printing environment variables 
    resource = "?resource=https://management.azure.com/" 
    client_id = "&client_id="+client_id_usi 
    endPoint = os.getenv('IDENTITY_ENDPOINT')+ resource +client_id 
    identityHeader = os.getenv('IDENTITY_HEADER') 
    payload={}
    headers = {
      'X-IDENTITY-HEADER': identityHeader,
      'Metadata': 'True' 
    }
    response = requests.request("GET", endPoint, headers=headers, data=payload) 

    # Return the token
    return json.loads(response.text)['access_token']

def get_packagename_from_filename(packagefilename):
    match = re.match(FILENAME_PATTERN, packagefilename)
    return match.group(0)

def resolve_download_url(packagename, packagefilename):
    response = requests.get("%s/%s" % (PYPI_ENDPOINT, packagename))
    urls = re.findall(r'href=[\'"]?([^\'" >]+)', str(response.content))   
    for url in urls:
        if packagefilename in url:
            print ("Detected download uri %s for %s" % (url, packagename))
            return(url)

def send_webservice_import_module_request(packagename, download_uri_for_file):
    request_url = "https://management.azure.com/subscriptions/%s/resourceGroups/%s/providers/Microsoft.Automation/automationAccounts/%s/python3Packages/%s?api-version=2018-06-30" \
                  % (subscription_id, resource_group, automation_account, packagename)

    requestbody = { 'properties': { 'description': 'uploaded via automation', 'contentLink': {'uri': "%s" % download_uri_for_file} } }
    headers = {'Content-Type' : 'application/json', 'Authorization' : "Bearer %s" % token}
    r = requests.put(request_url, data=json.dumps(requestbody), headers=headers)
    print ("Request status for package %s was %s" % (packagename, str(r.status_code)))
    if str(r.status_code) not in ["200", "201"]:
        raise Exception("Error importing package {0} into Automation account. Error code is {1}".format(packagename, str(r.status_code)))

def make_temp_dir():
    destdir = os.path._getfullpathname("tempDownloadDir")
    if os.path.exists(destdir):
        shutil.rmtree(destdir)
    os.makedirs(destdir, 0o755)
    return destdir

def import_package_with_dependencies (packagename):
    # download package with all depeendencies
    download_dir = make_temp_dir()
    pip.main(['download', '-d', download_dir, packagename])
    for file in os.listdir(download_dir):
        pkgname = get_packagename_from_filename(file)
        download_uri_for_file = resolve_download_url(pkgname, file)
        send_webservice_import_module_request(pkgname, download_uri_for_file)
        # Sleep a few seconds so we don't send too many import requests https://docs.microsoft.com/en-us/azure/azure-subscription-service-limits#automation-limits
        time.sleep(10)

if __name__ == '__main__':
    if len(sys.argv) < 11:
        raise Exception("Requires Subscription id -s, Automation resource group name -g, account name -a, module name -g and user-assigned managed identity client id -c as arguments. \
                        Example: -s xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx -g contosogroup -a contosoaccount -m pytz -c clientid")

    # Process any arguments sent in
    subscription_id = None
    resource_group = None
    automation_account = None
    module_name = None
    client_id_usi = None

    opts, args = getopt.getopt(sys.argv[1:], "s:g:a:m:c")
    for o, i in opts:
        if o == '-s':  
            subscription_id = i
        elif o == '-g':  
            resource_group = i
        elif o == '-a': 
            automation_account = i
        elif o == '-m': 
            module_name = i
        elif o == '-c': 
            client_id_usi = i

    # Set Run as token for this automation accounts service principal to be used to import the package into Automation account
    token = get_automation_usi_token()

    # Import package with dependencies from pypi.org
    import_package_with_dependencies(module_name)
    print ("\nCheck the python 3 packages page for import status...")

استيراد البرنامج النصي إلى دفتر تشغيل

للحصول على معلومات حول استيراد دفتر التشغيل، راجع استيراد دفتر تشغيل من مدخل Microsoft Azure. انسخ الملف من GitHub إلى التخزين الذي يمكن وصول المدخل إليه قبل تشغيل الاستيراد.

إشعار

حاليا، استيراد دفتر تشغيل من مدخل Microsoft Azure غير مدعوم ل Python 3.10 (معاينة).

تقوم صفحة Import a runbook افتراضيا بمطابقة اسم دفتر التشغيل مع اسم البرنامج النصي. إذا كان لديك حق الوصول إلى الحقل، فإنه يمكنك تغيير الاسم. قد يكون نوع دفتر التشغيل افتراضيا إلى Python 2.7. إذا كان الأمر كذلك، فتأكد من تغييره إلى Python 3.8.

تنفيذ دفتر التشغيل لاستيراد الحزمة وتبعياتها

بعد إنشاء دفتر التشغيل ونشره، قم بتشغيله لاستيراد الحزمة. راجع بدء تشغيل دفتر تشغيل في Azure Automation للحصول على تفاصيل حول تنفيذ دفتر التشغيل.

يتطلب البرنامج النصي (import_py3package_from_pypi.py) المعلمات التالية.

المعلمة	‏‏الوصف‬
subscription_id	معرّف الاشتراك لحساب التنفيذ التلقائي
مجموعة الموارد	اسم مجموعة الموارد التي تم تعريف حساب التنفيذ التلقائي في
الحساب_التلقائي	اسم الحساب التلقائي
اسم_الوحدة النمطية	اسم الوحدة النمطية المراد الاستيراد منها pypi.org
module_version	إصدار الوحدة النمطية

يجب توفير قيمة المعلمة كسلسلة واحدة بالتنسيق أدناه:

-s <subscription_id> -g <resource_group> -a<automation_account> -m <module_name> -v <module_version>

لمزيد من المعلومات حول استخدام المعلمات مع دفاتر التشغيل، راجع العمل مع معلمات دفتر التشغيل.

استخدام حزمة في دفتر تشغيل

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

#!/usr/bin/env python3 
import os 
import requests  
# printing environment variables 
endPoint = os.getenv('IDENTITY_ENDPOINT')+"?resource=https://management.azure.com/" 
identityHeader = os.getenv('IDENTITY_HEADER') 
payload={} 
headers = { 
  'X-IDENTITY-HEADER': identityHeader,
  'Metadata': 'True' 
} 
response = requests.request("GET", endPoint, headers=headers, data=payload) 
print(response.text)

إشعار

لا تتوفر حزمة Python automationassets في pypi.org، لذلك فهي غير متوفرة للاستيراد إلى عامل دفتر تشغيل مختلط يعمل بنظام Windows.

تحديد الحزم المتوفرة في بيئة الاختبار المعزولة

استخدم التعليمات البرمجية التالية لسرد الوحدات النمطية المثبتة الافتراضية:

#!/usr/bin/env python3

import pkg_resources
installed_packages = pkg_resources.working_set
installed_packages_list = sorted(["%s==%s" % (i.key, i.version)
   for i in installed_packages])

for package in installed_packages_list:
    print(package)

Python 3.8 PowerShell cmdlets

إضافة حزمة Python 3.8 جديدة

New-AzAutomationPython3Package -AutomationAccountName tarademo  -ResourceGroupName mahja -Name requires.io -ContentLinkUri https://files.pythonhosted.org/packages/7f/e2/85dfb9f7364cbd7a9213caea0e91fc948da3c912a2b222a3e43bc9cc6432/requires.io-0.2.6-py2.py3-none-any.whl 

Response  
ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : requires.io 
IsGlobal              : False 
Version               : 
SizeInBytes           : 0 
ActivityCount         : 0 
CreationTime          : 9/26/2022 1:37:13 PM +05:30 
LastModifiedTime      : 9/26/2022 1:37:13 PM +05:30 
ProvisioningState     : Creating 

سرد جميع حزم Python 3.8

Get-AzAutomationPython3Package -AutomationAccountName tarademo  -ResourceGroupName mahja 

Response : 
ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : cryptography 
IsGlobal              : False 
Version               : 
SizeInBytes           : 0 
ActivityCount         : 0 
CreationTime          : 9/26/2022 11:52:28 AM +05:30 
LastModifiedTime      : 9/26/2022 12:11:00 PM +05:30 
ProvisioningState     : Failed 
ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : requires.io 
IsGlobal              : False 
Version               : 
SizeInBytes           : 0 
ActivityCount         : 0 
CreationTime          : 9/26/2022 1:37:13 PM +05:30 
LastModifiedTime      : 9/26/2022 1:39:04 PM +05:30 
ProvisioningState     : ContentValidated 
ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : sockets 
IsGlobal              : False 
Version               : 1.0.0 
SizeInBytes           : 4495 
ActivityCount         : 0 
CreationTime          : 9/20/2022 12:46:28 PM +05:30 
LastModifiedTime      : 9/22/2022 5:03:42 PM +05:30 
ProvisioningState     : Succeeded 

الحصول على تفاصيل حول حزمة معينة

Get-AzAutomationPython3Package -AutomationAccountName tarademo  -ResourceGroupName mahja -Name sockets 


Response  
ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : sockets 
IsGlobal              : False 
Version               : 1.0.0 
SizeInBytes           : 4495 
ActivityCount         : 0 
CreationTime          : 9/20/2022 12:46:28 PM +05:30 
LastModifiedTime      : 9/22/2022 5:03:42 PM +05:30 
ProvisioningState     : Succeeded 

إزالة حزمة Python 3.8

Remove-AzAutomationPython3Package -AutomationAccountName tarademo  -ResourceGroupName mahja -Name sockets 

تحديث حزمة Python 3.8

Set-AzAutomationPython3Package -AutomationAccountName tarademo  -ResourceGroupName mahja -Name requires.io -ContentLinkUri https://files.pythonhosted.org/packages/7f/e2/85dfb9f7364cbd7a9213caea0e91fc948da3c912a2b222a3e43bc9cc6432/requires.io-0.2.6-py2.py3-none-any.whl 


ResourceGroupName     : mahja 
AutomationAccountName : tarademo 
Name                  : requires.io 
IsGlobal              : False 
Version               : 0.2.6 
SizeInBytes           : 10109 
ActivityCount         : 0 
CreationTime          : 9/26/2022 1:37:13 PM +05:30 
LastModifiedTime      : 9/26/2022 1:43:12 PM +05:30 
ProvisioningState     : Creating 

الخطوات التالية

لإعداد دفتر تشغيل Python، راجع إنشاء دفتر تشغيل Python.