다음을 통해 공유

sfctl cluster

  • 아티클

Service Fabric 클러스터를 선택, 관리 및 운영합니다.

명령

명령 설명
코드 버전 Service Fabric 클러스터에서 프로비전되는 패브릭 코드 버전 목록을 가져옵니다.
config-versions Service Fabric 클러스터에 프로비전 되는 패브릭 구성 버전의 목록을 가져옵니다.
Health Service Fabric 클러스터의 상태를 가져옵니다.
매니페스트 Service Fabric 클러스터 매니페스트를 가져옵니다.
operation-cancel 사용자가 유발한 오류 작업을 취소합니다.
operation-list 제공된 입력으로 필터링한 사용자로 인한 오류 작업 목록을 가져옵니다.
프로비저닝 Service Fabric 클러스터의 코드 또는 구성 패키지를 프로비전합니다.
recover-system Service Fabric 클러스터에 현재 쿼럼 손실로 중단된 시스템 서비스를 복구하려고 시도해야 했음을 나타냅니다.
report-health Service Fabric 클러스터 대한 상태 보고서를 보냅니다.
선택 Service Fabric 클러스터 엔드포인트에 연결합니다.
연결 표시 이 sfctl 인스턴스가 연결된 Service Fabric 클러스터를 표시합니다.
구축 Service Fabric 클러스터의 코드 또는 구성 패키지를 프로비전 해제합니다.
Upgrade(업그레이드) Service Fabric 클러스터의 코드 또는 구성 버전 업그레이드를 시작합니다.
upgrade-resume 클러스터 업그레이드를 다음 업그레이드 도메인으로 이동합니다.
업그레이드 롤백 Service Fabric 클러스터의 업그레이드를 롤백합니다.
upgrade-status 현재 클러스터 업그레이드의 진행률을 가져옵니다.
upgrade-update Service Fabric 클러스터 업그레이드의 업그레이드 매개 변수를 업데이트합니다.

sfctl cluster code-versions

Service Fabric 클러스터에서 프로비전되는 패브릭 코드 버전 목록을 가져옵니다.

클러스터에서 프로비전되는 패브릭 코드 버전에 대한 정보 목록을 가져옵니다. 매개 변수 CodeVersion은 필요에 따라 출력을 해당 특정 버전으로만 필터링하는 데 사용할 수 있습니다.

인수

Argument 설명
--code-version Service Fabric의 제품 버전입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster config-versions

Service Fabric 클러스터에 프로비전 되는 패브릭 구성 버전의 목록을 가져옵니다.

클러스터에서 프로비전되는 패브릭 구성 버전에 대한 정보 목록을 가져옵니다. 매개 변수 ConfigVersion은 필요에 따라 출력을 해당 특정 버전으로만 필터링하는 데 사용할 수 있습니다.

인수

Argument 설명
--config-version Service Fabric의 구성 버전입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster health

Service Fabric 클러스터의 상태를 가져옵니다.

EventsHealthStateFilter를 사용하여 상태 상태에 따라 클러스터에 보고된 상태 이벤트의 컬렉션을 필터링합니다. 마찬가지로, 집계된 상태에 따라 반환된 노드 및 애플리케이션 컬렉션을 필터링할 NodesHealthStateFilter 및 ApplicationsHealthStateFilter를 사용합니다.

인수

