Compartir a través de

Administración de recursos de Batch con la CLI de Azure

Puede administrar sus cuentas y recursos de Azure Batch mediante la interfaz de Azure Command-Line (CLI de Azure). Hay comandos para crear y actualizar recursos de Batch, como grupos, trabajos y tareas. También puede crear scripts para muchas de las mismas tareas que realiza a través de las API de Batch, los cmdlets de PowerShell y Azure Portal.

Puede ejecutar la CLI de Azure en Azure Cloud Shell o instalar la CLI de Azure localmente. Las versiones están disponibles para los sistemas operativos Windows, Mac y Linux (SO).

En este artículo se explica cómo usar la CLI de Azure con cuentas y recursos de Batch.

Configuración de la CLI de Azure

Elija cómo desea configurar la CLI de Azure:

Si no está familiarizado con el uso de la CLI de Azure, consulte Introducción a la CLI de Azure antes de continuar.

Si ha instalado previamente la CLI de Azure localmente, asegúrese de actualizar la instalación a la versión más reciente.

Autenticación con la CLI de Azure

Para usar la CLI de Azure con Batch, inicie sesión primero en su cuenta de Azure y, a continuación, inicie sesión en su cuenta de Batch.

Inicio de sesión en una cuenta de Azure

Para usar la CLI de Azure, inicie sesión primero en su cuenta de Azure. Este paso proporciona acceso a los comandos de Azure Resource Manager, que incluyen comandos del servicio Batch Management . A continuación, puede ejecutar comandos para administrar cuentas, claves, paquetes de aplicación y cuotas de Batch.

Puede autenticar la cuenta de Azure en la CLI de Azure de dos maneras. Para ejecutar comandos por su cuenta, inicie sesión en la CLI de Azure de forma interactiva. La CLI de Azure almacena en caché las credenciales y puede usar esas mismas credenciales para iniciar sesión en su cuenta de Batch después. Para ejecutar comandos desde un script o una aplicación, inicie sesión con una entidad de servicio cuando ejecute comandos de la CLI de Azure.

Para iniciar sesión en la CLI de Azure de forma interactiva, ejecute az login:

az login

Inicia sesión en la cuenta de Batch

A continuación, inicie sesión en la cuenta de Batch en la CLI de Azure mediante el comando az batch account login . Este paso proporciona acceso a los comandos del servicio Batch. Después, puede administrar recursos de Batch, como grupos, trabajos y tareas.

Puede autenticar la cuenta de Batch en la CLI de Azure de dos maneras. El método predeterminado es autenticarse mediante el identificador de Entra de Microsoft. Se recomienda usar este método en la mayoría de los escenarios. Otra opción es usar la autenticación de clave compartida.

Si va a crear scripts de la CLI de Azure para automatizar comandos de Batch, puede usar cualquiera de los métodos de autenticación. En algunos escenarios, la autenticación de clave compartida podría ser más sencilla que la creación de una entidad de servicio.

Autenticación con Microsoft Entra ID

El método predeterminado para autenticarse con la cuenta de Batch es a través del identificador de Entra de Microsoft. Al iniciar sesión en la CLI de Azure de forma interactiva o con una entidad de servicio, puede usar esas mismas credenciales almacenadas en caché para iniciar sesión en su cuenta de Batch con el identificador de Microsoft Entra. Este método de autenticación también ofrece el control de acceso basado en rol de Azure (RBAC de Azure). Con RBAC de Azure, el acceso de usuario depende de su rol asignado, no de las claves de cuenta. Solo tiene que administrar los roles de Azure, no las claves de cuenta. A continuación, microsoft Entra ID controla el acceso y la autenticación.

Para iniciar sesión en la cuenta de Batch con el identificador de Microsoft Entra, ejecute az batch login. Asegúrese de incluir los parámetros obligatorios para el nombre de la cuenta de Batch (-n) y el nombre del grupo de recursos (-g).

az batch account login -g <your-resource-group> -n <your-batch-account>

Autenticación con clave compartida

También puede usar la autenticación de clave compartida para iniciar sesión en su cuenta de Batch. Este método usa las claves de acceso de la cuenta para autenticar los comandos de la CLI de Azure para el servicio Batch.

Para iniciar sesión en la cuenta de Batch con autenticación de clave compartida, ejecute az batch login con el parámetro --shared-key-auth. Asegúrese de incluir los parámetros obligatorios para el nombre de la cuenta de Batch (-n) y el nombre del grupo de recursos (-g).

az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth

Aprender comandos de Batch

