Start-ServiceFabricComposeDeploymentUpgrade

참조

모듈:: ServiceFabric

미리 보기. 새 작성 파일을 사용하여 Service Fabric 작성 배포를 업그레이드합니다.

구문

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

이 cmdlet은 미리 보기로 제공되며 다음 릴리스에서 변경될 수 있습니다. 호환성 보장은 없습니다.

Start-ServiceFabricComposeDeploymentUpgrade cmdlet은 Service Fabric 작성 배포를 업그레이드합니다. 이 cmdlet은 클러스터에서 업그레이드를 시작합니다.

Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.

Service Fabric 작성 배포에 대한 지침은 다음을 참조하세요. Service Fabric에서 배포 작성

예제

예제 1: 작성 배포 업그레이드

PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback

이 명령은 compose 파일 docker-compose.yml에서 mydeployment라는 작성 배포에서 모니터링되는 자동 업그레이드를 수행합니다. 모니터링되는 업그레이드가 실패하면 업그레이드가 롤백됩니다. 애플리케이션 유형을 미리 등록할 필요가 없습니다.

매개 변수

-Compose

Service Fabric 작성 배포를 설명하는 대상 작성 파일의 파일 경로를 지정합니다.

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ConsiderWarningAsError

상태 평가 중 경고 상태 이벤트를 오류 이벤트로 처리할지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultServiceTypeHealthPolicy

모니터링되는 업그레이드에 사용할 기본 서비스 유형에 대한 상태 정책을 MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices 형식으로 지정합니다. 예를 들어 5,10,15는

MaxPercentUnhealthyPartitionsPerService = 5
MaxPercentUnhealthyReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeploymentName

작성 배포의 이름을 지정합니다. cmdlet은 이 이름으로 작성 배포를 업그레이드합니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-FailureAction

모니터링되는 업그레이드가 실패할 경우 수행할 작업을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

롤백
설명서

형식:	UpgradeFailureAction
허용되는 값:	Invalid, Rollback, Manual
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Force

이 cmdlet은 경고 메시지를 건너뛰고 강제로 업그레이드를 수행했음을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForceRestart

새 작성 파일에서 서비스 설명이 변경되지 않은 경우에도 작성 파일의 모든 컨테이너를 다시 만들어야 함을 나타냅니다.

형식:	SwitchParameter
Position:	5
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HealthCheckRetryTimeoutSec

이전 상태 검사가 실패하면 Service Fabric이 상태 검사를 다시 시도한 기간(초)을 지정합니다.

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HealthCheckStableDurationSec

배포를 구성하는 애플리케이션이 다음 업그레이드 도메인으로 이동하거나 업그레이드를 완료하기 전에 안정적인지 확인하기 위해 Service Fabric이 대기하는 기간(초)을 지정합니다. 이 대기 기간은 상태 검사가 수행된 직후에 감지되지 않은 상태 변경을 방지합니다.

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HealthCheckWaitDurationSec

Service Fabric이 업그레이드 도메인에서 업그레이드를 완료한 후 초기 상태 검사를 수행하기 전에 대기하는 기간(초)을 지정합니다.

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxPercentUnhealthyDeployedApplications

클러스터의 애플리케이션 상태가 오류이기 전에 오류 상태가 있는 클러스터의 노드에 배포된 애플리케이션 인스턴스의 최대 비율을 지정합니다.

형식:	Byte
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Monitored

업그레이드 모드가 모니터링됨을 나타냅니다. cmdlet에서 업그레이드 도메인에 대한 업그레이드를 완료한 후 업그레이드 도메인 및 클러스터의 상태가 정의한 상태 정책을 충족하는 경우, Service Fabric에서 다음 업그레이드 도메인을 업그레이드합니다. 업그레이드 도메인 또는 클러스터에서 상태 정책이 충족되지 않으면, 업그레이드가 실패하고 Service Fabric에서 업그레이드 도메인에 대한 업그레이드를 롤백하거나 지정한 정책에 따라 수동 모드로 되돌아갑니다. 프로덕션 환경에서 배포 업그레이드를 작성하는 데 권장되는 모드입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PasswordEncrypted

RegistryPassword가 Invoke-ServiceFabricEncryptText로 암호화되었는지를 나타냅니다.

형식:	SwitchParameter
Position:	4
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RegistryPassword

컨테이너 레지스트리의 암호를 나타냅니다. 이 파마미터가 제공되면 RegistryUserName 을 함께 제공해야 합니다.

형식:	String
Position:	3
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RegistryUserName

컨테이너 레지스트리의 사용자 이름을 나타냅니다. 이 파마미터가 제공되면 RegistryPassword 를 함께 제공해야 합니다.

형식:	String
Position:	2
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ServiceTypeHealthPolicyMap

다양한 서비스 유형에 대해 해시 테이블로 사용할 상태 정책의 맵을 지정합니다. @ {"ServiceTypeName": "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. 예를 들면 다음과 같습니다.

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UnmonitoredAuto

업그레이드 모드가 자동으로 모니터링되지 않음을 나타냅니다. Service Fabric에서 업그레이드 도메인을 업그레이드한 후에 애플리케이션 상태와 관계없이 다음 업그레이드 도메인을 업그레이드합니다. 이 모드는 프로덕션에 권장되지 않으며 작성 배포를 개발하는 동안에만 유용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UnmonitoredManual

업그레이드 모드가 수동으로 모니터링되지 않음을 나타냅니다. Service Fabric에서 업그레이드 도메인을 업그레이드한 후에 Resume-ServiceFabricApplicationUpgrade cmdlet을 사용하여 다음 업그레이드 도메인을 업그레이드할 때까지 기다립니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UpgradeDomainTimeoutSec

Service Fabric이 단일 업그레이드 도메인을 업그레이드하는 데 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UpgradeReplicaSetCheckTimeoutSec

Service Fabric이 업그레이드를 진행하기 전에 서비스가 안전한 상태로 다시 구성될 때까지 대기하는 최대 시간을 지정합니다(아직 안전한 상태가 아닌 경우).

형식:	UInt32
Position:	6
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UpgradeTimeoutSec

Service Fabric이 전체 업그레이드에 걸리는 최대 시간(초)을 지정합니다. 이 기간이 지나면 업그레이드가 실패합니다.

형식:	UInt32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

출력

System.Object

다음을 통해 공유

Start-ServiceFabricComposeDeploymentUpgrade

구문

Description

예제

예제 1: 작성 배포 업그레이드

매개 변수

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

입력

출력

추가 리소스

다음을 통해 공유

Start-ServiceFabricComposeDeploymentUpgrade

구문

Description

예제

예제 1: 작성 배포 업그레이드

매개 변수

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

입력

출력

관련 링크

추가 리소스