Argument 설명
--applications-health-state-filter 상태 상태에 따라 클러스터 상태 쿼리의 결과로 반환된 애플리케이션 상태 개체를 필터링할 수 있습니다. 이 매개 변수에 사용 가능한 값은 HealthStateFilter 열거형의 멤버 또는 멤버에 대한 비트 연산에서 가져온 정수 값입니다. 필터와 일치하는 애플리케이션만 반환됩니다. 모든 애플리케이션은 집계된 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다. 상태 값은 플래그 기반 열거형이므로 값은 비트 OR 연산자를 사용하여 구한 값의 조합일 수 있습니다. 예를 들어 제공된 값이 6이면 HealthState 값이 OK(2) 및 Warning(4)인 애플리케이션의 상태가 반환됩니다.
- 기본 - 기본값. 모든 HealthState와 일치합니다. 값이 0입니다.
- None - HealthState 값과 일치하지 않는 필터입니다. 주어진 상태 컬렉션에 대해 결과를 반환하지 않기 위해 사용됩니다. 값은 1입니다.
- Ok – HealthState 값이 Ok인 입력과 일치하는 필터입니다. 값은 2입니다.
- Warning – HealthState 값이 Warning인 입력과 일치하는 필터입니다. 값은 4입니다.
- Error - HealthState 값이 Error인 입력과 일치하는 필터입니다. 값은 8입니다.
- All - 모든 HealthState 값의 입력과 일치하는 필터입니다. 값은 65535입니다.
--events-health-state-filter 상태에 따라 반환된 HealthEvent 개체의 컬렉션을 필터링할 수 있습니다. 이 매개 변수에 사용할 수 있는 값은 다음 상태 중 하나의 정수 값을 포함합니다. 필터와 일치하는 이벤트만 반환됩니다. 모든 이벤트는 집계된 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다. 상태 값은 플래그 기반 열거형이므로 값은 비트 'OR' 연산자를 사용하여 가져온 이러한 값의 조합일 수 있습니다. 예를 들어 제공된 값이 6이면 HealthState 값이 OK(2) 및 Warning(4)인 모든 이벤트가 반환됩니다.
- 기본 - 기본값. 모든 HealthState와 일치합니다. 값이 0입니다.
- None - HealthState 값과 일치하지 않는 필터입니다. 주어진 상태 컬렉션에 대해 결과를 반환하지 않기 위해 사용됩니다. 값은 1입니다.
- Ok – HealthState 값이 Ok인 입력과 일치하는 필터입니다. 값은 2입니다.
- Warning – HealthState 값이 Warning인 입력과 일치하는 필터입니다. 값은 4입니다.
- Error - HealthState 값이 Error인 입력과 일치하는 필터입니다. 값은 8입니다.
- All - 모든 HealthState 값의 입력과 일치하는 필터입니다. 값은 65535입니다.
--exclude-health-statistics 상태 통계가 쿼리 결과의 일부로 반환되어야 하는지 여부를 나타냅니다. 기본적으로 False입니다. 통계는 Ok, Warning 및 Error 상태의 자식 엔터티 수를 보여줍니다.
--include-system-application-health-statistics 상태 통계에 fabric:/System 애플리케이션 상태 통계를 포함할지 여부를 지정합니다. 기본적으로 False입니다. IncludeSystemApplicationHealthStatistics가 true로 설정된 경우 fabric:/System 애플리케이션에 속한 엔터티를 포함합니다. 그렇지 않으면 쿼리 결과는 사용자 애플리케이션에 대해서만 상태 통계를 포함합니다. 이 매개 변수를 적용하려면 상태 통계를 쿼리 결과에 포함해야 합니다.
--nodes-health-state-filter 상태에 따라 클러스터 상태 쿼리의 결과로 반환된 노드 상태 개체를 필터링할 수 있습니다. 이 매개 변수에 사용할 수 있는 값은 다음 상태 중 하나의 정수 값을 포함합니다. 필터와 일치하는 노드만 반환됩니다. 모든 노드는 집계된 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다. 상태 값은 플래그 기반 열거형이므로 값은 비트 OR 연산자를 사용하여 구한 값의 조합일 수 있습니다. 예를 들어 제공된 값이 6이면 HealthState 값이 OK(2) 및 Warning(4)인 노드의 상태가 반환됩니다.
- 기본 - 기본값. 모든 HealthState와 일치합니다. 값이 0입니다.
- None - HealthState 값과 일치하지 않는 필터입니다. 주어진 상태 컬렉션에 대해 결과를 반환하지 않기 위해 사용됩니다. 값은 1입니다.
- Ok – HealthState 값이 Ok인 입력과 일치하는 필터입니다. 값은 2입니다.
- Warning – HealthState 값이 Warning인 입력과 일치하는 필터입니다. 값은 4입니다.
- Error - HealthState 값이 Error인 입력과 일치하는 필터입니다. 값은 8입니다.
- All - 모든 HealthState 값의 입력과 일치하는 필터입니다. 값은 65535입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster manifest

