Gestire pacchetti Python 3 in Automazione di Azure

Questo articolo descrive come importare, gestire e usare pacchetti Python 3 in Automazione di Azure in esecuzione nell'ambiente sandbox di Azure e nei ruoli di lavoro ibridi per runbook. Per eseguire correttamente il processo i pacchetti Python devono essere scaricati nei ruoli di lavoro ibridi. Per favorire la semplificazione dei runbook, è possibile importare i moduli necessari usando pacchetti Python.

Per informazioni sulla gestione dei pacchetti Python 2, vedere Gestire pacchetti Python 2.

Pacchetti Python predefiniti

Per supportare i runbook Python 3.8 nel servizio di automazione, alcuni pacchetti Python vengono installati per impostazione predefinita ed è possibile trovare un elenco di questi pacchetti qui. La versione predefinita può essere sostituita importando pacchetti Python nell'account di Automazione.

La preferenza viene assegnata alla versione importata nell'account di Automazione. Per importare un singolo pacchetto, vedere Importare un pacchetto. Per importare un pacchetto con più pacchetti, vedere Importare un pacchetto con dipendenze.

Nota

Non sono installati pacchetti predefiniti per Python 3.10 (anteprima).

Pacchetti come file di origine

Automazione di Azure supporta solo un pacchetto Python che contiene solo codice Python e non include altre estensioni del linguaggio o codice in altri linguaggi. Tuttavia, l'ambiente Sandbox di Azure potrebbe non avere i compilatori necessari per i file binari C/C++, quindi è consigliabile usare i file wheel.

Nota

Attualmente Python 3.10 (anteprima) supporta solo i file wheel.

Python Package Index (PyPI) è un repository di software per il linguaggio di programmazione Python. Quando si seleziona un pacchetto Python 3 da importare nell'account di Automazione da PyPI, prendere nota delle parti del nome file seguenti:

Selezionare una versione di Python:

Python 3.8(GA)

Parte nome file	Descrizione
cp38	Automazione supporta Python 3.8 per i processi cloud.
amd64	I processi sandbox di Azure sono l'architettura a 64 bit di Windows.

Ad esempio:

• Per importare pandas: selezionare un file wheel con un nome simile a pandas-1.2.3-cp38-win_amd64.whl.

Alcuni pacchetti Python disponibili in PyPI non forniscono un file wheel. In questo caso, scaricare il file di origine (con estensione zip o tar.gz) e generare il file wheel usando pip.

Seguire questa procedura usando un computer Windows a 64 bit con il pacchetto Python 3.8.x e wheel installato:

1. Scaricare il file pandas-1.2.4.tar.gzdi origine .
2. Eseguire pip per ottenere il file wheel con il comando seguente: pip wheel --no-deps pandas-1.2.4.tar.gz

Python 3.10 (anteprima)

Parte nome file	Descrizione
cp310	Automazione supporta Python 3.10 (anteprima) per i processi cloud.
manylinux_x86_64	I processi sandbox di Azure sono un'architettura a 64 bit basata su Linux per i runbook Python 3.10 (anteprima).

Ad esempio:

• Per importare pandas: selezionare un file wheel con un nome simile a pandas-1.5.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Alcuni pacchetti Python disponibili in PyPI non forniscono un file wheel. In questo caso, scaricare il file di origine (con estensione zip o tar.gz) e generare il file wheel usando pip.

Seguire questa procedura usando un computer Linux a 64 bit con il pacchetto Python 3.10.x e wheel installato:

1. Scaricare il file di origine pandas-1.2.4.tar.gz.
2. Eseguire pip per ottenere il file wheel con il comando seguente: pip wheel --no-deps pandas-1.2.4.tar.gz

Importare un pacchetto

1. Nell'account di Automazione selezionare Pacchetti Python in Risorse condivise. Quindi selezionare + Aggiungi un pacchetto Python.

   

2. Nella pagina Aggiungi pacchetto Python selezionare un pacchetto locale da caricare. Il pacchetto può essere un file .whl o .tar.gz per Python 3.8 e un file .whl per Python 3.10 (anteprima).

3. Immettere un nome e selezionare la versione di runtime come Python 3.8 o Python 3.10 (anteprima).

   Nota

   Attualmente, la versione di runtime di Python 3.10 (anteprima) è supportata sia per i processi cloud che ibridi in tutte le aree pubbliche, ad eccezione di Australia centrale2, Corea meridionale, Svezia meridionale, Jio India centrale, Brasile sud-orientale, India centrale, India occidentale, Emirati Arabi Uniti centrali e cloud gov.

4. Selezionare Importa.

   

Dopo l'importazione, il pacchetto viene elencato nella pagina dei pacchetti Python dell'account di Automazione. Per rimuovere un pacchetto, selezionarlo e fare clic su Elimina.

Importare un pacchetto con dipendenze

È possibile importare un pacchetto Python 3.8 e le relative dipendenze importando il seguente script Python in un runbook Python 3.8. È necessario assicurarsi che l'identità gestita sia abilitata per l'account di Automazione e disponga di autorizzazioni di Collaboratore Automazione per l'importazione corretta del pacchetto.

Identità gestita assegnata dal sistema

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

Identità gestita assegnata dall'utente

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...")

Importazione dello script in un runbook

Per informazioni sull'importazione del runbook, vedere Importare un runbook dal portale di Azure. Copiare il file da GitHub nell'archiviazione a cui il portale può accedere prima di eseguire l'importazione.

Nota

Attualmente, l'importazione di un runbook dal portale di Azure non è supportata per Python 3.10 (anteprima).

Per impostazione predefinita, la pagina Importa un runbook corrisponde al nome dello script. Se si ha accesso al campo, è possibile modificare il nome. Il tipo di runbook può usare sempre Python 2.7. In caso affermativo, assicurarsi di modificarlo in Python 3.8.

Esecuzione del runbook per importare il pacchetto e le dipendenze

Dopo aver creato e pubblicato il runbook, eseguirlo per importare il pacchetto. Per l’esecuzione di un runbook, vedere Avviare un runbook in Automazione di Azure.

Lo script (import_py3package_from_pypi.py) richiede i parametri seguenti.

Parametro	Descrizione
subscription_id	ID sottoscrizione dell'account di Automazione
resource_group	Nome del gruppo di risorse definito dall'account di Automazione in
automation_account	Nome dell'account di Automazione
module_name	Nome del modulo da cui eseguire l'importazione pypi.org
module_version	Versione del modulo

Il valore del parametro deve essere fornito come stringa singola nel seguente formato:

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

Per altre informazioni sull'uso dei parametri con i runbook, vedere Usare i parametri del runbook.

Usare un pacchetto in un runbook

Con il pacchetto importato, è possibile usarlo in un runbook. Aggiungere il codice seguente per elencare tutti i gruppi di risorse in una sottoscrizione di 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)

Nota

Il pacchetto Python automationassets non è disponibile in pypi.org, quindi non è disponibile per l'importazione in un ruolo di lavoro ibrido per runbook windows.

Identificare i pacchetti disponibili nella sandbox

Usare il codice seguente per elencare i moduli installati predefiniti:

#!/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)

Cmdlet di PowerShell per Python 3.8

Aggiungere un nuovo pacchetto 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 

Elencare tutti i pacchetti 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 

Ottenere informazioni dettagliate su un pacchetto specifico

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 

Rimuovere il pacchetto Python 3.8

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

Aggiornare il pacchetto 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 

Passaggi successivi

Per preparare un runbook Python, vedere Creare un runbook di Python.