PowerShell Universal Dashboard: Seu Guia Azure – techsyncer

Se você sabe como escrever PowerShell e precisa construir um painel gráfico representando praticamente qualquer dado, confira o PowerShell Universal Dashboard (UD). UD é uma maneira intuitiva de construir painéis de visualização e até formulários usando apenas o PowerShell. Felizmente, o Universal Powershell Dashboard funciona no Azure!

O Universal Powershell Dashboard é um módulo do PowerShell disponível para ser instalado executando Install-Module -Name UniversalDashboard.Community. O módulo comunitário é gratuito, mas eu recomendo a compra da versão completa.

I’m not going to go into the ins and outs of UD, Adam Driscoll (UD’s developer) has written extensive documentation already on the topic.

UD precisa de um servidor web para funcionar. Você pode escolher executar UD no IIS ou em um Azure Web App. Eu detesto lidar com infraestrutura local, então sempre opto por implantar recursos na nuvem sempre que posso. Como o UD suporta nativamente a execução em um Azure Web App, é o candidato perfeito para a nuvem.

I found that even though UD has docs for setting it up in Azure, I still was struggling with an easy way to get it going. I managed to come up with a rough PowerShell script to setup the latest instance for you all in one swoop.

Ele pode precisar de algum trabalho, mas eu só precisava disso para um próximo curso Pluralsight no qual estava trabalhando. Sinta-se à vontade para melhorá-lo conforme necessário. Espero que os comentários internos expliquem tudo o suficiente.

param(
	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$WebAppName,
	
	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$AzureLocation,

	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$AzureResourceGroup
)

#region Criar o aplicativo web Azure
$appSrvPlan = New-AzAppServicePlan -Name "$WebAppName-AppSrv" -Location $AzureLocation -ResourceGroupName $AzureResourceGroup -Tier Free
$null = New-AzWebApp -Name $WebAppName -AppServicePlan $appSrvPlan.Name -ResourceGroupName $AzureResourceGroup -Location $AzureLocation
#endregion

#region Baixar UD
Save-Module UniversalDashboard.Community -Path $env:TEMP -AcceptLicense
$udModulePath = (Get-ChildItem -Path "$env:TEMP\UniversalDashboard.Community" -Directory).FullName
#endregion

# Obter perfil de publicação para o aplicativo web
$pubProfile = Get-AzWebAppPublishingProfile -Name $Webappname -ResourceGroupName $AzureResourceGroup
$ftpPubProfile = ([xml]$pubProfile).publishData.publishProfile | Where-Object { $_.publishMethod -eq 'FTP' }

## Construir a credencial para autenticação
$password = ConvertTo-SecureString $ftpPubProfile.userPWD -AsPlainText -Force
$azureCred = New-Object System.Management.Automation.PSCredential ($ftpPubProfile.userName, $password)

try {
	$webclient = New-Object -TypeName System.Net.WebClient
	$webclient.Credentials = $azureCred

	#region Criar todas as pastas
	Get-ChildItem -Path $udModulePath -Directory -Recurse | foreach {
		$path = $_.FullName.Replace("$udModulePath\", '').Replace('\', '/')
		$uri = "$($ftpPubProfile.publishUrl)/$path"
		$makeDirectory = [System.Net.WebRequest]::Create($uri)
		$makeDirectory.Credentials = $azureCred
		$makeDirectory.Method = [System.Net.WebRequestMethods+FTP]::MakeDirectory
		Write-Host "Creating folder [$path]..."
		$null = $makeDirectory.GetResponse()
	}
	#endregion

	## Criar um painel simples para iniciar o site
	Set-Content -Path "$udModulePath\dashboard.ps1" -Value 'Start-UDDashboard -Wait'

	#region Carregar todos os arquivos
	Get-ChildItem -Path $udModulePath -File -Recurse | foreach {
		$path = $_.FullName.Replace("$udModulePath\", '').Replace('\', '/').Replace('.\', '')
		$uri = New-Object System.Uri("$($ftpPubProfile.publishUrl)/$path")
		Write-Host "Uploading file [$path]..."
		$null = $webclient.UploadFile($uri, $_.FullName)
	}
	#endregion
} catch {
	$PSCmdlet.ThrowTerminatingError($_)
} finally {
	## Limpeza
	$webclient.Dispose()
}

I called the script New-UDAzureInstance.ps1 and launch it like:

PS> ./New-UDAzureInstance.ps1 -WebAppName ADBPoshUD -AzureResourceGroup 'Course-PowerShellDevOpsPlaybook' -AzureLocation 'East US'

Depois de configurar o UD no Azure, você pode modificar o arquivo dashboard.ps1 para criar qualquer tipo de painel que você precisar.

Acesse a URL do seu aplicativo web Azure e desfrute da glória de uma instância recém-instalada do Universal Powershell Dashboard.

I hope this saves some people some time setting up Universal Powershell Dashboard in Azure!