You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
258 lines
8.7 KiB
258 lines
8.7 KiB
<#
|
|
.SYNOPSIS
|
|
Deploys a Service Fabric application type to a cluster.
|
|
|
|
.DESCRIPTION
|
|
This script deploys a Service Fabric application type to a cluster. It is invoked by Visual Studio when deploying a Service Fabric Application project.
|
|
|
|
.NOTES
|
|
WARNING: This script file is invoked by Visual Studio. Its parameters must not be altered but its logic can be customized as necessary.
|
|
|
|
.PARAMETER PublishProfileFile
|
|
Path to the file containing the publish profile.
|
|
|
|
.PARAMETER ApplicationPackagePath
|
|
Path to the folder of the packaged Service Fabric application.
|
|
|
|
.PARAMETER DeployOnly
|
|
Indicates that the Service Fabric application should not be created or upgraded after registering the application type.
|
|
|
|
.PARAMETER ApplicationParameter
|
|
Hashtable of the Service Fabric application parameters to be used for the application.
|
|
|
|
.PARAMETER UnregisterUnusedApplicationVersionsAfterUpgrade
|
|
Indicates whether to unregister any unused application versions that exist after an upgrade is finished.
|
|
|
|
.PARAMETER OverrideUpgradeBehavior
|
|
Indicates the behavior used to override the upgrade settings specified by the publish profile.
|
|
'None' indicates that the upgrade settings will not be overridden.
|
|
'ForceUpgrade' indicates that an upgrade will occur with default settings, regardless of what is specified in the publish profile.
|
|
'VetoUpgrade' indicates that an upgrade will not occur, regardless of what is specified in the publish profile.
|
|
|
|
.PARAMETER UseExistingClusterConnection
|
|
Indicates that the script should make use of an existing cluster connection that has already been established in the PowerShell session. The cluster connection parameters configured in the publish profile are ignored.
|
|
|
|
.PARAMETER OverwriteBehavior
|
|
Overwrite Behavior if an application exists in the cluster with the same name. Available Options are Never, Always, SameAppTypeAndVersion. This setting is not applicable when upgrading an application.
|
|
'Never' will not remove the existing application. This is the default behavior.
|
|
'Always' will remove the existing application even if its Application type and Version is different from the application being created.
|
|
'SameAppTypeAndVersion' will remove the existing application only if its Application type and Version is same as the application being created.
|
|
|
|
.PARAMETER SkipPackageValidation
|
|
Switch signaling whether the package should be validated or not before deployment.
|
|
|
|
.PARAMETER SecurityToken
|
|
A security token for authentication to cluster management endpoints. Used for silent authentication to clusters that are protected by Azure Active Directory.
|
|
|
|
.PARAMETER CopyPackageTimeoutSec
|
|
Timeout in seconds for copying application package to image store.
|
|
|
|
.EXAMPLE
|
|
. Scripts\Deploy-FabricApplication.ps1 -ApplicationPackagePath 'pkg\Debug'
|
|
|
|
Deploy the application using the default package location for a Debug build.
|
|
|
|
.EXAMPLE
|
|
. Scripts\Deploy-FabricApplication.ps1 -ApplicationPackagePath 'pkg\Debug' -DoNotCreateApplication
|
|
|
|
Deploy the application but do not create the application instance.
|
|
|
|
.EXAMPLE
|
|
. Scripts\Deploy-FabricApplication.ps1 -ApplicationPackagePath 'pkg\Debug' -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}
|
|
|
|
Deploy the application by providing values for parameters that are defined in the application manifest.
|
|
#>
|
|
|
|
Param
|
|
(
|
|
[String]
|
|
$PublishProfileFile,
|
|
|
|
[String]
|
|
$ApplicationPackagePath,
|
|
|
|
[Switch]
|
|
$DeployOnly,
|
|
|
|
[Hashtable]
|
|
$ApplicationParameter,
|
|
|
|
[Boolean]
|
|
$UnregisterUnusedApplicationVersionsAfterUpgrade,
|
|
|
|
[String]
|
|
[ValidateSet('None', 'ForceUpgrade', 'VetoUpgrade')]
|
|
$OverrideUpgradeBehavior = 'None',
|
|
|
|
[Switch]
|
|
$UseExistingClusterConnection,
|
|
|
|
[String]
|
|
[ValidateSet('Never','Always','SameAppTypeAndVersion')]
|
|
$OverwriteBehavior = 'Never',
|
|
|
|
[Switch]
|
|
$SkipPackageValidation,
|
|
|
|
[String]
|
|
$SecurityToken,
|
|
|
|
[int]
|
|
$CopyPackageTimeoutSec
|
|
)
|
|
|
|
function Read-XmlElementAsHashtable
|
|
{
|
|
Param (
|
|
[System.Xml.XmlElement]
|
|
$Element
|
|
)
|
|
|
|
$hashtable = @{}
|
|
if ($Element.Attributes)
|
|
{
|
|
$Element.Attributes |
|
|
ForEach-Object {
|
|
$boolVal = $null
|
|
if ([bool]::TryParse($_.Value, [ref]$boolVal)) {
|
|
$hashtable[$_.Name] = $boolVal
|
|
}
|
|
else {
|
|
$hashtable[$_.Name] = $_.Value
|
|
}
|
|
}
|
|
}
|
|
|
|
return $hashtable
|
|
}
|
|
|
|
function Read-PublishProfile
|
|
{
|
|
Param (
|
|
[ValidateScript({Test-Path $_ -PathType Leaf})]
|
|
[String]
|
|
$PublishProfileFile
|
|
)
|
|
|
|
$publishProfileXml = [Xml] (Get-Content $PublishProfileFile)
|
|
$publishProfile = @{}
|
|
|
|
$publishProfile.ClusterConnectionParameters = Read-XmlElementAsHashtable $publishProfileXml.PublishProfile.Item("ClusterConnectionParameters")
|
|
$publishProfile.UpgradeDeployment = Read-XmlElementAsHashtable $publishProfileXml.PublishProfile.Item("UpgradeDeployment")
|
|
$publishProfile.CopyPackageParameters = Read-XmlElementAsHashtable $publishProfileXml.PublishProfile.Item("CopyPackageParameters")
|
|
|
|
if ($publishProfileXml.PublishProfile.Item("UpgradeDeployment"))
|
|
{
|
|
$publishProfile.UpgradeDeployment.Parameters = Read-XmlElementAsHashtable $publishProfileXml.PublishProfile.Item("UpgradeDeployment").Item("Parameters")
|
|
if ($publishProfile.UpgradeDeployment["Mode"])
|
|
{
|
|
$publishProfile.UpgradeDeployment.Parameters[$publishProfile.UpgradeDeployment["Mode"]] = $true
|
|
}
|
|
}
|
|
|
|
$publishProfileFolder = (Split-Path $PublishProfileFile)
|
|
$publishProfile.ApplicationParameterFile = [System.IO.Path]::Combine($PublishProfileFolder, $publishProfileXml.PublishProfile.ApplicationParameterFile.Path)
|
|
|
|
return $publishProfile
|
|
}
|
|
|
|
$LocalFolder = (Split-Path $MyInvocation.MyCommand.Path)
|
|
|
|
if (!$PublishProfileFile)
|
|
{
|
|
$PublishProfileFile = "$LocalFolder\..\PublishProfiles\Local.xml"
|
|
}
|
|
|
|
if (!$ApplicationPackagePath)
|
|
{
|
|
$ApplicationPackagePath = "$LocalFolder\..\pkg\Release"
|
|
}
|
|
|
|
$ApplicationPackagePath = Resolve-Path $ApplicationPackagePath
|
|
|
|
$publishProfile = Read-PublishProfile $PublishProfileFile
|
|
|
|
if (-not $UseExistingClusterConnection)
|
|
{
|
|
$ClusterConnectionParameters = $publishProfile.ClusterConnectionParameters
|
|
if ($SecurityToken)
|
|
{
|
|
$ClusterConnectionParameters["SecurityToken"] = $SecurityToken
|
|
}
|
|
|
|
try
|
|
{
|
|
[void](Connect-ServiceFabricCluster @ClusterConnectionParameters)
|
|
}
|
|
catch [System.Fabric.FabricObjectClosedException]
|
|
{
|
|
Write-Warning "Service Fabric cluster may not be connected."
|
|
throw
|
|
}
|
|
}
|
|
|
|
$RegKey = "HKLM:\SOFTWARE\Microsoft\Service Fabric SDK"
|
|
$ModuleFolderPath = (Get-ItemProperty -Path $RegKey -Name FabricSDKPSModulePath).FabricSDKPSModulePath
|
|
Import-Module "$ModuleFolderPath\ServiceFabricSDK.psm1"
|
|
|
|
$IsUpgrade = ($publishProfile.UpgradeDeployment -and $publishProfile.UpgradeDeployment.Enabled -and $OverrideUpgradeBehavior -ne 'VetoUpgrade') -or $OverrideUpgradeBehavior -eq 'ForceUpgrade'
|
|
|
|
$PublishParameters = @{
|
|
'ApplicationPackagePath' = $ApplicationPackagePath
|
|
'ApplicationParameterFilePath' = $publishProfile.ApplicationParameterFile
|
|
'ApplicationParameter' = $ApplicationParameter
|
|
'ErrorAction' = 'Stop'
|
|
}
|
|
|
|
if ($publishProfile.CopyPackageParameters.CopyPackageTimeoutSec)
|
|
{
|
|
$PublishParameters['CopyPackageTimeoutSec'] = $publishProfile.CopyPackageParameters.CopyPackageTimeoutSec
|
|
}
|
|
|
|
if ($publishProfile.CopyPackageParameters.CompressPackage)
|
|
{
|
|
$PublishParameters['CompressPackage'] = $publishProfile.CopyPackageParameters.CompressPackage
|
|
}
|
|
|
|
# CopyPackageTimeoutSec parameter overrides the value from the publish profile
|
|
if ($CopyPackageTimeoutSec)
|
|
{
|
|
$PublishParameters['CopyPackageTimeoutSec'] = $CopyPackageTimeoutSec
|
|
}
|
|
|
|
if ($IsUpgrade)
|
|
{
|
|
$Action = "RegisterAndUpgrade"
|
|
if ($DeployOnly)
|
|
{
|
|
$Action = "Register"
|
|
}
|
|
|
|
$UpgradeParameters = $publishProfile.UpgradeDeployment.Parameters
|
|
|
|
if ($OverrideUpgradeBehavior -eq 'ForceUpgrade')
|
|
{
|
|
# Warning: Do not alter these upgrade parameters. It will create an inconsistency with Visual Studio's behavior.
|
|
$UpgradeParameters = @{ UnmonitoredAuto = $true; Force = $true }
|
|
}
|
|
|
|
$PublishParameters['Action'] = $Action
|
|
$PublishParameters['UpgradeParameters'] = $UpgradeParameters
|
|
$PublishParameters['UnregisterUnusedVersions'] = $UnregisterUnusedApplicationVersionsAfterUpgrade
|
|
|
|
Publish-UpgradedServiceFabricApplication @PublishParameters
|
|
}
|
|
else
|
|
{
|
|
$Action = "RegisterAndCreate"
|
|
if ($DeployOnly)
|
|
{
|
|
$Action = "Register"
|
|
}
|
|
|
|
$PublishParameters['Action'] = $Action
|
|
$PublishParameters['OverwriteBehavior'] = $OverwriteBehavior
|
|
$PublishParameters['SkipPackageValidation'] = $SkipPackageValidation
|
|
|
|
Publish-NewServiceFabricApplication @PublishParameters
|
|
}
|