CTS start 명령 참조

CTS start 명령 참조 (Consul-Terraform-Sync start)

start 명령은 Consul-Terraform-Sync (CTS) 데몬을 시작해요. 이 문서에서 명령 사용법, 사용 가능한 플래그, 그리고 various 모드(장기 실행, once, inspect, 고가용성)를 설명할게요.

출처: 문서

본문

start 명령은 Consul-Terraform-Sync (CTS) 데몬을 시작합니다.

사용법 (Usage)

$ consul-terraform-sync start -config-file <instance-configuration-file> [OPTIONS]

-config-file 또는 -config-dir 플래그는 필수입니다. 이 플래그로 CTS 클러스터를 시작할 CTS 인스턴스 구성 파일 또는 여러 구성 파일이 포함된 디렉터리를 지정합니다.

옵션 (Options)

다음 표는 사용 가능한 모든 플래그를 설명합니다.

| 이름 (Name) | 필수 (Required) | 타입 (Type) | 설명 (Description) | 기본값 (Default) | | -config-dir | -config-file이 설정되지 않은 경우 필수 | string | 시작 시 로드할 CTS 인스턴스 구성 파일이 포함된 디렉터리를 지정합니다. 파일은 HCL 또는 JSON 형식이어야 합니다. 여러 파일 디렉터리를 로드하기 위해 플래그를 여러 번 지정할 수 있습니다. | none | | -config-file | -config-dir이 설정되지 않은 경우 필수 | string | 시작 시 로드할 CTS 인스턴스 구성 파일을 지정합니다. 파일은 HCL 또는 JSON 형식이어야 합니다. 여러 파일을 로드하기 위해 플래그를 여러 번 지정할 수 있습니다. | none | | -inspect | 선택 | boolean | 검사(inspect) 모드로 CTS를 시작합니다. 검사 모드에서 CTS는 모든 태스크에 대해 제안된 상태 변경을 한 번 표시하고 종료합니다. 변경 사항은 적용되지 않습니다. 추가 정보는 Modes를 참조하세요. 모든 변경을 표시하기 전에 오류가 발생하면 CTS는 0이 아닌 상태로 종료합니다. | false | | -inspect-task | 선택 | string | 지정된 태스크에 대해 검사 모드로 CTS를 시작합니다. CTS는 지정된 태스크에 대해 제안된 상태 변경을 표시하고 종료합니다. 변경 사항은 적용되지 않습니다. 둘 이상의 태스크를 표시하기 위해 플래그를 여러 번 지정할 수 있습니다. 모든 변경을 표시하기 전에 오류가 발생하면 CTS는 0이 아닌 상태로 종료합니다. | none | | -once | 선택 | boolean | once 모드로 CTS를 시작합니다. once 모드에서 CTS는 템플릿을 렌더링하고 태스크를 한 번 실행하며 버퍼 기간을 비활성화합니다. 추가 정보는 Modes를 참조하세요. | false | | -reset-storage | 선택 | boolean | Enterprise, 시작하는 인스턴스가 클러스터 리더로 선출될 때 CTS가 상태 저장소를 새 상태 정보로 덮어쓰도록 지시합니다. 고가용성 모드로 CTS를 실행할 때만 이 플래그를 사용하세요. | false | | -h, -help | 선택 | boolean | CTS 명령줄 도움말을 출력합니다. | false |

모드 (Modes)

기본적으로 CTS는 장기 실행(long-running) 모드로 시작합니다. 다음 표는 사용 가능한 모든 CTS 모드를 설명합니다.

| 이름 (Name) | 설명 (Description) | 시작 방법 (How to start) | | 장기 실행 모드 (Long-running mode) | CTS는 once 모드로 시작한 다음 장기 실행 프로세스로 전환합니다. once 모드 단계 동안 데몬은 오류를 만나면 0이 아닌 상태로 종료합니다. once 모드에서 성공적으로 운영된 후 CTS는 장기 실행 프로세스를 시작합니다. 장기 실행 프로세스가 시작되면 CTS 데몬은 API와 명령 요청을 처리합니다. 오류가 발생하면 CTS는 로그를 기록하고 계속 실행됩니다. | 추가 플래그 없음. 기본 모드입니다. | | once 모드 (Once-mode) | once 모드에서 CTS는 템플릿을 렌더링하고 태스크를 한 번 실행합니다. CTS는 장기 실행 모드로 프로세스를 시작하지 않으며 버퍼 기간을 비활성화합니다. 장기 실행 모드로 CTS를 시작하기 전에 once 모드를 사용해 구성이 정확하고 태스크가 기대한 대로 네트워크 인프라를 업데이트하는지 확인하세요. | CTS를 시작할 때 -once 플래그를 추가합니다. | | 검사 모드 (Inspect mode) | CTS는 모든 태스크에 대해 제안된 상태 변경을 한 번 표시하고 종료합니다. 변경 사항은 적용되지 않습니다. 모든 변경을 표시하기 전에 오류가 발생하면 CTS는 0이 아닌 상태로 종료합니다. 장기 실행 모드로 CTS를 시작하기 전에 검사 모드를 사용해 하나 이상의 태스크를 디버깅하고 태스크가 기대한 대로 네트워크 인프라를 업데이트할 것인지 확인하세요. | 모든 태스크를 검증하려면 -inspect 플래그를 추가합니다. 단일 태스크를 검사하려면 -inspect-task 플래그를 추가합니다. 둘 이상의 태스크를 검증하려면 여러 플래그를 사용합니다. | | 고가용성 모드 (High availability mode) | 장애 조치 전환 중 Consul에 발생하는 모든 변경이 처리되고 CTS가 기대한 대로 계속 운영되도록 보장하는 장기 실행 프로세스입니다. CTS는 오류를 로그하고 중단 없이 계속 운영합니다. 추가 정보는 Consul-Terraform-Sync 고가용성 실행을 참조하세요. | CTS 인스턴스 구성에 high_availability 블록을 추가합니다. 추가 정보는 Consul-Terraform-Sync 고가용성 실행을 참조하세요. |

더 알아보기 (Learn more)