Uso de la administración de servicios de Python

En esta guía se muestra cómo ejecutar tareas comunes de administración de servicios mediante programación con Python. La clase ServiceManagementService del SDK de Azure para Python permite acceder mediante programación a gran parte de la funcionalidad relacionada con la administración de servicios que se encuentra disponible en Azure Portal. Puede utilizar esta funcionalidad para crear, actualizar y eliminar servicios en la nube, implementaciones, servicios de administración de datos y máquinas virtuales. Esta funcionalidad puede resultar útil para compilar aplicaciones que precisan de acceso mediante programación a la administración de servicios.

¿Qué es la administración de servicios?

Azure Service Management API proporciona acceso mediante programación a gran parte de la funcionalidad de administración de servicios disponible en Azure Portal. Azure SDK para Python le permite administrar los servicios en la nube y las cuentas de almacenamiento.

Para usar Service Management API, necesita crear una cuenta de Azure.

Conceptos

El SDK de Azure para Python cuenta con Service Management API, que es una API REST. Todas las operaciones de la API se realizan mediante TLS y se autentican mutuamente con los certificados X.509 v3. Se puede obtener acceso al servicio de administración desde un servicio que se ejecute en Azure. También se puede acceder directamente a través de Internet desde cualquier aplicación que envíe una solicitud HTTPS y reciba una respuesta HTTPS.

Instalación

Todas las características descritas en este artículo están disponibles en el paquete azure-servicemanagement-legacy, que puede instalarse con PIP. Para obtener más información sobre la instalación (por ejemplo, si no está familiarizado con Python), consulte Instalación de Python y el SDK.

Conexión a la administración de servicios

Para conectarse al punto de conexión de administración de servicios, necesita el identificador de suscripción de Azure y un certificado de administración válido. Puede obtener el identificador de la suscripción en Azure Portal.

Certificados de administración en Windows/Mac/Linux (OpenSSL)

Puede usar OpenSSL para crear el certificado de administración. Necesita crear dos certificados, uno para el servidor (un archivo .cer) y otro para el cliente (un archivo .pem). Para crear el archivo .pem , ejecute este comando:

openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem

Para crear el certificado .cer , ejecute este comando:

openssl x509 -inform pem -in mycert.pem -outform der -out mycert.cer

Para obtener más información sobre los certificados de Azure, consulte Introducción a los certificados para Azure Cloud Services. Para obtener una descripción completa de los parámetros de OpenSSL, consulte la documentación en https://www.openssl.org/docs/manmaster/man1/req.html.

Después de crear estos archivos, cargue el archivo .cer en Azure. En Azure Portal, en la pestaña Configuración, seleccione Cargar. Apunte dónde guardó el archivo .pem.

Después de obtener el identificador de suscripción, cree un certificado, cargue el archivo .cer en Azure y conéctese al punto de conexión de administración de Azure. Para conectarse, transfiera el identificador de suscripción y la ruta de acceso del archivo .pem a ServiceManagementService.

from azure import *
from azure.servicemanagement import *

subscription_id = '<your_subscription_id>'
certificate_path = '<path_to_.pem_certificate>'

sms = ServiceManagementService(subscription_id, certificate_path)

En el ejemplo anterior, sms es un objeto ServiceManagementService . La clase ServiceManagementService es la clase principal usada para administrar los servicios de Azure.

Certificados de administración en Windows (MakeCert)

Puede crear un certificado de administración autofirmado en la máquina con makecert.exe. Abra un símbolo del sistema de Visual Studio como administrador y use el siguiente comando, donde debe reemplazar AzureCertificate por el nombre del certificado que quiera usar:

makecert -sky exchange -r -n "CN=AzureCertificate" -pe -a sha1 -len 2048 -ss My "AzureCertificate.cer"

El comando crea el archivo .cer y lo instala en el almacén de certificados Personal. Para obtener más información, consulte Introducción a los certificados para Azure Cloud Services.

Después de crear el certificado, cargue el archivo .cer en Azure. En Azure Portal, en la pestaña Configuración, seleccione Cargar.

Después de obtener el identificador de suscripción, cree un certificado, cargue el archivo .cer en Azure y conéctese al punto de conexión de administración de Azure. Para conectarse, transfiera el identificador de suscripción y la ubicación del certificado en su almacén de certificados Personal a ServiceManagementService (de nuevo, reemplace AzureCertificate por el nombre del certificado).

from azure import *
from azure.servicemanagement import *

subscription_id = '<your_subscription_id>'
certificate_path = 'CURRENT_USER\\my\\AzureCertificate'

sms = ServiceManagementService(subscription_id, certificate_path)

En el ejemplo anterior, sms es un objeto ServiceManagementService . La clase ServiceManagementService es la clase principal usada para administrar los servicios de Azure.

Enumeración de ubicaciones disponibles