Service Fabric 클러스터 매니페스트를 가져옵니다.

Service Fabric 클러스터 매니페스트를 가져옵니다. 클러스터 매니페스트에는 클러스터의 다른 노드 형식, 보안 구성, 오류 및 업그레이드 도메인 토폴로지 등을 포함하는 클러스터의 속성이 있습니다. 이러한 속성은 독립 실행형 클러스터를 배포하는 동안 ClusterConfig.JS 파일의 일부로 지정됩니다. 그러나 클러스터 매니페스트의 대부분의 정보는 다른 배포 시나리오(예: Azure Portal 사용 시)에서 클러스터를 배포하는 동안 서비스 패브릭에 의해 내부적으로 생성됩니다. 클러스터 매니페스트의 콘텐츠는 정보 제공 용도로만 사용되며 사용자는 파일 내용의 형식이나 해석에 종속되지 않습니다.

인수

Argument 설명
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster operation-cancel

사용자가 유발한 오류 작업을 취소합니다.

다음 API는 CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition을 사용하여 취소될 수 있는 오류 작업을 시작합니다. force가 false이면 지정된 사용자 유도 작업이 정상적으로 중지되고 정리됩니다. force가 true이면 명령이 중단되고 일부 내부 상태가 남을 수 있습니다. force를 true로 지정하는 것은 주의해서 사용해야 합니다. 강제가 true로 설정된 상태에서 이 API를 호출하는 것은 강제가 false로 설정된 동일한 테스트 명령에서 이미 호출되었거나 테스트 명령에 OperationState.RollingBack의 OperationState가 이미 있는 경우가 아니면 허용되지 않습니다. 설명: OperationState.RollingBack은 시스템이 명령 실행으로 인해 발생된 내부 시스템 상태를 정리함을 의미합니다. 테스트 명령으로 인해 데이터가 손실되는 경우 데이터를 복원하지 않습니다. 예를 들어 StartDataLoss를 호출한 다음 이 API를 호출하는 경우 시스템은 명령을 실행하지 못하도록 내부 상태만 정리합니다. 명령이 데이터 손실을 일으킬 만큼 충분히 진행된 경우 대상 파티션의 데이터를 복원하지 않습니다. 중요 설명: 이 API가 force==true로 호출되면 내부 상태는 남아 있을 수 있습니다.

인수

Argument 설명
--operation-id [필수] 이 API의 호출을 식별하는 GUID입니다. 해당 GetProgress API에 전달됩니다.
--force 사용자로 인한 작업을 실행하여 수정된 내부 시스템 상태를 정상적으로 롤백 및 정리할지 여부를 나타냅니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster operation-list

제공된 입력으로 필터링한 사용자로 인한 오류 작업 목록을 가져옵니다.

제공된 입력으로 필터링된 사용자 유도 오류 작업의 목록을 가져옵니다.

인수

Argument 설명
--state-filter 사용자가 유도한 작업에 대해 OperationState를 필터링하는 데 사용됩니다. - 65535 - 모두 선택 - 1 - 실행 선택 - 2 - 롤링백 선택 - 8 - 완료됨 선택 - 16 - 오류 선택 - 32 - 취소됨 선택 - 64 - ForceCancelled 선택. 기본값: 65535.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.
--type-filter 사용자로 인한 작업에 대한 OperationType을 필터링하는 데 사용됩니다. - 65535 - 모두 선택 - 1 - PartitionDataLoss를 선택합니다. - 2 - PartitionQuorumLoss를 선택합니다. - 4 - PartitionRestart를 선택합니다. - 8 - NodeTransition을 선택합니다. 기본값: 65535.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster provision

Service Fabric 클러스터의 코드 또는 구성 패키지를 프로비전합니다.

Service Fabric 클러스터의 코드 또는 구성 패키지의 유효성을 검사하고 프로비전합니다.

인수

Argument 설명
--cluster-manifest-file-path 클러스터 매니페스트 파일 경로입니다.
--code-file-path 클러스터 코드 패키지 파일 경로입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster recover-system

