Início Rápido: Implantar um aplicativo gerenciado do catálogo de serviços

Para obter a definição do aplicativo gerenciado com o Azure PowerShell, execute os comandos a seguir.

No Visual Studio Code, abra um novo terminal do PowerShell e entre em sua assinatura do Azure.

Connect-AzAccount

O comando abre o navegador padrão e solicita que você entre no Azure. Para obter mais informações, vá para Entrar com o Azure PowerShell.

Em Azure PowerShell, obtenha a definição do aplicativo gerenciado. Neste exemplo, use o nome do grupo de recursos appDefinitionGroup que foi criado quando você implantou a definição do aplicativo gerenciado.

Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup

Get-AzManagedApplicationDefinition lista todas as definições disponíveis no grupo de recursos especificado, como sampleManagedApplication.

Criar uma variável para a ID do recurso da definição de aplicativo gerenciado.

$definitionid = (Get-AzManagedApplicationDefinition -ResourceGroupName appDefinitionGroup -Name sampleManagedApplication).ManagedApplicationDefinitionId

Você usará o valor de variável $definitionid ao implantar a definição de aplicativo gerenciado.

Para obter a definição do aplicativo gerenciado com a CLI do Azure, execute os seguintes comandos.

No Visual Studio Code, abra uma nova sessão do terminal Bash e entre com sua assinatura do Azure. Se você tem o Git instalado, selecione Git Bash.

az login

O comando abre o navegador padrão e solicita que você entre no Azure. Para obter mais informações, acesse Entrar com a CLI do Azure .

A partir da CLI do Azure, obtenha a definição do aplicativo gerenciado. Neste exemplo, use o nome do grupo de recursos appDefinitionGroup que foi criado quando você implantou a definição do aplicativo gerenciado.

az managedapp definition list --resource-group appDefinitionGroup

O comando lista todas as definições disponíveis no grupo de recursos especificado, como sampleManagedApplication.

Criar uma variável para a ID do recurso da definição de aplicativo gerenciado.

definitionid=$(az managedapp definition show --resource-group appDefinitionGroup --name sampleManagedApplication --query id --output tsv)

Você usará o valor de variável $definitionid ao implantar a definição de aplicativo gerenciado.

Para obter a definição do aplicativo gerenciado do portal do Azure, use as etapas a seguir.

1. Entre no portal do Azure.

2. Selecione Criar um recurso.

   

3. Pesquise Aplicativo Gerenciado de Catálogo de Serviço e selecione-o entre as opções disponíveis.

4. O Aplicativo gerenciado do Catálogo de Serviços é exibido. Selecione Criar.

   

5. Selecione Amostra de aplicativo gerenciado e depois selecione Criar.

   O portal exibe as definições dos aplicativos gerenciados que você publicou com os artigos de início rápido.

   

Crie um grupo de recursos para a implantação do aplicativo gerenciado.

New-AzResourceGroup -Name applicationGroup -Location westus

Você também precisará criar um nome para o grupo de recursos de aplicativo gerenciado. O grupo de recursos é criado quando você implanta o aplicativo gerenciado.

Execute os comandos a seguir para criar o nome do grupo de recursos gerenciado.

$mrgprefix = 'mrg-sampleManagedApplication-'
$mrgtimestamp = Get-Date -UFormat "%Y%m%d%H%M%S"
$mrgname = $mrgprefix + $mrgtimestamp
$mrgname

As variáveis $mrgprefix e $mrgtimestamp são concatenadas e armazenadas na variável $mrgname. O valor da variável está no formato mrg-sampleManagedApplication-20230512103059. Você usará o valor de variável $mrgname ao implantar a definição de aplicativo gerenciado.

