PowerShell Universal Dashboard: Ваш руководитель по Azure – techsyncer

Если вы знаете, как писать на PowerShell и вам нужно создать графическую панель, отображающую практически любые данные, обратите внимание на PowerShell Universal Dashboard (UD). UD – интуитивный способ создавать красивые панели и даже формы, используя только PowerShell. К счастью, Universal PowerShell Dashboard работает в Azure!

Universal PowerShell Dashboard – это модуль PowerShell, который можно установить, запустив Install-Module -Name UniversalDashboard.Community. Сообщество предоставляет бесплатный модуль, но я настоятельно рекомендую приобрести полную версию.

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 необходим веб-сервер. Вы можете выбрать запуск UD на IIS или в веб-приложении Azure. Лично я предпочитаю избегать работы с инфраструктурой на месте, поэтому всегда выбираю развертывание ресурсов в облаке, когда могу. Поскольку UD изначально поддерживает запуск в веб-приложении Azure, это идеальный вариант для облака.

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.

Можно внести некоторые изменения, но мне просто нужно было это для предстоящего курса Pluralsight, над которым я работал. Не стесняйтесь улучшать его по мере необходимости. Надеюсь, комментарии внутри достаточно хорошо все объяснят.

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

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

#region Создание веб-приложения 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 Загрузка UD
Save-Module UniversalDashboard.Community -Path $env:TEMP -AcceptLicense
$udModulePath = (Get-ChildItem -Path "$env:TEMP\UniversalDashboard.Community" -Directory).FullName
#endregion

# Получение файла публикации для веб-приложения
$pubProfile = Get-AzWebAppPublishingProfile -Name $Webappname -ResourceGroupName $AzureResourceGroup
$ftpPubProfile = ([xml]$pubProfile).publishData.publishProfile | Where-Object { $_.publishMethod -eq 'FTP' }

## Построение учетных данных для аутентификации
$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 Создание всех папок
	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

	## Создание простой панели инструментов для запуска сайта
	Set-Content -Path "$udModulePath\dashboard.ps1" -Value 'Start-UDDashboard -Wait'

	#region Загрузка всех файлов
	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 {
	## Очистка
	$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'

После настройки UD в Azure измените файл dashboard.ps1, чтобы создать любую необходимую панель инструментов.

Перейдите по URL вашего веб-приложения Azure и наслаждайтесь свежеустановленным экземпляром Universal Powershell Dashboard.

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