Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este inicio rápido, se usará la definición de aplicación administrada que creó usando uno de los artículos de inicio rápido. La implementación crea dos grupos de recursos. Uno contiene la aplicación administrada y el otro es un grupo de recursos administrado para el recurso implementado. La definición de aplicación administrada implementa un plan de App Service, App Service y cuenta de almacenamiento.
Prerrequisitos
- Una definición de aplicación administrada creada con la publicación de una definición de aplicación o la publicación de una definición con Bring Your Own Storage.
- Una cuenta de Azure con una suscripción activa. Antes de comenzar, si no tiene una cuenta, cree una gratuita.
- Visual Studio Code.
- La versión más reciente de Azure PowerShell o CLI de Azure.
Creación de una aplicación administrada del catálogo de servicios
En los ejemplos se usan los nombres para los grupos de recursos creados en el inicio rápido para publicar una definición de aplicación. Si usó el inicio rápido para publicar una definición con Bring Your Own Storage, use esos nombres de grupo de recursos.
- Publicar definición de aplicación: packageStorageGroup y appDefinitionGroup.
- Publicar definición con Trae tu almacenamiento: packageStorageGroup, byosDefinitionStorageGroup y byosAppDefinitionGroup.
Obtener la definición de la aplicación administrada
Para obtener la definición de la aplicación administrada con Azure PowerShell, ejecute los siguientes comandos.
En Visual Studio Code, abra un nuevo terminal de PowerShell e inicie sesión en su suscripción de Azure.
Connect-AzAccount
Este comando abrirá el explorador predeterminado y le solicitará iniciar sesión en Azure. Para obtener más información, vaya a Inicio de sesión con Azure PowerShell.
En Azure PowerShell, obtenga la definición de la aplicación administrada. En este ejemplo, use el nombre del grupo de recursos appDefinitionGroup que se creó cuando implementó la definición de aplicación administrada.
Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup
Get-AzManagedApplicationDefinition
enumera todas las definiciones disponibles del grupo de recursos especificado, como sampleManagedApplication.
Cree una variable para el identificador de recurso de la definición de aplicación administrada.
$definitionid = (Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup -Name sampleManagedApplication).ManagedApplicationDefinitionId
Use el valor de variable $definitionid
cuando implemente la aplicación administrada.
Creación de un grupo de recursos y parámetros
Cree un grupo de recursos para la implementación de la aplicación administrada.
New-AzResourceGroup -Name applicationGroup -Location westus
También debe crear un nombre para el grupo de recursos de la aplicación administrada. El grupo de recursos se crea al implementar la aplicación administrada.
Ejecute los comandos siguientes para crear el nombre del grupo de recursos administrado.
$mrgprefix = 'mrg-sampleManagedApplication-'
$mrgtimestamp = Get-Date -UFormat "%Y%m%d%H%M%S"
$mrgname = $mrgprefix + $mrgtimestamp
$mrgname
Las variables $mrgprefix
y $mrgtimestamp
se concatenan y almacenan en la variable $mrgname
. El valor de la variable tiene el formato mrg-sampleManagedApplication-20230512103059. Use el valor de variable $mrgname
cuando implemente la aplicación administrada.
Debe proporcionar varios parámetros al comando de implementación de la aplicación administrada. Puede usar una cadena con formato JSON o crear un archivo JSON. En este ejemplo, se usa una cadena con formato JSON. El carácter de escape de PowerShell para las comillas es el carácter de tilde aguda (`
). La tilde aguda también se usa para la continuación de línea en los comandos que puedan usar varias líneas.
La sintaxis de la cadena con formato JSON es la siguiente:
"{ `"parameterName`": {`"value`":`"parameterValue`"}, `"parameterName`": {`"value`":`"parameterValue`"} }"
Para mejorar la legibilidad, la cadena JSON completada usa la tilde aguda para la continuación de línea. Los valores se almacenan en la variable $params
y se usan en el comando de implementación. Los parámetros de la cadena JSON son necesarios para implementar los recursos administrados.
$params="{ `"appServicePlanName`": {`"value`":`"demoAppServicePlan`"}, `
`"appServiceNamePrefix`": {`"value`":`"demoApp`"} }"
Parámetros para crear los recursos administrados:
appServicePlanName
: Crear un nombre para el plan. Máximo de 40 caracteres alfanuméricos y guiones. Por ejemplo, demoAppServicePlan. Los nombres de plan de App Service deben ser únicos dentro de un grupo de recursos de la suscripción.appServiceNamePrefix
: crea un prefijo para el nombre del plan. Máximo de 47 caracteres alfanuméricos o guiones. Por ejemplo, demoApp. Durante la implementación, el prefijo se concatena con una cadena única para crear un nombre único globalmente en Azure.
Implementación de la aplicación administrada
Ejecute el siguiente comando para implementar la aplicación administrada.
New-AzManagedApplication `
-Name "demoManagedApplication" `
-ResourceGroupName applicationGroup `
-Location westus `
-ManagedResourceGroupName $mrgname `
-ManagedApplicationDefinitionId $definitionid `
-Kind ServiceCatalog `
-Parameter $params
Los parámetros usados en el comando de implementación:
Name
: Especificar un nombre para la aplicación administrada. En este ejemplo, use demoManagedApplication.ResourceGroupName
: Nombre del grupo de recursos que creó para la aplicación administrada.Location
: especifique la región para la implementación de recursos. En este ejemplo, use westus.ManagedResourceGroupName
: usa el valor de la variable de$mrgname
. El grupo de recursos administrado se crea cuando se implementa la aplicación administrada.ManagedApplicationDefinitionId
: Usa el valor de variable$definitionid
para el identificador de recurso de la definición de aplicación administrada.Kind
: Especifica el tipo de aplicación administrada. En este ejemplo se usa ServiceCatalog.Parameter
: Usa el valor de variable$params
en la cadena con formato JSON.
Vista de resultados
Una vez implementada la aplicación administrada del catálogo de servicios, tendrá dos nuevos grupos de recursos. Uno contiene la aplicación administrada El otro grupo de recursos contiene los recursos administrados que se han implementado. En este ejemplo, un App Service, un plan de App Service y una cuenta de almacenamiento.
Aplicación administrada
Una vez finalizada la implementación, puede comprobar el estado de la aplicación administrada.
Ejecute el comando siguiente para comprobar el estado de la aplicación administrada.
Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup
Expanda las propiedades para facilitar la lectura de la información Properties
.
Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup | Select-Object -ExpandProperty Properties
Recursos administrados
Puede ver los recursos implementados en el grupo de recursos administrados.
Para mostrar los recursos del grupo de recursos administrados, ejecute el siguiente comando. Ha creado la variable $mrgname
al crear los parámetros.
Get-AzResource -ResourceGroupName $mrgname
Para mostrar todas las asignaciones de roles para el grupo de recursos administrados.
Get-AzRoleAssignment -ResourceGroupName $mrgname
La definición de aplicación administrada que creó en los artículos de inicio rápido usó un grupo con la asignación de roles Propietario. Cree el grupo con el comando siguiente.
Get-AzRoleAssignment -ResourceGroupName $mrgname -RoleDefinitionName Owner
También puede enumerar las asignaciones de denegación para el grupo de recursos administrado.
Get-AzDenyAssignment -ResourceGroupName $mrgname
Limpieza de recursos
Cuando haya terminado con la aplicación administrada, podrá eliminar los grupos de recursos y eso eliminará todos los recursos creados. Por ejemplo, en esta guía de inicio rápido creó los grupos de recursos applicationGroup y un grupo de recursos administrado con el prefijo mrg-sampleManagedApplication.
El comando le pide que confirme que quiere quitar el grupo de recursos.
Remove-AzResourceGroup -Name applicationGroup
Si deseas eliminar la definición de la aplicación administrada, elimina los grupos de recursos que creaste en los artículos de inicio rápido.
- Publicar definición de aplicación: packageStorageGroup y appDefinitionGroup.
- Publicar definición con Trae tu almacenamiento: packageStorageGroup, byosDefinitionStorageGroup y byosAppDefinitionGroup.
Pasos siguientes
- Para obtener información sobre cómo crear y publicar los archivos de definición para una aplicación administrada, ve a Inicio rápido: crear y publicar una definición de aplicación administrada de Azure.
- Para usar tu propio almacenamiento para crear y publicar los archivos de definición para una aplicación administrada, ve a Inicio rápido: trae tu propio almacenamiento para crear y publicar una definición de aplicación administrada de Azure.