다음을 통해 공유

sfctl service

  • 아티클

서비스, 서비스 유형 및 서비스 패키지를 만들고 삭제하고 관리합니다.

명령

명령 설명
app-name 서비스에 대한 Service Fabric 애플리케이션의 이름을 가져옵니다.
code-package-list Service Fabric 노드에 배포된 코드 패키지 목록을 가져옵니다.
만들기 지정된 Service Fabric 서비스를 만듭니다.
delete 기존 Service Fabric 서비스를 삭제합니다.
deployed-type Service Fabric 클러스터의 노드에 배포된 애플리케이션의 지정된 서비스 유형에 대한 정보를 가져옵니다.
deployed-type-list Service Fabric 클러스터의 노드에 배포된 애플리케이션의 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다.
description 기존 Service Fabric 서비스에 대한 설명을 가져옵니다.
get-container-logs Service Fabric 노드에 배포된 컨테이너에 대한 컨테이너 로그를 가져옵니다.
Health 지정된 Service Fabric 서비스의 상태를 가져옵니다.
info Service Fabric 애플리케이션에 속하는 특정 서비스에 대한 정보를 가져옵니다.
list 애플리케이션 ID로 지정된 애플리케이션에 속하는 모든 서비스에 대한 정보를 가져옵니다.
매니페스트 서비스 유형을 설명하는 매니페스트를 가져옵니다.
package-deploy 지정한 서비스 매니페스트와 연결된 패키지를 지정된 노드의 이미지 캐시에 다운로드합니다.
package-health Service Fabric 노드 및 애플리케이션에 배포된 특정 애플리케이션의 서비스 패키지 상태에 대한 정보를 가져옵니다.
package-info 지정한 이름과 정확히 일치하는 Service Fabric 노드에 배포된 서비스 패키지 목록을 가져옵니다.
package-list Service Fabric 노드에 배포된 서비스 패키지 목록을 가져옵니다.
복구 Service Fabric 클러스터에 현재 쿼럼 손실에 갇혀 있는 지정된 서비스를 복구하려고 시도해야 했음을 나타냅니다.
report-health Service Fabric 서비스에 대한 상태 보고서를 보냅니다.
resolve Service Fabric 파티션을 확인합니다.
type-list Service Fabric 클러스터에서 프로비전된 애플리케이션 유형에서 지원하는 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다.
업데이트 지정된 업데이트 설명을 사용하여 지정된 서비스를 업데이트합니다.

sfctl service app-name

서비스에 대한 Service Fabric 애플리케이션의 이름을 가져옵니다.

지정된 서비스에 대한 애플리케이션의 이름을 가져옵니다. 제공된 서비스 ID가 있는 서비스가 없는 경우 404 FABRIC_E_SERVICE_DOES_NOT_EXIST 오류가 반환됩니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service code-package-list

Service Fabric 노드에 배포된 코드 패키지 목록을 가져옵니다.

지정된 애플리케이션에 대한 Service Fabric 노드에 배포된 코드 패키지 목록을 가져옵니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--code-package-name Service Fabric 클러스터에서 애플리케이션 형식의 일부로 등록된 서비스 매니페스트에 지정된 코드 패키지의 이름입니다.
--service-manifest-name Service Fabric 클러스터에서 애플리케이션 유형의 일부로 등록된 서비스 매니페스트의 이름입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service create

지정된 Service Fabric 서비스를 만듭니다.

인수

