PowerShell Universal Dashboard: Seu Guia Azure – techsyncer

Se souber como escrever PowerShell e precisar construir um painel gráfico representando praticamente qualquer dado, confira o PowerShell Universal Dashboard (UD). O UD é uma maneira intuitiva de criar painéis com ótimo visual e até mesmo formulários usando apenas PowerShell. Felizmente, o Universal PowerShell Dashboard funciona no Azure!

Universal PowerShell Dashboard é um módulo PowerShell disponível para instalação através do comando Install-Module -Name UniversalDashboard.Community. O módulo da comunidade é gratuito, mas eu recomendo adquirir a 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 optar por executar o UD no IIS ou em um Azure Web App. Eu não gosto de lidar com infraestrutura local, então sempre escolho implantar recursos na nuvem sempre que possível. Como o UD oferece suporte nativo para 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 ser aprimorado, mas eu só precisava disso para um próximo curso Pluralsight no qual estava trabalhando. Fique à vontade para melhorá-lo conforme necessário. Espero que os comentários internos expliquem tudo adequadamente.

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

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

#região 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
#fim da região

#região Baixar UD
Save-Module UniversalDashboard.Community -Path $env:TEMP -AcceptLicense
$udModulePath = (Get-ChildItem -Path "$env:TEMP\UniversalDashboard.Community" -Directory).FullName
#fim da região

# 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 as credenciais para autenticar
$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

	#região 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()
	}
	#fim da região

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

	#região Fazer upload de 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)
	}
	#fim da região
} 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'

Uma vez que você tenha configurado o UD no Azure, você modificará o arquivo dashboard.ps1 para construir qualquer tipo de painel que precisar.

Navegue até a URL do seu Aplicativo Web Azure e desfrute da glória de uma instância do Universal Powershell Dashboard recém-instalada.

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