Administración de cuentas y cuotas de Batch con la biblioteca cliente de administración de Batch para .NET

  • Artículo

Puede reducir la sobrecarga de mantenimiento en las aplicaciones de Azure Batch con la biblioteca Batch Management .NET para automatizar la creación, eliminación, administración de claves y detección de cuota de las cuentas de Batch.

  • Cree y elimine cuentas de Batch en cualquier región. Por ejemplo, si como proveedor de software independiente (ISV) proporciona un servicio a los clientes en el que a cada uno se le asigna una cuenta de Batch independiente para la facturación, puede agregar capacidades de creación y eliminación de la cuenta al portal del cliente.
  • Recupere y regenere claves de la cuenta mediante programación para cualquiera de sus cuentas de Batch. Esto puede ayudarle a cumplir las directivas de seguridad que exigen la sustitución periódica de las claves de cuenta. Si tiene varias cuentas de Batch en distintas regiones de Azure, la automatización de este proceso de sustitución mejorará la eficacia de la solución.
  • Compruebe las cuotas de la cuenta y elimine las incertidumbres al determina los límites de cada cuenta de Batch. Si comprueba las cuotas de las cuentas antes de iniciar un trabajo, crear un grupo o agregar un nodo de procesos, podrá ajustar de forma proactiva el lugar y el momento en que se crean estos recursos de proceso. Puede determinar qué cuentas requieren un aumento de la cuota antes de asignarles recursos adicionales.
  • Combine características de otros servicios de Azure para una experiencia completa de administración usando Batch Management .NET, Microsoft Entra ID y Azure Resource Manager juntos en la misma aplicación. Mediante el uso de estas características y sus API puede proporcionar una experiencia de autenticación sin fricciones, la capacidad para crear y eliminar grupos de recursos, y las funcionalidades que se han descrito anteriormente para una solución de administración de un extremo a otro.

Nota

Aunque este artículo se centra en la administración de las cuentas, las claves y las cuotas de Batch mediante programación, puede realizar muchas de estas actividades con Azure Portal.

Cree y elimine cuentas de Batch

Una de las principales características de Batch Management API es la creación y eliminación de cuentas de Batch en una región de Azure. Para ello, usará BatchManagementClient.Account.CreateAsync y DeleteAsync, o sus contrapartidas sincrónicas.

El fragmento de código siguiente crea una cuenta, obtiene la cuenta recién creada del servicio Batch y la elimina. En este y otros fragmentos de código que aparecen en el artículo, batchManagementClient es una instancia completamente inicializada de BatchManagementClient.

// Create a new Batch account
await batchManagementClient.Account.CreateAsync("MyResourceGroup",
    "mynewaccount",
    new BatchAccountCreateParameters() { Location = "West US" });

// Get the new account from the Batch service
AccountResource account = await batchManagementClient.Account.GetAsync(
    "MyResourceGroup",
    "mynewaccount");

// Delete the account
await batchManagementClient.Account.DeleteAsync("MyResourceGroup", account.Name);

Nota

Las aplicaciones que utilizan la biblioteca Batch Management .NET y su clase BatchManagementClient necesitan tener acceso de administrador de servicio o coadministrador en la suscripción propietaria de la cuenta de Batch que se va a administrar. Para más información, consulte la sección Microsoft Entra ID y el código de ejemplo de AccountManagement.

Recupere y regenere claves de la cuenta

Obtenga las claves de cuenta principal y secundaria de cualquier cuenta de Batch de su suscripción con GetKeysAsync. Dichas claves se pueden regenerar con RegenerateKeyAsync.

// Get and print the primary and secondary keys
BatchAccountGetKeyResult accountKeys =
    await batchManagementClient.Account.GetKeysAsync(
        "MyResourceGroup",
        "mybatchaccount");
Console.WriteLine("Primary key:   {0}", accountKeys.Primary);
Console.WriteLine("Secondary key: {0}", accountKeys.Secondary);

// Regenerate the primary key
BatchAccountRegenerateKeyResponse newKeys =
    await batchManagementClient.Account.RegenerateKeyAsync(
        "MyResourceGroup",
        "mybatchaccount",
        new BatchAccountRegenerateKeyParameters() {
            KeyName = AccountKeyType.Primary
            });

Sugerencia

Puede crear un flujo de trabajo de conexión simplificada para las aplicaciones de administración. En primer lugar, obtenga una clave de cuenta para la cuenta de Batch que quiere administrar con GetKeysAsync. Después, use esta clave al inicializar la clase BatchSharedKeyCredentials de la biblioteca de Batch para .NET, que se usa al inicializar BatchClient.

Comprobación de la suscripción de Azure y cuotas de la cuenta de Batch

Las suscripciones de Azure y los servicios individuales de Azure, como Batch, tienen cuotas predeterminadas que limitan el número de determinadas entidades que contienen. Para conocer las cuotas predeterminadas de las suscripciones de Azure, consulte Límites, cuotas y restricciones de suscripción y servicios de Microsoft Azure. Para conocer las cuotas predeterminadas del servicio Batch, consulte Cuotas y límites del servicio Azure Batch. Con la biblioteca Batch Management .NET, pude comprobar estas cuotas en sus aplicaciones. Esto le permite tomar decisiones sobre la asignación antes de agregar cuentas o recursos de proceso como los grupos y nodos de ejecución.

Comprobación de una suscripción de Azure para las cuotas de cuentas de Batch

Antes de crear una cuenta de Batch en una región, puede comprobar la suscripción de Azure para ver si se puede agregar una cuenta en esa región.