Argument 설명
--app-id[필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0에서 시작하며, 계층적 이름이 '~' 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 ‘fabric:/myapp/app1’인 경우 애플리케이션 ID가 6.0 이상에서는 ‘myapp~app1’이고 이전 버전에서는 ‘myapp/app1’입니다.
--name[필수] 서비스의 이름입니다. 애플리케이션 ID의 자식이어야 합니다. URI를 포함한 fabric\: 전체 이름입니다. 예를 들어 서비스는 fabric\:/A/B 애플리케이션 fabric\:/A의 자식입니다.
--service-type [필수] 서비스 유형의 이름입니다.
--activation-mode 서비스 패키지의 활성화 모드입니다.
--제약 조건 문자열로서의 배치 제약 조건입니다. 배치 제약 조건은 노드 속성에 대한 부울 식이며 서비스 요구 사항에 따라 서비스를 특정 노드로 제한할 수 있습니다. 예를 들어, NodeType이 파란색인 노드에 서비스를 배치하려면 "NodeColor == blue"를 지정합니다.
--correlated-service 상관 관계를 지정할 대상 서비스의 이름입니다.
--상관 맞춤 선호도를 사용하여 서비스를 기존 서비스와 상호 연결합니다.
--dns-name 만들 서비스의 DNS 이름입니다. 이 설정을 위해 Service Fabric DNS 시스템 서비스를 사용하도록 설정해야 합니다.
--instance-count 인스턴스 수입니다. 이는 상태 비지정 서비스에만 적용됩니다.
--int-scheme 서비스가 부호 없는 정수 범위에서 균일하게 분할되어야 했음을 나타냅니다.
--int-scheme-count 균일한 정수 파티션 구성표를 사용하는 경우 생성할 정수 키 범위 내의 파티션 수입니다.
--int-scheme-high 균일한 정수 파티션 구성표를 사용하는 경우 키 정수 범위의 끝입니다.
--int-scheme-low 균일한 정수 파티션 구성표를 사용하는 경우 키 정수 범위의 시작입니다.
--load-metrics 노드 간에 서비스를 부하 분산할 때 사용되는 JSON 인코딩된 메트릭 목록입니다.
--min-replica-set-size 최소 복제본 집합 크기(숫자)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--move-cost 서비스의 이동 비용을 지정합니다. 가능한 값: 'Zero', 'Low', 'Medium', 'High', 'VeryHigh'
--named-scheme 서비스에 여러 개의 명명된 파티션이 있어야 함을 나타냅니다.
--named-scheme-list 명명된 파티션 구성표를 사용하는 경우 서비스를 분할할 이름의 JSON 인코딩된 목록입니다.
--no-persisted-state true이면 서비스에 로컬 디스크에 저장된 영구 상태가 없거나 메모리에 상태만 저장됨을 나타냅니다.
--placement-policy-list 서비스에 대한 배치 정책 및 연결된 도메인 이름의 JSON 인코딩된 목록 입니다. 정책은 NonPartiallyPlaceService PreferPrimaryDomain, RequireDomain, RequireDomainDistribution 중 하나 이상일 수 있습니다.
--quorum-loss-wait 파티션이 쿼럼 손실 상태에 있을 수 있는 최대 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--replica-restart-wait 복제본이 다운된 시점과 새 복제본을 만든 시점 사이의 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--scaling-policies 이 서비스에 대한 크기 조정 정책의 JSON 인코딩된 목록입니다.
--service-placement-time 빌드가 중단된 것을 보고하기 전에 복제본이 InBuild를 유지할 수 있는 기간입니다. 이는 상태 저장 서비스에만 적용됩니다.
--singleton-scheme 서비스에 단일 파티션이 있거나 분할되지 않은 서비스여야 했음을 나타냅니다.
--stand-by-replica-keep StandBy 복제본이 제거되기 전 유지되는 최대 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--상태 서비스가 상태 저장 서비스임을 나타냅니다.
--상태 비저장 서비스가 상태 비정상 서비스임을 나타냅니다.
--target-replica-set-size 대상 복제본 집합 크기는 숫자로 설정됩니다. 이는 상태 저장 서비스에만 적용됩니다.
--timeout -t 기본값: 60.

전역 인수

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

sfctl service delete

기존 Service Fabric 서비스를 삭제합니다.

서비스를 삭제하려면 먼저 만들어야 합니다. 기본적으로 Service Fabric은 서비스 복제를 정상적으로 닫은 후 다음 서비스를 삭제합니다. 그러나 서비스에서 복제본을 정상적으로 닫는 데 문제가 있는 경우 삭제 작업에 시간이 오래 걸리거나 중단될 수 있습니다. 선택적 ForceRemove 플래그를 사용하여 정상적인 닫기 시퀀스를 건너뛰고 서비스를 강제로 삭제합니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--force-remove 정상적인 종료 시퀀스를 거치지 않고 Service Fabric 애플리케이션 또는 서비스를 강제로 제거합니다. 이 매개 변수는 복제본을 정상적으로 닫지 못하게 하는 서비스 코드의 문제로 인해 삭제가 제한되는 애플리케이션 또는 서비스를 강제로 삭제하는 데 사용할 수 있습니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service deployed-type

Service Fabric 클러스터의 노드에 배포된 애플리케이션의 지정된 서비스 유형에 대한 정보를 가져옵니다.

Service Fabric 클러스터의 노드에 배포된 애플리케이션에서 특정 서비스 유형에 대한 정보를 포함하는 목록을 가져옵니다. 응답에는 서비스 유형의 이름, 등록 상태, 등록한 코드 패키지 및 서비스 패키지의 활성화 ID가 포함됩니다. 각 항목은 정품 인증 ID로 구분된 서비스 유형의 활성화를 나타냅니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--service-type-name [필수] Service Fabric 서비스 유형의 이름을 지정합니다.
--service-manifest-name 배포된 서비스 유형 정보 목록을 필터링하는 서비스 매니페스트의 이름입니다. 지정된 경우 응답에는 이 서비스 매니페스트에 정의된 서비스 유형에 대한 정보만 포함됩니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service deployed-type-list

Service Fabric 클러스터의 노드에 배포된 애플리케이션의 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다.

Service Fabric 클러스터의 노드에 배포된 애플리케이션의 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다. 응답에는 서비스 유형의 이름, 등록 상태, 등록한 코드 패키지 및 서비스 패키지의 활성화 ID가 포함됩니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--service-manifest-name 배포된 서비스 유형 정보 목록을 필터링하는 서비스 매니페스트의 이름입니다. 지정된 경우 응답에는 이 서비스 매니페스트에 정의된 서비스 유형에 대한 정보만 포함됩니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service description

기존 Service Fabric 서비스에 대한 설명을 가져옵니다.

기존 Service Fabric 서비스에 대한 설명을 가져옵니다. 설명을 가져오려면 먼저 서비스를 만들어야 합니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service get-container-logs

Service Fabric 노드에 배포된 컨테이너에 대한 컨테이너 로그를 가져옵니다.

지정된 코드 패키지에 대해 Service Fabric 노드에 배포한 컨테이너에 대한 컨테이너 로그를 가져옵니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--code-package-name[필수] Service Fabric 클러스터에서 애플리케이션 형식의 일부로 등록된 서비스 매니페스트에 지정된 코드 패키지의 이름입니다.
--node-name [필수] 노드의 이름입니다.
--service-manifest-name [필수] Service Fabric 클러스터에서 애플리케이션 유형의 일부로 등록된 서비스 매니페스트의 이름입니다.
--이전의 코드 패키지 인스턴스의 종료된/배달 못 한 컨테이너에서 컨테이너 로그를 가져올지 여부를 지정합니다.
--tail 로그의 끝에서 표시할 줄 수입니다. 기본값은 100입니다. 전체 로그를 표시하는 'all'입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service health

지정된 Service Fabric 서비스의 상태를 가져옵니다.

지정된 서비스의 상태 정보를 가져옵니다. EventsHealthStateFilter를 사용하여 상태에 따라 서비스에 보고된 상태 이벤트의 컬렉션을 필터링합니다. PartitionsHealthStateFilter를 사용하여 반환된 파티션 컬렉션을 필터링합니다. Health 스토어에 없는 서비스를 지정하면 이 요청이 오류를 반환합니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--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 상태의 자식 엔터티 수를 보여줍니다.
--partitions-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 service info

Service Fabric 애플리케이션에 속하는 특정 서비스에 대한 정보를 가져옵니다.

지정된 Service Fabric 애플리케이션에 속하는 지정된 서비스에 대한 정보를 반환합니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service list

애플리케이션 ID로 지정된 애플리케이션에 속하는 모든 서비스에 대한 정보를 가져옵니다.

애플리케이션 ID로 지정된 애플리케이션에 속하는 모든 서비스에 대한 정보를 반환합니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--continuation-token 연속 토큰 매개 변수는 다음 결과 집합을 얻는 데 사용됩니다. 빈 값이 아닌 연속 토큰은 시스템의 결과가 단일 응답에 맞지 않는 경우 API의 응답에 포함됩니다. 이 값이 다음 API 호출에 전달되면 API는 다음 결과 집합을 반환합니다. 결과가 더 이상 없으면 연속 토큰에 값이 포함되지 않습니다. 이 매개 변수의 값은 URL 인코딩이 되지 말아야 합니다.
--service-type-name 쿼리할 서비스를 필터링하는 데 사용되는 서비스 유형 이름입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service manifest

서비스 유형을 설명하는 매니페스트를 가져옵니다.

서비스 유형을 설명하는 매니페스트를 가져옵니다. 응답에 서비스 매니페스트 XML이 문자열로 포함됩니다.

인수

Argument 설명
--application-type-name [필수] 애플리케이션 유형의 이름입니다.
--application-type-version [필수] 애플리케이션 유형의 버전입니다.
--service-manifest-name [필수] Service Fabric 클러스터에서 애플리케이션 유형의 일부로 등록된 서비스 매니페스트의 이름입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service package-deploy

지정한 서비스 매니페스트와 연결된 패키지를 지정된 노드의 이미지 캐시에 다운로드합니다.

인수

Argument 설명
--app-type-name[필수] 요청된 해당 서비스 매니페스트에 대한 애플리케이션 매니페스트의 이름입니다.
--app-type-version[필수] 요청된 해당 서비스 매니페스트에 대한 애플리케이션 매니페스트의 버전입니다.
--node-name [필수] 노드의 이름입니다.
--service-manifest-name [필수] 다운로드할 패키지와 연결된 서비스 매니페스트의 이름입니다.
--share-policy 공유 정책의 JSON 인코딩된 목록입니다. 각 공유 정책 요소는 '이름' 및 '범위'로 구성됩니다. 이름은 공유할 코드, 구성 또는 데이터 패키지의 이름에 해당합니다. 범위는 'None', 'All', 'Code', 'Config' 또는 'Data'일 수 있습니다.
--timeout -t 기본값: 60.

전역 인수

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

sfctl service package-health

Service Fabric 노드 및 애플리케이션에 배포된 특정 애플리케이션의 서비스 패키지 상태에 대한 정보를 가져옵니다.

Service Fabric 노드에 배포된 특정 애플리케이션의 서비스 패키지 상태에 대한 정보를 가져옵니다. EventsHealthStateFilter를 사용하여 필요에 따라 상태 상태에 따라 배포된 서비스 패키지에 보고된 HealthEvent 개체의 컬렉션을 필터링합니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--service-package-name [필수] 서비스 패키지의 이름입니다.
--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입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service package-info

지정한 이름과 정확히 일치하는 Service Fabric 노드에 배포된 서비스 패키지 목록을 가져옵니다.

지정된 애플리케이션에 대한 Service Fabric 노드에 배포된 서비스 패키지에 대한 정보를 반환합니다. 이러한 결과는 이름이 매개 변수로 지정된 서비스 패키지 이름과 정확히 일치하는 서비스 패키지입니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--service-package-name [필수] 서비스 패키지의 이름입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service package-list

Service Fabric 노드에 배포된 서비스 패키지 목록을 가져옵니다.

지정된 애플리케이션에 대한 Service Fabric 노드에 배포된 서비스 패키지에 대한 정보를 반환합니다.

인수

Argument 설명
--application-id [필수] 애플리케이션 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 애플리케이션의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 애플리케이션 이름이 "fabric:/myapp/app1"인 경우 애플리케이션 ID는 6.0 이상에서는 "myapp~app1"이고 이전 버전에서는 "myapp/app1"입니다.
--node-name [필수] 노드의 이름입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service recover

Service Fabric 클러스터에 현재 쿼럼 손실에 갇혀 있는 지정된 서비스를 복구하려고 시도해야 했음을 나타냅니다.

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

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service report-health

Service Fabric 서비스에 대한 상태 보고서를 보냅니다.

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

인수

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

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

일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0에서 시작하며, 계층적 이름이 '~' 문자로 구분됩니다. 예를 들어 서비스 이름이 ‘fabric:/myapp/app1/svc1’이면 서비스 ID는 6.0 이상에서는 ‘myapp~app1~svc1’이고 이전 버전에서는 ‘myapp/app1/svc1’입니다.
--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 service resolve

Service Fabric 파티션을 확인합니다.

Service Fabric 서비스 파티션을 확인하여 서비스 복제본의 엔드포인트를 가져옵니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 이 ID는 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 "fabric:/myapp/app1/svc1"이면 서비스 ID는 6.0 이상에서는 "myapp~app1~svc1"이고 이전 버전에서는 "myapp/app1/svc1"입니다.
--partition-key-type 파티션의 키 형식입니다. 서비스에 대한 파티션 구성표가 Int64Range 또는 Named인 경우 이 매개 변수가 필요합니다. 가능한 값은 다음과 같습니다. - None (1) - PartitionKeyValue 매개 변수가 지정되지 않음을 나타냅니다. 분할 체계가 Singleton인 파티션에 유효합니다. 기본값입니다. 값은 1입니다. - Int64Range (2) - PartitionKeyValue 매개 변수가 int64 파티션 키임을 나타냅니다. 이는 Int64Range로 분할 체계를 사용하는 파티션에 유효합니다. 값은 2입니다. - Named(3) - PartitionKeyValue 매개 변수가 파티션의 이름임을 나타냅니다. 파티션 구성표가 Named인 파티션에 유효합니다. 값이 3입니다.
--partition-key-value 파티션 키입니다. 서비스에 대한 파티션 구성표가 Int64Range 또는 Named인 경우 필요합니다. 파티션 ID가 아니라 정수 키 값 또는 파티션 ID의 이름입니다. 예를 들어 서비스에서 0에서 10까지 범위가 지정된 파티션을 사용하는 경우 PartitionKeyValue는 해당 범위의 정수가 됩니다. 서비스 설명을 쿼리하여 범위 또는 이름을 확인합니다.
--previous-rsp-version 이전에 수신한 응답의 버전 필드 값입니다. 이는 사용자가 이전에 얻은 결과가 부실하다는 것을 알고 있는 경우에 필요합니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service type-list

Service Fabric 클러스터에서 프로비전된 애플리케이션 유형에서 지원하는 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다.

Service Fabric 클러스터에서 프로비전된 애플리케이션 유형에서 지원하는 서비스 유형에 대한 정보가 포함된 목록을 가져옵니다. 제공된 애플리케이션 유형이 있어야 합니다. 그렇지 않으면 404 상태가 반환됩니다.

인수

Argument 설명
--application-type-name [필수] 애플리케이션 유형의 이름입니다.
--application-type-version [필수] 애플리케이션 유형의 버전입니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl service update

지정된 업데이트 설명을 사용하여 지정된 서비스를 업데이트합니다.

인수

Argument 설명
--service-id [필수] 서비스의 ID입니다. 일반적으로 'fabric:' URI 스키마가 없는 서비스의 전체 이름입니다. 버전 6.0부터 계층 이름은 "~" 문자로 구분됩니다. 예를 들어 서비스 이름이 ‘fabric:/myapp/app1/svc1’이면 서비스 ID는 6.0 이상에서는 ‘myapp~app1~svc1’이고 이전 버전에서는 ‘myapp/app1/svc1’입니다.
--제약 조건 문자열로서의 배치 제약 조건입니다. 배치 제약 조건은 노드 속성에 대한 부울 식이며 서비스 요구 사항에 따라 서비스를 특정 노드로 제한할 수 있습니다. 예를 들어, NodeType이 파란색인 노드에 서비스를 배치하려면 "NodeColor == blue"를 지정합니다.
--correlated-service 상관 관계를 지정할 대상 서비스의 이름입니다.
--상관 맞춤 선호도를 사용하여 서비스를 기존 서비스와 상호 연결합니다.
--instance-count 인스턴스 수입니다. 이는 상태 비지정 서비스에만 적용됩니다.
--load-metrics 노드에서 부하를 분산할 때 사용되는 메트릭의 JSON 인코딩된 목록입니다.
--min-replica-set-size 최소 복제본 집합 크기(숫자)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--move-cost 서비스의 이동 비용을 지정합니다. 가능한 값: 'Zero', 'Low', 'Medium', 'High', 'VeryHigh'
--placement-policy-list 서비스에 대한 배치 정책 및 연결된 도메인 이름의 JSON 인코딩된 목록 입니다. 정책은 NonPartiallyPlaceService PreferPrimaryDomain, RequireDomain, RequireDomainDistribution 중 하나 이상일 수 있습니다.
--quorum-loss-wait 파티션이 쿼럼 손실 상태에 있을 수 있는 최대 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--replica-restart-wait 복제본이 다운된 시점과 새 복제본을 만든 시점 사이의 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--scaling-policies 이 서비스에 대한 크기 조정 정책의 JSON 인코딩된 목록입니다.
--service-placement-time 빌드가 중단된 것을 보고하기 전에 복제본이 InBuild를 유지할 수 있는 기간입니다. 이는 상태 저장 서비스에만 적용됩니다.
--stand-by-replica-keep StandBy 복제본이 제거되기 전 유지되는 최대 기간(초)입니다. 이는 상태 저장 서비스에만 적용됩니다.
--상태 대상 서비스가 상태 저장 서비스임을 나타냅니다.
--상태 비저장 대상 서비스가 상태 비저장 서비스임을 나타냅니다.
--target-replica-set-size 대상 복제본 집합 크기는 숫자로 설정됩니다. 이는 상태 저장 서비스에만 적용됩니다.
--timeout -t 기본값: 60.

전역 인수

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

다음 단계