Service Fabric 클러스터에 현재 쿼럼 손실로 중단된 시스템 서비스를 복구하려고 시도해야 했음을 나타냅니다.

Service Fabric 클러스터에 현재 쿼럼 손실로 중단된 시스템 서비스를 복구하려고 시도해야 했음을 나타냅니다. 이 작업은 다운된 복제본을 복구할 수 없는 것으로 알려진 경우에만 수행해야 합니다. 이 API를 잘못 사용하면 잠재적인 데이터 손실이 발생할 수 있습니다.

인수

Argument 설명
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster report-health

Service Fabric 클러스터 대한 상태 보고서를 보냅니다.

Service Fabric 클러스터에 상태 보고서를 보냅니다. 보고서에는 보고되는 상태 보고서 및 속성의 원본에 대한 정보가 포함되어야 합니다. 보고서는 상태 저장소로 전달되는 Service Fabric 게이트웨이 노드로 전송됩니다. 보고서는 게이트웨이에서 수락할 수 있지만 추가 유효성 검사 후 상태 저장소에서 거부됩니다. 예를 들어 상태 저장소는 부실 시퀀스 번호와 같은 잘못된 매개 변수로 인해 보고서를 거부할 수 있습니다. 보고서가 Health 스토어에서 적용되었는지 여부를 확인하려면 GetClusterHealth를 실행하고 해당 보고서가 HealthEvents 섹션에 표시되는지 확인합니다.

인수

Argument 설명
--health-property [필수] 상태 정보의 속성입니다.

엔터티는 다양한 속성에 대한 상태 보고서를 가질 수 있습니다. 이 속성은 보고서를 트리거하는 상태 조건을 보고자가 유연하게 분류할 수 있도록 하는 고정 열거형이 아닌 문자열입니다. 예를 들어 SourceId "LocalWatchdog"를 사용하는 기자는 노드에서 사용 가능한 디스크의 상태를 모니터링할 수 있으므로 해당 노드에서 "AvailableDisk" 속성을 보고할 수 있습니다. 동일한 보고자는 노드 연결을 모니터링할 수 있으므로 동일한 노드에서 "Connectivity" 속성을 보고할 수 있습니다. 상태 저장소에서 이러한 보고서는 지정된 노드에 대한 별도의 상태 이벤트로 처리됩니다. SourceId와 함께 이 속성은 상태 정보를 고유하게 식별합니다.
--health-state[필수] 가능한 값은 'Invalid', 'Ok', 'Warning', 'Error', 'Unknown'입니다.
--source-id [필수] 상태 정보를 생성한 클라이언트/watchdog/시스템 구성 요소를 식별하는 원본 이름입니다.
--묘사 상태 정보에 대한 설명입니다.

보고서에 대한 사람이 읽을 수 있는 정보를 추가하는 데 사용되는 무료 텍스트를 나타냅니다. 설명의 최대 문자열 길이는 4096자입니다. 제공된 문자열이 더 길면 자동으로 잘립니다. 잘린 경우 설명의 마지막 문자에는 "[Truncated]" 표식이 포함되고 총 문자열 크기는 4096자입니다. 표식은 사용자에게 잘림이 발생했음을 나타냅니다. 잘린 경우 설명은 원래 문자열에서 4096자 미만입니다.
--즉시 보고서를 즉시 보낼지 여부를 나타내는 플래그입니다.

상태 보고서는 상태 저장소로 전달되는 Service Fabric 게이트웨이 애플리케이션으로 전송됩니다. 직접 실행이 true로 설정되면 HTTP 게이트웨이 애플리케이션에서 사용하는 패브릭 클라이언트 설정에 관계없이 보고서가 HTTP 게이트웨이에서 상태 저장소로 즉시 전송됩니다. 이는 가능한 한 빨리 전송해야 하는 중요한 보고서에 유용합니다. 타이밍 및 기타 조건에 따라 보고서 전송이 여전히 실패할 수 있습니다. 예를 들어, HTTP 게이트웨이가 닫혀 있거나 메시지가 게이트웨이에 도달하지 않는 경우입니다. Immediate가 false로 설정된 경우 보고서는 HTTP 게이트웨이의 상태 클라이언트 설정에 따라 전송됩니다. 따라서 HealthReportSendInterval 구성에 따라 일괄 처리됩니다. 상태 클라이언트가 상태 보고서 처리뿐만 아니라 상태 저장소에 대한 상태 보고 메시지를 최적화할 수 있으므로 이 설정을 사용하는 것이 좋습니다. 기본적으로 보고서는 즉시 전송되지 않습니다.
--remove-when-expired 보고서가 만료될 때 Health 스토어에서 제거할지 여부를 나타내는 값입니다.