En la documentación de referencia de la CLI de Azure se enumeran todos los comandos de la CLI de Azure para Batch.

Para enumerar todos los comandos de Batch en la CLI de Azure, ejecute az batch -h.

Hay varios scripts de la CLI de ejemplo para tareas comunes de Batch. En estos ejemplos se muestra cómo usar muchos comandos disponibles para Batch en la CLI de Azure. Puede aprender a crear y administrar cuentas, grupos, trabajos y tareas de Batch.

Utilización de comandos de extensión de la CLI de Batch

Puede usar la extensión de la CLI de Batch para ejecutar trabajos de Batch sin escribir código. La extensión proporciona comandos para usar plantillas JSON para crear grupos, trabajos y tareas con la CLI de Azure. La extensión también proporciona comandos para conectarse a una cuenta de Azure Storage vinculada a la cuenta de Batch. A continuación, puede cargar los archivos de entrada del trabajo y descargar los archivos de entrada del trabajo.

Creación de recursos con JSON

Puede crear la mayoría de los recursos de Batch con solo parámetros de línea de comandos. En su lugar, algunas características requieren especificar un archivo de configuración JSON. El archivo JSON contiene los detalles de configuración del nuevo recurso. Por ejemplo, debe usar un archivo JSON para especificar archivos de recursos para una tarea de inicio.

Por ejemplo, para usar un archivo JSON para configurar un nuevo recurso de grupo de Batch:

az batch pool <your-batch-pool-configuration>.json

Al especificar un archivo JSON para un nuevo recurso, no use otros parámetros en el comando. El servicio solo usa el archivo JSON para configurar el recurso.

La documentación de referencia de la API REST de Batch enumera la sintaxis JSON necesaria para crear un recurso.

Para ver la sintaxis JSON necesaria para crear un recurso, consulte la documentación de referencia de la API REST de Batch . Vaya a la sección Ejemplos de la página de referencia de la operación de recursos. A continuación, busque la subsección denominada Agregar <tipo> de recurso. Por ejemplo, Agregue una tarea básica. Use el código JSON de ejemplo como plantillas para los archivos de configuración.

Para ver un script de ejemplo que especifica un archivo JSON, consulte Ejecución de un trabajo y tareas con Batch.

Consulta los recursos de Batch de manera eficiente

Puede consultar la cuenta de Batch y enumerar todos los recursos mediante el list comando . Por ejemplo, para enumerar los grupos de su cuenta y las tareas de un trabajo:

az batch pool list
az batch task list --job-id <your-job-id>

Para limitar la cantidad de datos que devuelve la consulta de Batch, especifique una cláusula OData. Todo el filtrado se produce en el lado servidor, por lo que solo recibirá los datos que solicite. Utiliza estas cláusulas OData para ahorrar ancho de banda y tiempo en operaciones de list. Para obtener más información, consulte Diseño de consultas de lista eficaces para recursos de Batch.

Cláusula Description
--select-clause [select-clause] Devuelve un subconjunto de propiedades para cada entidad.
--filter-clause [filter-clause] Devuelve solo entidades que coinciden con la expresión OData especificada.
--expand-clause [expand-clause] Obtiene la información de entidad en una sola llamada REST subyacente. Actualmente, la cláusula expand solo admite la propiedad stats.

Para obtener un script de ejemplo que muestra cómo usar estas cláusulas, consulte Ejecución de un trabajo y tareas con Batch.

Solución de problemas

Para obtener ayuda con cualquier comando de Batch, agregue -h al final del comando. No agregue otras opciones. Por ejemplo, para obtener ayuda para crear una cuenta de Batch, ejecute az batch account create -h.

Para devolver la salida del comando detallado, agregue -v o -vv al final del comando. Utilice estos conmutadores para mostrar la salida de error completa. La -vv bandera devuelve las solicitudes y respuestas REST reales.

Para ver la salida del comando en formato JSON, agregue --json al final del comando. Por ejemplo, para mostrar las propiedades de un grupo denominado pool001, ejecute az batch pool show pool001 --json. A continuación, copie y modifique la salida para crear recursos de Batch mediante un archivo de configuración JSON.

Solución de problemas a nivel general de la CLI de Azure

La CLI de Azure se puede ejecutar en varios entornos de shell, pero con ligeras variaciones de formato. Si tiene resultados inesperados con comandos de la CLI de Azure, consulte Uso correcto de la CLI de Azure.

Pasos siguientes

Inicio rápido: Ejecución del primer trabajo de Batch con la CLI de Azure

  • Last updated on