Para enumerar las ubicaciones disponibles para los servicios de hospedaje, use el método list_locations.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

result = sms.list_locations()
for location in result:
    print(location.name)

Al crear un servicio en la nube o un servicio de almacenamiento, deberá proporcionar una ubicación válida. El método list_locations siempre devuelve una lista actualizada de las ubicaciones disponibles actualmente. En el momento de la redacción de este documento, las ubicaciones disponibles son:

• Oeste de Europa
• Norte de Europa
• Sudeste de Asia
• Este de Asia
• Centro de EE. UU.
• Centro-Norte de EE. UU
• Centro-sur de EE. UU.
• Oeste de EE. UU.
• Este de EE. UU.
• Japón Oriental
• Japón Occidental
• Sur de Brasil
• Este de Australia
• Sudeste de Australia

Creación de un servicio en la nube

Cuando se crea una aplicación y se ejecuta en Azure, el conjunto del código y la configuración se denomina servicio en la nube de Azure. (En versiones anteriores de Azure, se conocía como servicio hospedado). Puede usar el método create_hosted_service para crear un servicio hospedado. Para crear el servicio, debe proporcionar un nombre de servicio hospedado (que debe ser exclusivo en Azure), una etiqueta (codificada automáticamente como base 64), una descripción y una ubicación.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

name = 'myhostedservice'
label = 'myhostedservice'
desc = 'my hosted service'
location = 'West US'

sms.create_hosted_service(name, label, desc, location)

Puede enumerar todos los servicios hospedados para la suscripción con el método list_hosted_services.

result = sms.list_hosted_services()

for hosted_service in result:
    print('Service name: ' + hosted_service.service_name)
    print('Management URL: ' + hosted_service.url)
    print('Location: ' + hosted_service.hosted_service_properties.location)
    print('')

Para obtener información acerca de un servicio hospedado en particular, transfiera el nombre del servicio hospedado al método get_hosted_service_properties.

hosted_service = sms.get_hosted_service_properties('myhostedservice')

print('Service name: ' + hosted_service.service_name)
print('Management URL: ' + hosted_service.url)
print('Location: ' + hosted_service.hosted_service_properties.location)

Después de crear un servicio en la nube, implemente el código en el servicio con el método create_deployment.

Eliminación de un servicio en la nube

Puede eliminar un servicio en la nube si transfiere el nombre del servicio al método delete_hosted_service.

sms.delete_hosted_service('myhostedservice')

Antes de eliminar un servicio, primero es necesario eliminar todas las implementaciones de dicho servicio. Para obtener más información, consulte Eliminación de una implementación.

Eliminación de una implementación

Para eliminar una implementación, use el método delete_deployment. En el ejemplo siguiente se muestra cómo eliminar una implementación llamada v1:

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

sms.delete_deployment('myhostedservice', 'v1')

Creación de un servicio de almacenamiento

Un servicio de almacenamiento le proporciona acceso a blobs, tablas y colas de Azure. Para crear un servicio de almacenamiento, se necesita un nombre para el servicio (entre 3 y 24 caracteres en minúsculas y únicos dentro de Azure). También necesita una descripción, una etiqueta (hasta 100 caracteres, codificada automáticamente con base64) y una ubicación. En el ejemplo siguiente se muestra cómo crear un servicio de almacenamiento mediante la definición de una ubicación:

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

name = 'mystorageaccount'
label = 'mystorageaccount'
location = 'West US'
desc = 'My storage account description.'

result = sms.create_storage_account(name, desc, label, location=location)

operation_result = sms.get_operation_status(result.request_id)
print('Operation status: ' + operation_result.status)

En el ejemplo anterior, el estado de la operación create_storage_account puede recuperarse transfiriendo el resultado devuelto por create_storage_account al método get_operation_status.

Puede enumerar las cuentas de almacenamiento y sus propiedades con el método list_storage_accounts.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

result = sms.list_storage_accounts()
for account in result:
    print('Service name: ' + account.service_name)
    print('Location: ' + account.storage_service_properties.location)
    print('')

Eliminación de un servicio de almacenamiento

Para eliminar un servicio de almacenamiento, transfiera el nombre del servicio de almacenamiento al método delete_storage_account. Con la eliminación del servicio de almacenamiento también se eliminan todos los datos almacenados en el servicio (blobs, tablas y colas).

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

sms.delete_storage_account('mystorageaccount')

Enumeración de los sistemas operativos disponibles

Para enumerar los sistemas operativos que están disponibles para los servicios de hospedaje, use el método list_operating_systems.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

result = sms.list_operating_systems()

for os in result:
    print('OS: ' + os.label)
    print('Family: ' + os.family_label)
    print('Active: ' + str(os.is_active))

Como alternativa, también puede usar el método list_operating_system_families, que agrupa los sistemas operativos por familia.

result = sms.list_operating_system_families()