true로 설정하면 보고서가 만료된 후 상태 저장소에서 제거됩니다. false로 설정하면 보고서가 만료될 때 오류로 처리됩니다. 이 속성의 값은 기본적으로 false입니다. 클라이언트가 주기적으로 보고하는 경우 RemoveWhenExpired를 false(기본값)로 설정해야 합니다. 이렇게 하면 보고자에게 문제가 있고(예: 교착 상태) 보고할 수 없으므로 상태 보고서가 만료되면 엔터티가 오류로 평가됩니다. 이렇게 하면 엔터티가 오류 상태인 것으로 플래그가 지정됩니다.
--sequence-number 이 상태 보고서의 시퀀스 번호(숫자 문자열)입니다.

보고서 시퀀스 번호는 상태 저장소에서 부실 보고서를 검색하는 데 사용됩니다. 지정하지 않으면 보고서가 추가될 때 상태 클라이언트에서 시퀀스 번호가 자동으로 생성됩니다.
--timeout -t 기본값: 60.
--ttl 이 상태 보고서가 유효한 기간입니다. 이 필드는 기간을 지정하는 데 ISO8601 형식을 사용합니다.

클라이언트가 주기적으로 보고하는 경우 TTL(Time to Live)보다 높은 빈도로 보고서를 보내야 합니다. 클라이언트가 전환에 대해 보고하는 경우 시간을 무한으로 설정할 수 있습니다. TTL(Time to Live)이 만료되면 상태 정보가 포함된 상태 이벤트가 Health 스토어에서 제거되거나 RemoveWhenExpired가 true인 경우 또는 RemoveWhenExpired false인 경우 오류로 평가됩니다. 지정하지 않으면 TL(Time to Live)은 기본적으로 무한값으로 설정됩니다.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster select

Service Fabric 클러스터 엔드포인트에 연결합니다.

보안 클러스터에 연결하는 경우 인증서(.crt) 및 키 파일(.key)에 대한 절대 경로 또는 둘 다(.pem)가 있는 단일 파일을 지정합니다. 둘 다 지정하지 마세요. 보안 클러스터에 연결한 경우 필요에 따라 CA 번들 파일 또는 신뢰할 수 있는 CA 인증서 디렉터리에 대한 절대 경로를 지정합니다. localhost에 대한 연결을 포함하여 이 명령을 먼저 실행하지 않고 클러스터에 연결할 수 없습니다. 그러나 로컬 클러스터에 연결하는 데 명시적 엔드포인트는 필요하지 않습니다. 자체 서명된 인증서 또는 잘 알려진 CA에서 서명되지 않은 다른 인증서를 사용하는 경우 --ca 매개 변수를 전달하여 유효성 검사가 통과되도록 합니다. 프로덕션 클러스터에 없는 경우 클라이언트 쪽 유효성 검사를 무시하려면(자체 서명되었거나 잘 알려지지 않은 CA 서명에 유용) --no-verify 옵션을 사용합니다. 가능하지만 프로덕션 클러스터에는 권장되지 않습니다. 그렇지 않으면 인증서 확인 오류가 발생할 수 있습니다.

인수

