CQE 큐 등록 가이드

CQE(Custom Query Engine) 스크립트를 특정 서버(논리 서버)에 스케줄로 등록하는 방법을 안내합니다. 스크립트가 실행될 서버, 실행 주기, 시작 시각을 설정하고 큐에 등록합니다.

🚀 CQE 큐 등록 페이지로 이동 →

🔄 전체 흐름 (CQE Flow)

flowchart TD
    A[관리자: CQERepoPut<br/>스크립트를 repo에 등록] --> B[tMgmtScript<br/>스크립트 저장소]
    B --> C[관리자: CQEQueuePut<br/>대상 서버에 스케줄 할당]
    C --> D[tMgmtScriptList<br/>lssn별 스케줄]
    D --> E[에이전트: CQEQueueGet<br/>주기적 폴링]
    E --> F[tMgmtQue<br/>실행 큐에서 ms_body 수신]
    F --> G[에이전트: 로컬에서<br/>스크립트 실행]
    G --> H[KVSPut<br/>결과 보고]
    style A fill:#e1f5fe
    style B fill:#b3e5fc
    style C fill:#e1f5fe
    style D fill:#b3e5fc
    style E fill:#e8f5e9
    style F fill:#c8e6c9
    style G fill:#fff9c4
    style H fill:#ffccbc

📋 개요

CQE 큐 등록은 등록된 스크립트를 하나 이상의 논리 서버(LSSN)에 스케줄로 할당하는 화면입니다. 대상 서버, 실행 주기, 시작 시각을 설정한 뒤 큐에 등록하면 각 서버의 에이전트가 주기적으로 큐를 폴링하여 스크립트를 수신·실행합니다.

스크립트 등록과 실행 설정은 CQE 레포지토리 목록(/ko/cqeRepoList)에서 수행합니다. 이 페이지에서는 이미 등록된 스크립트를 선택하여 서버에 할당합니다.

🔍 화면 구성

1. 스크립트 선택 (mssn)

등록된 스크립트 목록에서 실행할 스크립트를 선택합니다. 목록은 CQE 레포지토리에 등록된 스크립트만 표시됩니다.

2. 대상 서버 (lssngroup)

스크립트를 할당할 논리 서버(LSSN)를 콤마 구분으로 입력합니다. 예: 70371,70372,70373 서버 선택 버튼을 클릭하면 현재 프로젝트(csn)에 등록된 서버 목록이 팝업으로 표시됩니다.

3. 실행 설정

• 활성 (Active): 등록 후 즉시 스케줄을 활성화할지 여부를 결정합니다. 꺼두면 등록만 되고 실행은 되지 않습니다.
• 반복 (Repeat): 0 또는 1 = 일회성, 2 = 재귀(간격마다 반복).
• 실행 간격 (분): 반복 실행 시의 주기를 분 단위로 설정합니다.
• 시작 일시: 첫 실행이 시작될 UTC 시각을 입력합니다.

4. 스크립트 유형 (script_type)

실행 유형을 선택합니다: ps1(PowerShell), cmd, wsf, cmdui, ps1ui. 자세한 차이는 CQE 레포지토리 스크립트 관리 가이드의 "🔌 CQE API" 절을 참조하세요.

5. 커스텀 변수 (custom_values)

선택적 필드입니다. 서버별 주입값을 입력하면 스크립트 본문의 {{CustomVariables}}가 해당 값으로 치환됩니다.

6. 큐 등록

모든 설정을 마친 뒤 이 버튼을 클릭하면 선택된 서버에 스크립트가 스케줄로 등록됩니다.

⚙️ 요구사항

• **로그인 세션(CSN)**이 필요합니다.
• 등록할 스크립트가 CQE 레포지토리에 이미 등록되어 있어야 합니다.
• 대상 LSSN이 현재 프로젝트에 등록되어 있어야 합니다.

💡 유의 사항

• 시작 일시는 UTC 기준으로 입력합니다. 로컬 시각을 그대로 넣으면 에이전트가 미래 시각으로 인식해 스크립트가 영구히 실행되지 않을 수 있습니다.
• 스크립트의 {{sk}}, {{lssn}} 치환자는 에이전트가 런타임에 자동 주입합니다.
• 일회성(repeat=1) 스케줄의 active는 강제 실행 시 0으로 내려갑니다. 이후 재귀 실행을 원하면 수동으로 다시 활성화해야 합니다.

🔌 CQE API (자동화용)

위 UI 동작은 다음 CQE API 버브에 대응합니다.

• CQEQueuePut mssn lssngroup csn interval active script_type custom_values repeat startdate auid
  • mssn: 스크립트 고유 ID
  • lssngroup: 콤마 구분 LSSN 목록
  • interval: 실행 간격(분)
  • repeat: 0/1=일회성, 2=재귀
  • startdate: 시작 일시(UTC)
  • custom_values: {{CustomVariables}} 주입값
• CQERepoPut — 스크립트 repo 등록
• CQEQueueGet — 에이전트의 큐 폴링

전체 사양: CQE 레포지토리 스크립트 관리 가이드, giipdb docs/30_Specs/CQE_SPECIFICATION.md.

---

버전: 1.0 최종 업데이트: 2026-09-19 소스 파일: giipv3/public/help/cqeQueuePut.ko.md