영어로 읽기

다음을 통해 공유


sfctl compose

Docker Compose 애플리케이션을 만들고, 삭제하고, 관리합니다.

명령

명령 설명
create Service Fabric 작성 배포를 만듭니다.
list Service Fabric 클러스터에서 만든 작성 배포 목록을 가져옵니다.
remove 클러스터에서 기존 Service Fabric 작성 배포를 삭제합니다.
status Service Fabric 작성 배포에 대한 정보를 가져옵니다.
Upgrade(업그레이드) Service Fabric 클러스터에서 작성 배포 업그레이드를 시작합니다.
업그레이드 롤백 Service Fabric 클러스터에서 작성 배포 업그레이드 롤백을 시작합니다.
upgrade-status 이 Service Fabric 작성 배포에 수행된 최신 업그레이드에 대한 세부 정보를 가져옵니다.

sfctl compose create

Service Fabric 작성 배포를 만듭니다.

인수

Argument 설명
--deployment-name [필수] 배포의 이름입니다.
--file-path [필수] 대상 Docker Compose 파일의 경로입니다.
--encrypted-pass 컨테이너 레지스트리 암호를 묻는 메시지를 표시하는 대신 이미 암호화된 암호 구를 사용합니다.
--has-pass 컨테이너 레지스트리에 대한 암호를 묻는 메시지를 표시합니다.
--timeout -t 기본값: 60.
--user 컨테이너 레지스트리에 연결할 사용자 이름입니다.

전역 인수

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

sfctl compose list

Service Fabric 클러스터에서 만든 작성 배포 목록을 가져옵니다.

Service Fabric 클러스터에서 생성되거나 생성되는 프로세스에 있는 작성 배포에 대한 상태를 가져옵니다. 응답에는 이름, 상태 및 작성 배포에 관한 기타 세부 정보가 포함됩니다. 배포 목록이 페이지에 맞지 않으면 결과의 한 페이지와 다음 페이지를 가져오는 데 사용할 수 있는 연속 토큰이 반환됩니다.

인수

Argument 설명
--continuation-token 연속 토큰 매개 변수는 다음 결과 집합을 얻는 데 사용됩니다. 빈 값이 아닌 연속 토큰은 시스템의 결과가 단일 응답에 맞지 않는 경우 API의 응답에 포함됩니다. 이 값이 다음 API 호출에 전달되면 API는 다음 결과 집합을 반환합니다. 결과가 더 이상 없으면 연속 토큰에 값이 포함되지 않습니다. 이 매개 변수의 값은 URL 인코딩이 되지 말아야 합니다.
--max-results 페이징된 쿼리의 일부로 반환될 결과의 최대 수입니다. 이 매개 변수는 반환된 결과 수의 상한을 정의합니다. 반환된 결과는 구성에 정의된 최대 메시지 크기 제한에 따라 메시지에 맞지 않는 경우 지정된 최대 결과보다 작을 수 있습니다. 이 매개 변수가 0이거나 지정되지 않은 경우 페이징된 쿼리에는 반환 메시지에 맞는 가능한 한 많은 결과가 포함됩니다.
--timeout -t 작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 클라이언트가 요청된 작업이 완료되기를 기다리는 기간을 지정합니다. 이 매개 변수의 기본값은 60초입니다. 기본값: 60.

전역 인수

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

sfctl compose remove

클러스터에서 기존 Service Fabric 작성 배포를 삭제합니다.

기존 Service Fabric 작성 배포를 삭제합니다.

인수

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

전역 인수

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

sfctl compose status

Service Fabric 작성 배포에 대한 정보를 가져옵니다.

Service Fabric 클러스터에서 생성되거나 생성되는 프로세스에서 생성되고 이름이 매개 변수로 지정된 이름과 일치하는 작성 배포의 상태를 반환합니다. 응답에는 이름, 상태 및 배포에 대한 기타 세부 정보가 포함됩니다.

인수

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

전역 인수

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

sfctl compose upgrade

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

매개 변수가 유효한 경우 제공된 업그레이드 매개 변수의 유효성을 검사하고 배포 업그레이드를 시작합니다.

인수

Argument 설명
--deployment-name [필수] 배포의 이름입니다.
--file-path [필수] 대상 Docker 작성 파일의 경로입니다.
--default-svc-type-health-map 서비스의 상태를 평가하는 데 사용되는 상태 정책을 설명하는 JSON 인코딩된 사전입니다.
--encrypted-pass 컨테이너 레지스트리 암호를 묻는 메시지를 표시하는 대신 이미 암호화된 암호 구를 사용합니다.
--failure-action 사용할 수 있는 값: 'Invalid', 'Rollback', 'Manual'.
--force-restart 코드 버전이 변경되지 않은 경우에도 업그레이드 중에 프로세스를 강제로 다시 시작합니다.

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

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

이 시간 제한이 만료되면 가용성 손실 문제에 관계없이 업그레이드 도메인의 처리가 진행됩니다. 시간 제한은 각 업그레이드 도메인의 시작 부분에 다시 설정됩니다. 유효한 값은 0에서 42949672925 사이입니다.
--svc-type-health-map 서비스의 상태를 평가하는 데 사용된 상태 정책을 설명하는 JSON 인코딩된 개체 목록입니다.
--timeout -t 기본값: 60.
--unhealthy-app 오류를 보고하기 전에 허용되는 비정상 애플리케이션의 최대 백분율입니다.

예를 들어 애플리케이션의 10%가 비정상이 되도록 하려면 이 값은 10입니다. 백분율은 클러스터가 오류로 간주되기 전에 비정상일 수 있는 애플리케이션의 최대 허용 비율을 나타냅니다. 백분율이 존중되지만 하나 이상의 비정상 애플리케이션이 있는 경우 상태는 경고로 평가됩니다. 클러스터에 있는 애플리케이션 인스턴스의 총 수를 비정상 애플리케이션의 수로 나눠 계산합니다.
--upgrade-domain-timeout FailureAction이 실행되기 전에 각 업그레이드 도메인이 완료해야 하는 시간입니다.

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

먼저 ISO 8601 기간을 나타내는 문자열로 해석됩니다. 실패하는 경우 총 시간(밀리초)을 나타내는 숫자로 해석됩니다.
--user 컨테이너 레지스트리에 연결할 사용자 이름입니다.
--warning-as-error 경고가 오류와 동일한 심각도로 처리되는지 여부를 나타냅니다.

전역 인수

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

sfctl compose upgrade-rollback

Service Fabric 클러스터에서 작성 배포 업그레이드 롤백을 시작합니다.

서비스 패브릭 작성 배포 업그레이드를 롤백합니다.

인수

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

전역 인수

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

sfctl compose upgrade-status

이 Service Fabric 작성 배포에 수행된 최신 업그레이드에 대한 세부 정보를 가져옵니다.

애플리케이션 상태 문제 디버깅을 지원하기 위한 세부 정보와 함께 작성 배포 업그레이드의 상태에 대한 정보를 반환합니다.

인수

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

전역 인수

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

다음 단계