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를 사용합니다. |
다음 단계
- Service Fabric CLI를 설정합니다 .
- 샘플 스크립트를 사용하여 Microsoft Azure Service Fabric CLI를 사용하는 방법에 대해 알아봅니다.