Você precisa fornecer vários parâmetros ao comando de implantação para o aplicativo gerenciado. Você poderá usar uma cadeia de caracteres formatada em JSON ou criar um arquivo JSON. Neste exemplo, usamos uma cadeia de caracteres formatada em JSON. O caractere de escape do PowerShell para as aspas é o caractere backtick (`). O backtick também é usado para continuação de linha para que os comandos possam usar várias linhas.

A sintaxe da cadeia de caracteres formatada em JSON é a seguinte:

"{ `"parameterName`": {`"value`":`"parameterValue`"}, `"parameterName`": {`"value`":`"parameterValue`"} }"

Para legibilidade, a cadeia de caracteres JSON concluída usa o backtick para continuação de linha. Os valores são armazenados na variável $params e usados no comando de implantação. Os parâmetros na cadeia de caracteres JSON são necessários para implantar os recursos gerenciados.

$params="{ `"appServicePlanName`": {`"value`":`"demoAppServicePlan`"}, `
`"appServiceNamePrefix`": {`"value`":`"demoApp`"} }"

Os parâmetros para criar os recursos gerenciados:

• appServicePlanName: crie um nome de plano. Máximo de 40 caracteres alfanuméricos e hifens. Por exemplo, demoAppServicePlan. Os nomes dos Planos dos Serviços de Aplicativo devem ser exclusivos dentro de um grupo de recursos em sua assinatura.
• appServiceNamePrefix: Criar um prefixo para o nome do plano. Máximo de 47 caracteres alfanuméricos ou hifens. Por exemplo, demoApp. Durante a implantação, o prefixo é concatenado com uma cadeia de caracteres exclusiva para criar um nome global que é exclusivo em todo o Azure.

Crie um grupo de recursos para a implantação do aplicativo gerenciado.

az group create --name applicationGroup --___location westus

Você também precisa criar um nome e um caminho para o grupo de recursos de aplicativos gerenciados. O grupo de recursos é criado quando você implanta o aplicativo gerenciado.

Execute os seguintes comandos para criar o caminho do grupo de recursos gerenciados.

mrgprefix='mrg-sampleManagedApplication-'
mrgtimestamp=$(date +%Y%m%d%H%M%S)
mrgname="${mrgprefix}${mrgtimestamp}"
subid=$(az account list --query [].id --output tsv)
mrgpath="/subscriptions/$subid/resourceGroups/$mrgname"

As variáveis $mrgprefix e $mrgtimestamp são concatenadas e armazenadas na variável $mrgname. O valor da variável está no formato mrg-sampleManagedApplication-20230512103059. As variáveis mrgname e subid são concatenadas para criar o valor da variável mrgpath que cria o grupo de recursos gerenciados durante a implantação.

Você precisa fornecer vários parâmetros ao comando de implantação para o aplicativo gerenciado. Você poderá usar uma cadeia de caracteres formatada em JSON ou criar um arquivo JSON. Neste exemplo, usamos uma cadeia de caracteres formatada em JSON. Em Bash, o caractere de escape para as aspas é o caractere de barra invertida (\). A barra invertida também é usada para a continuação da linha para que os comandos possam usar várias linhas.

A sintaxe da cadeia de caracteres formatada em JSON é a seguinte:

"{ \"parameterName\": {\"value\":\"parameterValue\"}, \"parameterName\": {\"value\":\"parameterValue\"} }"

Para legibilidade, a cadeia de caracteres JSON concluída usa a barra invertida para continuação de linha. Os valores são armazenados na variável params e usados no comando de implantação. Os parâmetros na cadeia de caracteres JSON são necessários para implantar os recursos gerenciados.

params="{ \"appServicePlanName\": {\"value\":\"demoAppServicePlan\"}, \
\"appServiceNamePrefix\": {\"value\":\"demoApp\"} }"

Os parâmetros para criar os recursos gerenciados:

• appServicePlanName: crie um nome de plano. Máximo de 40 caracteres alfanuméricos e hifens. Por exemplo, demoAppServicePlan. Os nomes dos Planos dos Serviços de Aplicativo devem ser exclusivos dentro de um grupo de recursos em sua assinatura.
• appServiceNamePrefix: Criar um prefixo para o nome do plano. Máximo de 47 caracteres alfanuméricos ou hifens. Por exemplo, demoApp. Durante a implantação, o prefixo é concatenado com uma cadeia de caracteres exclusiva para criar um nome global que é exclusivo em todo o Azure.

1. Forneça valores para a guia Noções básicas e selecione Próximo.

   

   • Assinatura: escolha a assinatura na qual deseja implantar o aplicativo gerenciado.
   • Grupo de recursos: escolha o grupo de recursos. Para este exemplo, crie um grupo de recursos chamado applicationGroup.
   • Região: selecione a localização na qual deseja implantar os recursos.
   • Nome do Aplicativo: insira um nome para o aplicativo. Para este exemplo, use demoManagedApplication.
   • Grupo de Recursos Gerenciados: o nome do grupo de recursos gerenciados que contém os recursos que são implantados para o aplicativo gerenciado. O nome padrão está no formato mrg-{definitionName}-{dateTime} mas você pode alterar o nome.

2. Forneça valores para a guia Configurações do aplicativo Web e selecione Próximo.

   

   • Nomes dos Planos dos Serviços de Aplicativo: Criar um nome de plano. Máximo de 40 caracteres alfanuméricos e hifens. Por exemplo, demoAppServicePlan. Os nomes dos Planos dos Serviços de Aplicativo devem ser exclusivos dentro de um grupo de recursos em sua assinatura.
   • Prefixo do nome do Serviço de Aplicativo: Criar um prefixo para o nome do plano. Máximo de 47 caracteres alfanuméricos ou hifens. Por exemplo, demoApp. Durante a implantação, o prefixo é concatenado com uma cadeia de caracteres exclusiva para criar um nome global que é exclusivo em todo o Azure.

Execute o comando a seguir para implantar o aplicativo gerenciado.

New-AzManagedApplication `
  -Name "demoManagedApplication" `
  -ResourceGroupName applicationGroup `
  -Location westus `
  -ManagedResourceGroupName $mrgname `
  -ManagedApplicationDefinitionId $definitionid `
  -Kind ServiceCatalog `
  -Parameter $params

Os parâmetros usados no comando de implantação:

• Name: especifique um nome para o aplicativo gerenciado. Para este exemplo, use demoManagedApplication.
• ResourceGroupName: nome do grupo de recursos que você criou para o aplicativo gerenciado.
• Location: especifique a região para implantar os recursos. Para este exemplo, use westus.
• ManagedResourceGroupName: usa o valor da variável $mrgname. O grupo de recursos gerenciados é criado quando o aplicativo gerenciado é implantado.
• ManagedApplicationDefinitionId: usa o valor da variável $definitionid para a ID de recurso da definição de aplicativo gerenciado.
• Kind: especifica esse tipo de aplicativo gerenciado. Este exemplo usa ServiceCatalog.
• Parameter: usa o valor da variável $params na cadeia de caracteres formatada em JSON.

Execute o comando a seguir para implantar o aplicativo gerenciado.

az managedapp create \
  --name demoManagedApplication \
  --resource-group applicationGroup \
  --___location westus \
  --managed-rg-id $mrgpath \
  --managedapp-definition-id $definitionid \
  --kind ServiceCatalog \
  --parameters "$params"

Os parâmetros usados no comando de implantação:

• name: especifique um nome para o aplicativo gerenciado. Para este exemplo, use demoManagedApplication.
• resource-group: nome do grupo de recursos que você criou para o aplicativo gerenciado.
• ___location: especifique a região para implantar os recursos. Para este exemplo, use westus.
• managed-rg-id: usa o valor da variável $mrgpath. O grupo de recursos gerenciados é criado quando o aplicativo gerenciado é implantado.
• managedapp-definition-id: usa o valor da variável $definitionid para a ID de recurso da definição de aplicativo gerenciado.
• kind: especifica esse tipo de aplicativo gerenciado. Este exemplo usa ServiceCatalog.
• parameters: usa o valor da variável $params na cadeia de caracteres formatada em JSON.

Revise o resumo dos valores que você selecionou e verifique se não há erros exibidos. Selecione Criar para implantar o aplicativo gerenciado.

Execute o comando a seguir para verificar o status do aplicativo gerenciado.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup

Expanda as propriedades para facilitar a leitura das informações Properties.

Get-AzManagedApplication -Name demoManagedApplication -ResourceGroupName applicationGroup | Select-Object -ExpandProperty Properties

Execute o comando a seguir para verificar o status do aplicativo gerenciado.

az managedapp list --resource-group applicationGroup

O comando a seguir analisa os dados sobre o aplicativo gerenciado para mostrar apenas o nome e o estado do provisionamento do aplicativo.

az managedapp list --resource-group applicationGroup --query "[].{Name:name, provisioningState:provisioningState}"

Vá para o grupo de recursos denominado applicationGroup e selecione Visão geral. O grupo de recursos contém seu aplicativo gerenciado chamado demoManagedApplication.

Selecione o nome do aplicativo gerenciado para obter mais informações como o link para o grupo de recursos gerenciados.

Para exibir os recursos do grupo de recursos gerenciados, execute o comando a seguir. Você criou a variável $mrgname quando criou os parâmetros.

Get-AzResource -ResourceGroupName $mrgname

Para exibir todas as atribuições de função para o grupo de recursos gerenciados.

Get-AzRoleAssignment -ResourceGroupName $mrgname

A definição de aplicativo gerenciado que você criou nos artigos de início rápido usou um grupo com a atribuição de função Proprietário. Você pode exibir o grupo com o comando a seguir.

Get-AzRoleAssignment -ResourceGroupName $mrgname -RoleDefinitionName Owner

Você também pode listar as atribuições de negação para o grupo de recursos gerenciados.

Get-AzDenyAssignment -ResourceGroupName $mrgname

Para exibir os recursos do grupo de recursos gerenciados, execute o comando a seguir. Você criou a variável $mrgname quando criou os parâmetros.

az resource list --resource-group $mrgname

Execute o comando a seguir para listar somente o nome, tipo e estado de provisionamento dos recursos gerenciados.

az resource list --resource-group $mrgname --query "[].{Name:name, Type:type, provisioningState:provisioningState}"

Execute o comando a seguir para listar a atribuição de função do grupo que foi usado na definição do aplicativo gerenciado.

az role assignment list --resource-group $mrgname

O seguinte comando analisa os dados para a atribuição de função do grupo.

az role assignment list --resource-group $mrgname --role Owner --query "[].{ResourceGroup:resourceGroup, GroupName:principalName, RoleDefinition:roleDefinitionId, Role:roleDefinitionName}"

Para examinar as atribuições de negação do grupo de recursos gerenciados, utilize os comandos do Azure PowerShell ou o portal do Azure.

Vá para o grupo de recursos gerenciados com o prefixo mrg-sampleManagedApplication e selecione Visão geral para exibir os recursos que foram implantados. O grupo de recursos contém um Serviço de Aplicativo, Plano do Serviço de Aplicativo e uma conta de armazenamento.

O grupo de recursos gerenciados e cada recurso criado pelo aplicativo gerenciado tem uma atribuição de função. Quando você usou um artigo de início rápido para criar a definição, também criou um grupo do Microsoft Entra. Esse grupo foi usado na definição do aplicativo gerenciado. Quando você implantou o aplicativo gerenciado, uma atribuição de função para esse grupo foi adicionada aos recursos gerenciados.

Para ver a atribuição de função do portal do Azure:

1. Vá para o seu grupo de recursos mrg-sampleManagedApplication.

2. Selecione Controle de acesso (IAM)>Atribuição de função.

   Você também pode exibir as Atribuições de negação do recurso.

A atribuição de função fornece ao editor do aplicativo acesso para gerenciar a conta de armazenamento. Neste exemplo, o publicador pode ser seu departamento de TI. As Atribuições de negação impedem que os clientes façam alterações na configuração de um recurso gerenciado. Os aplicativos gerenciados são projetados para que os clientes não precisem manter os recursos. As Atribuições de negação excluem o grupo do Microsoft Entra atribuído nas Atribuições de função.

O comando solicita que você confirme se deseja remover o grupo de recursos.

Remove-AzResourceGroup -Name applicationGroup

O comando solicita a confirmação e retorna ao prompt de comando enquanto os recursos estão sendo excluídos.

az group delete --resource-group applicationGroup --no-wait

1. Na Página Inicial do portal do Azure, no campo de pesquisa, insira grupos de recursos.
2. Selecione Grupos de recursos.
3. Selecione applicationGroup e Excluir grupo de recursos.
4. Para confirmar a exclusão, insira o nome do grupo recursos e selecione Excluir.