Argument 설명
--aad 인증을 위해 Microsoft Entra ID를 사용합니다.
--ca 유효한 또는 CA 번들 파일로 처리할 CA 인증서 디렉터리에 대한 절대 경로입니다. CA 인증서 c_rehash <directory> 의 디렉터리를 사용하는 경우 OpenSSL에서 제공하는 먼저 실행하여 인증서 해시를 계산하고 적절한 기호 링크를 만들어야 합니다. 클러스터에서 반환된 인증서가 유효한지 확인하는 데 사용됩니다.
--인증서 클라이언트 인증서 파일의 절대 경로입니다.
--endpoint 포트 및 HTTP 또는 HTTPS 접두사를 포함한 클러스터 엔드포인트 URL입니다. 일반적으로 엔드포인트는 https\://<your-url>\:19080와 같이 표시됩니다. 엔드포인트가 제공되지 않은 경우 기본값은 http\://localhost\:19080입니다.
--key 클라이언트 인증서 키 파일에 대한 절대 경로입니다.
--no-verify HTTPS 사용 시 인증서에 대한 확인 비활성화, 참고: 안전하지 않은 옵션이므로 프로덕션 환경에 사용해서는 안 됩니다.
--pem 클라이언트 인증서의 절대 경로(.pem 파일)입니다.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster show-connection

이 sfctl 인스턴스가 연결된 Service Fabric 클러스터를 표시합니다.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster unprovision

Service Fabric 클러스터의 코드 또는 구성 패키지를 프로비전 해제합니다.

코드 및 구성을 별도로 프로비전 해제할 수 있습니다.

인수

Argument 설명
--code-version 클러스터 코드 패키지 버전입니다.
--config-version 클러스터 매니페스트 버전입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster upgrade

Service Fabric 클러스터의 코드 또는 구성 버전 업그레이드를 시작합니다.

제공된 업그레이드 매개 변수의 유효성을 검사하고 매개 변수가 유효한 경우 Service Fabric 클러스터의 코드 또는 구성 버전 업그레이드를 시작합니다.

인수

Argument 설명
--app-health-map 오류가 발생하기 전에 애플리케이션 이름 쌍의 JSON 인코딩 사전 및 비정상 최대 백분율입니다.
--app-type-health-map 오류를 발생시키기 전의 비정상 애플리케이션 형식 이름 및 최대 비율 쌍의 JSON 인코딩된 사전.
--code-version 클러스터 코드 버전입니다.
--config-version 클러스터 구성 버전입니다.
--delta-health-evaluation 각 업그레이드 도메인 완료 후 절대 상태 평가가 아닌 델타 상태 평가를 사용하도록 설정합니다.
--delta-unhealthy-nodes 클러스터 업그레이드 중에 허용되는 최대 노드 상태 저하 비율입니다. 기본값은 10입니다.

델타는 업그레이드 시작 시 노드의 상태와 상태 평가 시 노드 상태 간에 측정됩니다. 업그레이드 도메인 업그레이드가 완료될 때마다 확인이 수행되어 클러스터의 전역 상태가 허용되는 제한 내에 있는지 확인합니다.
--failure-action 사용할 수 있는 값: 'Invalid', 'Rollback', 'Manual'.
--force-restart 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스를 강제로 다시 시작합니다.

업그레이드는 구성 또는 데이터만 변경합니다.
--health-check-retry 애플리케이션 또는 클러스터가 정상이 아닌지 상태 확인을 수행하는 시도의 시간 간격입니다.
--health-check-stable 업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--health-check-wait 업그레이드 도메인을 완료한 후 상태 확인 프로세스를 시작하기 전에 대기하는 시간입니다.
--replica-set-check-timeout 업그레이드 도메인의 처리를 차단하고 예기치 않은 문제가 발생할 때 가용성 손실을 방지하는 최대 시간입니다.

이 시간 제한이 만료되면 가용성 손실 문제에 관계없이 업그레이드 도메인의 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 부분에 다시 설정됩니다. 유효한 값은 0에서 42949672925 사이입니다.
--rolling-upgrade-mode 가능한 값은 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'입니다. 기본값: UnmonitoredAuto.
--timeout -t 기본값: 60.
--unhealthy-applications 오류를 보고하기 전에 허용되는 비정상 애플리케이션의 최대 백분율입니다.