for family in result:
    print('Family: ' + family.label)
    for os in family.operating_systems:
        if os.is_active:
            print('OS: ' + os.label)
            print('Version: ' + os.version)
    print('')

Creación de una imagen de sistema operativo

Para agregar una imagen del sistema operativo al repositorio de imágenes, use el método add_os_image.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

name = 'mycentos'
label = 'mycentos'
os = 'Linux' # Linux or Windows
media_link = 'url_to_storage_blob_for_source_image_vhd'

result = sms.add_os_image(label, media_link, name, os)

operation_result = sms.get_operation_status(result.request_id)
print('Operation status: ' + operation_result.status)

Para enumerar las imágenes del sistema operativo disponibles, use el método list_os_images. Se incluyen todas las imágenes de la plataforma y las imágenes de usuario.

result = sms.list_os_images()

for image in result:
    print('Name: ' + image.name)
    print('Label: ' + image.label)
    print('OS: ' + image.os)
    print('Category: ' + image.category)
    print('Description: ' + image.description)
    print('Location: ' + image.location)
    print('Media link: ' + image.media_link)
    print('')

Eliminación de una imagen de sistema operativo

Para eliminar una imagen de usuario, use el método delete_os_image.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

result = sms.delete_os_image('mycentos')

operation_result = sms.get_operation_status(result.request_id)
print('Operation status: ' + operation_result.status)

Creación de una máquina virtual

Para crear una máquina virtual, primero debe crear un servicio en la nube. A continuación, cree la implementación de máquina virtual con el método create_virtual_machine_deployment.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

name = 'myvm'
location = 'West US'

#Set the location
sms.create_hosted_service(service_name=name,
    label=name,
    location=location)

# Name of an os image as returned by list_os_images
image_name = 'OpenLogic__OpenLogic-CentOS-62-20120531-en-us-30GB.vhd'

# Destination storage account container/blob where the VM disk
# will be created
media_link = 'url_to_target_storage_blob_for_vm_hd'

# Linux VM configuration, you can use WindowsConfigurationSet
# for a Windows VM instead
linux_config = LinuxConfigurationSet('myhostname', 'myuser', 'mypassword', True)

os_hd = OSVirtualHardDisk(image_name, media_link)

sms.create_virtual_machine_deployment(service_name=name,
    deployment_name=name,
    deployment_slot='production',
    label=name,
    role_name=name,
    system_config=linux_config,
    os_virtual_hard_disk=os_hd,
    role_size='Small')

Eliminación de una máquina virtual

Para eliminar una máquina virtual, primero debe eliminar la implementación con el método delete_deployment.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

sms.delete_deployment(service_name='myvm',
    deployment_name='myvm')

El servicio en la nube puede eliminarse entonces con el método delete_hosted_service.

sms.delete_hosted_service(service_name='myvm')

Creación de una máquina virtual a partir de una imagen de máquina virtual capturada

Para capturar una imagen de máquina virtual, primero llame al método capture_vm_image.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

# replace the below three parameters with actual values
hosted_service_name = 'hs1'
deployment_name = 'dep1'
vm_name = 'vm1'

image_name = vm_name + 'image'
image = CaptureRoleAsVMImage    ('Specialized',
    image_name,
    image_name + 'label',
    image_name + 'description',
    'english',
    'mygroup')

result = sms.capture_vm_image(
        hosted_service_name,
        deployment_name,
        vm_name,
        image
    )

Para asegurarse de que se capturó correctamente la imagen, use la API list_vm_images. Asegúrese de que la imagen aparezca en los resultados.

images = sms.list_vm_images()

Para crear finalmente la máquina virtual con la imagen capturada, use el método create_virtual_machine_deployment como se ha descrito anteriormente, pero esta vez páselo en vm_image_name.

from azure import *
from azure.servicemanagement import *

sms = ServiceManagementService(subscription_id, certificate_path)

name = 'myvm'
location = 'West US'

#Set the location
sms.create_hosted_service(service_name=name,
    label=name,
    location=location)

sms.create_virtual_machine_deployment(service_name=name,
    deployment_name=name,
    deployment_slot='production',
    label=name,
    role_name=name,
    system_config=linux_config,
    os_virtual_hard_disk=None,
    role_size='Small',
    vm_image_name = image_name)

Para obtener más información sobre cómo capturar una máquina virtual Linux en el modelo de implementación clásica, consulte Captura de una máquina virtual Linux.

Para obtener más información sobre cómo capturar una máquina virtual Windows en el modelo de implementación clásica, consulte Captura de una máquina virtual Windows.

Pasos siguientes

Ahora que ha aprendido los conceptos básicos de la administración de servicios, puede tener acceso a la documentación de referencia completa de la API para el SDK de Azure para Python y realizar tareas complejas fácilmente para administrar la aplicación Python.

Para más información, vea el Centro para desarrolladores de Python.