En el siguiente fragmento de código, primero se usa ListAsync para obtener una colección de todas las cuentas de Batch que están en una suscripción. Una vez obtenida esta colección, se determina el número de cuentas que están en la región de destino. A continuación, se usa GetQuotasAsync para obtener la cuota de la cuenta de Batch y determinar el número de cuentas (si las hay) que se pueden crear en dicha región.

// Get a collection of all Batch accounts within the subscription
BatchAccountListResponse listResponse =
        await batchManagementClient.BatchAccount.ListAsync(new AccountListParameters());
IList<AccountResource> accounts = listResponse.Accounts;
Console.WriteLine("Total number of Batch accounts under subscription id {0}:  {1}",
    creds.SubscriptionId,
    accounts.Count);

// Get a count of all accounts within the target region
string region = "westus";
int accountsInRegion = accounts.Count(o => o.Location == region);

// Get the account quota for the specified region
SubscriptionQuotasGetResponse quotaResponse = await batchManagementClient.Location.GetQuotasAsync(region);
Console.WriteLine("Account quota for {0} region: {1}", region, quotaResponse.AccountQuota);

// Determine how many accounts can be created in the target region
Console.WriteLine("Accounts in {0}: {1}", region, accountsInRegion);
Console.WriteLine("You can create {0} accounts in the {1} region.", quotaResponse.AccountQuota - accountsInRegion, region);

En el fragmento de código anterior, creds es una instancia de TokenCredentials. Para ver un ejemplo de creación de este objeto, consulte el ejemplo de código AccountManagement en GitHub.

Comprobación de una cuenta de Batch para las cuotas de recursos de proceso

Antes de incrementar los recursos de proceso en la solución de Batch, puede hacer una comprobación para asegurarse de que los recursos que quiere asignar no sobrepasan las cuotas de la cuenta. En el fragmento de código siguiente, se imprime la información de cuota de la cuenta de Batch llamada mybatchaccount. Puede utilizar esta información en su aplicación para determinar si la cuenta es capaz de administrar los recursos adicionales que se van a crear.

// First obtain the Batch account
BatchAccountGetResponse getResponse =
    await batchManagementClient.Account.GetAsync("MyResourceGroup", "mybatchaccount");
AccountResource account = getResponse.Resource;

// Now print the compute resource quotas for the account
Console.WriteLine("Core quota: {0}", account.Properties.CoreQuota);
Console.WriteLine("Pool quota: {0}", account.Properties.PoolQuota);
Console.WriteLine("Active job and job schedule quota: {0}", account.Properties.ActiveJobAndJobScheduleQuota);

Importante

Aunque existen cuotas predeterminadas para los servicios y las suscripciones de Azure, muchos de estos límites se pueden aumentar mediante la solicitud de un aumento de cuota en Azure Portal.

Uso de Microsoft Entra ID Batch Management .NET

La biblioteca .NET de administración de Batch es un cliente de proveedor de recursos de Azure y se utiliza junto con Azure Resource Manager para administrar estos recursos de cuenta mediante programación. Microsoft Entra ID se necesita para autenticar las solicitudes realizadas a través de cualquier cliente del proveedor de recursos de Azure, incluida la biblioteca Batch Management .NET y a través de Azure Resource Manager. Para obtener información sobre el uso de Microsoft Entra ID con la biblioteca Batch Management .NET, consulte Uso de Microsoft Entra ID para autenticar soluciones de Batch.

Proyecto de ejemplo en GitHub

Para ver Batch Management .NET en acción, consulte el proyecto de ejemplo AccountManagment en GitHub. La aplicación de ejemplo AccountManagement muestra las siguientes operaciones:

  1. Adquiera un token de seguridad de Microsoft Entra ID mediante Adquisición y almacenamiento en caché de tokens mediante la Biblioteca de autenticación de Microsoft (MSAL). Si el usuario aún no ha iniciado sesión, se le pedirán sus credenciales de Azure.
  2. Cree un objeto SubscriptionClient mediante el token de seguridad obtenido de Microsoft Entra ID para consultar en Azure una lista de las suscripciones asociadas a la cuenta. El usuario puede seleccionar una suscripción de la lista si contiene más de una suscripción.
  3. Obtenga las credenciales asociadas con la suscripción seleccionada.
  4. Cree un objeto ResourceManagementClient con las credenciales.
  5. Use un objeto ResourceManagementClient para crear un grupo de recursos.
  6. Use un objeto BatchManagementClient para realizar varias operaciones de cuenta de Batch:
    • Crear una cuenta de Batch en el nuevo grupo de recursos.
    • Obtener la cuenta recién creada desde el servicio Batch.
    • Imprimir las claves de la nueva cuenta.
    • Regenerar una nueva clave principal para la cuenta.
    • Imprimir la información de cuota de la cuenta.
    • Imprimir la información de cuota de la suscripción.
    • Imprimir todas las cuentas de la suscripción.
    • Eliminar la cuenta recién creada.
  7. Elimine el grupo de recursos.

Para ejecutar la aplicación de ejemplo correctamente, primero debe registrarla en el inquilino de Microsoft Entra en Azure Portal y conceder permisos a la API de Azure Resource Manager. Siga los pasos proporcionados en Autenticación de soluciones de administración de Batch con Active Directory.

Pasos siguientes

  • Obtenga información sobre el Flujo de trabajo y recursos del servicio Batch, como grupos, nodos, trabajos y tareas.
  • Para conocer los aspectos básicos del desarrollo de una aplicación habilitada para Batch, consulte la biblioteca de cliente de Batch para .NET o Python. Estos inicios rápidos le guían a través de una aplicación de ejemplo en la cual se usa el servicio Batch para ejecutar una carga de trabajo en varios nodos de proceso, y donde se usa Azure Storage para el almacenamiento provisional y la recuperación de archivos de la carga de trabajo.