예를 들어 애플리케이션의 10%가 비정상이 되도록 하려면 이 값은 10입니다. 백분율은 클러스터가 오류로 간주되기 전에 비정상일 수 있는 애플리케이션의 최대 허용 비율을 나타냅니다. 백분율이 존중되지만 하나 이상의 비정상 애플리케이션이 있는 경우 상태는 경고로 평가됩니다. 이는 ApplicationTypeHealthPolicyMap에 포함된 애플리케이션 유형의 애플리케이션을 제외하고 클러스터의 총 애플리케이션 인스턴스 수에 대한 비정상 애플리케이션 수를 나누어 계산합니다. 계산은 적은 수의 애플리케이션에서 하나의 오류를 허용하도록 반올림됩니다.
--unhealthy-nodes 오류를 보고하기 전에 허용되는 비정상 노드의 최대 백분율입니다.

예를 들어 노드의 10%가 비정상이 되도록 하려면 이 값은 10이 됩니다. 백분율은 클러스터가 오류로 간주되기 전에 비정상일 수 있는 노드의 최대 허용 비율을 나타냅니다. 백분율이 존중되지만 하나 이상의 비정상 노드가 있는 경우 상태는 경고로 평가됩니다. 이 백분율은 클러스터에 있는 노드 총 수를 비정상 노드 수로 나눠 계산합니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 큰 클러스터에서 일부 노드는 항상 복구를 위해 중단되거나 중단되므로 이 백분율은 이를 허용하도록 구성해야 합니다.
--upgrade-domain-delta-unhealthy-nodes 클러스터 업그레이드 중에 허용되는 업그레이드 도메인 노드 상태 저하의 최대 허용 비율입니다. 기본값: 15.

델타는 업그레이드 시작 시 업그레이드 도메인 노드의 상태와 상태 평가 시 업그레이드 도메인 노드의 상태 간에 측정됩니다. 업그레이드 도메인의 상태가 허용되는 한도 내에 있는지 확인하기 위해 완료된 모든 업그레이드 도메인에 대해 업그레이드 도메인 업그레이드가 완료될 때마다 확인이 수행됩니다.
--upgrade-domain-timeout FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--upgrade-timeout FailureAction이 실행되기 전에 전체 업그레이드를 완료해야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--warning-as-error 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster upgrade-resume

클러스터 업그레이드를 다음 업그레이드 도메인으로 이동합니다.

클러스터 코드 또는 구성 업그레이드가 적절한 경우 다음 업그레이드 도메인으로 이동하도록 합니다.

인수

Argument 설명
--upgrade-domain [필수] 이 클러스터 업그레이드에 대한 다음 업그레이드 도메인입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster upgrade-rollback

Service Fabric 클러스터의 업그레이드를 롤백합니다.

Service Fabric 클러스터의 코드 또는 구성 업그레이드를 롤백합니다.

인수

Argument 설명
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster upgrade-status

현재 클러스터 업그레이드의 진행률을 가져옵니다.

진행 중인 클러스터 업그레이드의 현재 진행률을 가져옵니다. 현재 진행 중인 업그레이드가 없는 경우 이전 클러스터 업그레이드의 마지막 상태를 가져옵니다.

인수

Argument 설명
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

sfctl cluster upgrade-update

Service Fabric 클러스터 업그레이드의 업그레이드 매개 변수를 업데이트합니다.

인수

Argument 설명
--app-health-map 오류가 발생하기 전에 애플리케이션 이름 쌍의 JSON 인코딩 사전 및 비정상 최대 백분율입니다.
--app-type-health-map 오류를 발생시키기 전의 비정상 애플리케이션 형식 이름 및 최대 비율 쌍의 JSON 인코딩된 사전.
--delta-health-evaluation 각 업그레이드 도메인 완료 후 절대 상태 평가가 아닌 델타 상태 평가를 사용하도록 설정합니다.
--delta-unhealthy-nodes 클러스터 업그레이드 중에 허용되는 최대 노드 상태 저하 비율입니다. 기본값은 10입니다.

델타는 업그레이드 시작 시 노드의 상태와 상태 평가 시 노드 상태 간에 측정됩니다. 업그레이드 도메인 업그레이드가 완료될 때마다 확인이 수행되어 클러스터의 전역 상태가 허용되는 제한 내에 있는지 확인합니다.
--failure-action 사용할 수 있는 값: 'Invalid', 'Rollback', 'Manual'.
--force-restart 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스를 강제로 다시 시작합니다.

