다음을 통해 공유

Update-ServiceFabricApplication

  • 참조
모듈:
ServiceFabric

애플리케이션 용량을 업데이트하거나 제거합니다.

구문

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Description

Update-ServiceFabricApplication cmdlet은 이미 만들어진 애플리케이션에 대한 애플리케이션 용량을 업데이트하거나 제거합니다.

애플리케이션 용량은 애플리케이션의 최대/최소 노드와 해당 메트릭에 대한 노드당 용량을 정의합니다.

예제

예제 1: MaximumNodes 및 메트릭 업데이트

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

이 명령은 애플리케이션 패브릭:/MyApp을 업데이트하여 최대 6개의 노드를 사용합니다. 각 노드에는 두 단위의 예약된 부하와 각 노드의 CPU 메트릭에 대해 최대 12개 단위의 부하가 있습니다. 총 애플리케이션 용량은 CPU 메트릭에 대해 16단원입니다. MinimumNodes 값은 변경되지 않은 상태로 유지됩니다.

예제 2: MaximumNodes 업데이트 및 메트릭 다시 설정

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()

이 명령은 최대 6개의 노드를 사용하도록 애플리케이션 패브릭:/MyApp을 업데이트하고 모든 메트릭에 대한 용량을 제거합니다. 이전에 정의된 용량이 있는 경우 이 명령 후에 지워집니다. MinimumNodes 값은 변경되지 않습니다.

예제 3: 모든 애플리케이션 용량 매개 변수 업데이트

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")

이 명령은 애플리케이션 패브릭:/MyApp을 업데이트하여 최대 6개의 노드를 사용합니다. 각 노드에는 두 단위의 예약된 부하와 각 노드의 메트릭 CPU에 대해 최대 12개 단위의 부하가 있습니다. 총 애플리케이션 용량은 CPU 메트릭에 대해 16단원입니다. 최소 노드 값은 2로 업데이트되므로 Service Fabric은 클러스터의 CPU 메트릭에 대해 총 4개의 단위 용량을 예약합니다.

예제 4: 모든 애플리케이션 용량 매개 변수 제거

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity

이 명령은 정의된 애플리케이션 용량 매개 변수가 없도록 애플리케이션 패브릭:/MyApp을 업데이트합니다. MyApp에 이전에 설정된 용량 매개 변수가 있는 경우 이 작업은 이를 지웁니다.

매개 변수

-ApplicationName

업데이트할 애플리케이션의 이름을 지정합니다.

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

-MaximumNodes

애플리케이션을 배치할 최대 노드 수를 지정합니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0으로, 클러스터의 노드 수에 애플리케이션을 배치할 수 있음을 나타냅니다.

이 매개 변수를 지정하지 않으면 애플리케이션은 애플리케이션에 설정된 기존 최대 노드 수를 사용합니다.

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

-Metrics

메트릭 배열을 지정합니다. 이러한 메트릭은 Service Fabric 클러스터 리소스 관리자에서 클러스터의 리소스를 관리하는 데 사용됩니다. Service Fabric의 메트릭 및 리소스 관리에 대한 자세한 내용은 Service Fabric Cluster Resource Manager 소개참조하세요. 각 메트릭은 MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity 패턴을 따르거나 MetricName을 지정하고 매개 변수 이름 NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity 뒤에 콜론으로 구분된 매개 변수 값을 사용할 수 있습니다. 각 매개 변수 name:value 쌍은 한 번에 나타날 수 있습니다.

  • MetricName. 메트릭의 이름을 지정합니다.
  • NodeReservationCapacity. 이 애플리케이션의 인스턴스가 있는 노드에서 예약된 메트릭 로드의 양을 지정합니다. MinimumNodes 지정된 경우 이러한 값의 곱은 애플리케이션용 클러스터에서 예약된 용량입니다.
  • MaximumNodeCapacity. 단일 노드에서 이 애플리케이션의 인스턴스에 대한 최대 부하를 지정합니다. 노드 용량이 이 값보다 크더라도 Service Fabric은 애플리케이션의 자식 복제본의 총 부하를 이 값으로 제한합니다.
  • TotalApplicationCapacity. 클러스터의 애플리케이션에 대한 총 용량을 지정합니다. Service Fabric은 애플리케이션의 자식 복제본 로드 합계를 이 값으로 제한하려고 시도합니다.

용량을 업데이트하는 동안 Service Fabric은 다음 유효성 검사를 수행하고 전달하지 않으면 명령이 실패합니다.

  • NodeReservationCapacity는 MaximumNodeCapacity를 초과하면 안 됩니다.
  • MinimumNodes 매개 변수와 NodeReservationCapacity 메트릭이 모두 지정된 경우 MinimumNodes NodeReservationCapacity의 곱은 TotalApplicationCapacity를 초과하지 않아야 합니다.
형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MinimumNodes

이 애플리케이션에 대해 용량이 예약된 클러스터의 노드 수를 지정합니다. 그렇다고 해서 애플리케이션이 모든 노드에 복제본을 보유하도록 보장되는 것은 아닙니다. 이 매개 변수의 값은 음수가 아닌 정수여야 합니다. 기본값은 0입니다. 즉, 애플리케이션에 예약된 용량이 없습니다.

MinimumNodes가 0으로 설정된 경우 용량이 예약되지 않습니다.

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

-RemoveApplicationCapacity

이 작업은 애플리케이션의 애플리케이션 용량과 관련된 모든 매개 변수를 지웁니다. 이 매개 변수를 지정하는 경우 메트릭 매개 변수를 지정하여 애플리케이션 용량을 업데이트할 수 없습니다.

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

-TimeoutSec

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

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

입력

None

출력

System.Object