업그레이드는 구성 또는 데이터만 변경합니다.
--health-check-retry 애플리케이션 또는 클러스터가 정상이 아닌지 상태 확인을 수행하는 시도의 시간 간격입니다.
--health-check-stable 업그레이드가 다음 업그레이드 도메인으로 진행되기 전에 애플리케이션 또는 클러스터가 정상 상태로 유지되어야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--health-check-wait 업그레이드 도메인을 완료한 후 상태 확인 프로세스를 시작하기 전에 대기하는 시간입니다.
--replica-set-check-timeout 업그레이드 도메인의 처리를 차단하고 예기치 않은 문제가 발생할 때 가용성 손실을 방지하는 최대 시간입니다.

이 시간 제한이 만료되면 가용성 손실 문제에 관계없이 업그레이드 도메인의 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 부분에 다시 설정됩니다. 유효한 값은 0에서 42949672925 사이입니다.
--rolling-upgrade-mode 가능한 값은 'Invalid', 'UnmonitoredAuto', 'UnmonitoredManual', 'Monitored'입니다. 기본값: UnmonitoredAuto.
--timeout -t 기본값: 60.
--unhealthy-applications 오류를 보고하기 전에 허용되는 비정상 애플리케이션의 최대 백분율입니다.

예를 들어 애플리케이션의 10%가 비정상이 되도록 하려면 이 값은 10입니다. 백분율은 클러스터가 오류로 간주되기 전에 비정상일 수 있는 애플리케이션의 최대 허용 비율을 나타냅니다. 백분율이 존중되지만 하나 이상의 비정상 애플리케이션이 있는 경우 상태는 경고로 평가됩니다. 이는 ApplicationTypeHealthPolicyMap에 포함된 애플리케이션 유형의 애플리케이션을 제외하고 클러스터의 총 애플리케이션 인스턴스 수에 대한 비정상 애플리케이션 수를 나누어 계산합니다. 계산은 적은 수의 애플리케이션에서 하나의 오류를 허용하도록 반올림됩니다.
--unhealthy-nodes 오류를 보고하기 전에 허용되는 비정상 노드의 최대 백분율입니다.

예를 들어 노드의 10%가 비정상이 되도록 하려면 이 값은 10이 됩니다. 백분율은 클러스터가 오류로 간주되기 전에 비정상일 수 있는 노드의 최대 허용 비율을 나타냅니다. 백분율이 존중되지만 하나 이상의 비정상 노드가 있는 경우 상태는 경고로 평가됩니다. 이 백분율은 클러스터에 있는 노드 총 수를 비정상 노드 수로 나눠 계산합니다. 계산값은 적은 수의 노드에서 오류 하나를 허용할 수 있도록 반올림됩니다. 큰 클러스터에서 일부 노드는 항상 복구를 위해 중단되거나 중단되므로 이 백분율은 이를 허용하도록 구성해야 합니다.
--upgrade-domain-delta-unhealthy-nodes 클러스터 업그레이드 중에 허용되는 업그레이드 도메인 노드 상태 저하의 최대 허용 비율입니다. 기본값: 15.

델타는 업그레이드 시작 시 업그레이드 도메인 노드의 상태와 상태 평가 시 업그레이드 도메인 노드의 상태 간에 측정됩니다. 업그레이드 도메인의 상태가 허용되는 한도 내에 있는지 확인하기 위해 완료된 모든 업그레이드 도메인에 대해 업그레이드 도메인 업그레이드가 완료될 때마다 확인이 수행됩니다.
--upgrade-domain-timeout FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--upgrade-kind 가능한 값은 'Invalid', 'Rolling', 'Rolling_ForceRestart'입니다. 기본값: 롤링.
--upgrade-timeout FailureAction이 실행되기 전에 전체 업그레이드를 완료해야 하는 시간입니다.

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--warning-as-error 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다.

전역 인수

인수 설명
--debug 로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
--help -h 이 도움말 메시지를 표시하고 종료합니다.
--output -o 출력 형식입니다. 허용되는 값: json, jsonc, table, tsv 기본값: json
--쿼리 JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.
--verbose 로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

다음 단계