一键在 Manus 中运行任何 Skill

debug-precheck-failure

星标2

分支1

更新时间2026年4月29日 00:06

4단계 진단 (ping → port → protocol → auth) 어디서 막혔는지 분석. precheck_bundle.py 결과의 diagnosis.details를 해석하고 구체적 해결 방향 제시. 사용자가 "ping은 됐는데 protocol 실패", "auth 단계에서 막힘", "precheck 실패 원인" 등 요청 시. - precheck 실패 발생 / graceful degradation 했지만 일부 데이터 누락 / 새 BMC 응답 없음

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

hshwang1994

hshwang1994/server-exporter

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

debug-precheck-failure

목적

server-exporter의 4단계 진단(common/library/precheck_bundle.py) 어느 단계에서 실패했는지 분석 + 구체적 디버깅 절차 안내.

4단계 (rule 27 R2)

단계	책임	일반적 실패 원인
1. ping	ICMP / TCP SYN으로 host 도달성	네트워크 / firewall / VLAN
2. port	target_type별 포트 (SSH 22 / WinRM 5985-5986 / vSphere 443 / Redfish 443)	서비스 미기동 / firewall
3. protocol	TCP 응답 + 첫 응답 형식 (HTTPS handshake / SSH banner / Redfish JSON)	TLS 버전 / cipher suite / 잘못된 protocol
4. auth	자격증명으로 인증	vault 자격증명 잘못 / 사용자 잠김 / privilege 부족

입력

target_ip
target_type (os / esxi / redfish)
precheck 결과 JSON (envelope의 diagnosis.precheck)

출력

## Precheck 실패 분석 — 10.x.x.1 (target_type=redfish)

### 결과
- ping: ok
- port: ok (443 응답)
- protocol: **fail** ("HTTPS handshake failed: TLS version mismatch")
- auth: skipped

### 진단
3단계 protocol 실패 — TLS 버전 불일치.
구 BMC 펌웨어가 TLS 1.0/1.1만 지원하는데 Python 3.12 default ssl context는 TLS 1.2+.

### 해결 방향
1. 펌웨어 업그레이드 권고 (BMC 운영자 확인)
2. 또는 redfish_gather.py에 TLS 버전 fallback 추가:
   ```python
   ctx = ssl.create_default_context()
   ctx.minimum_version = ssl.TLSVersion.TLSv1

→ 코드에 의도 명시 주석 (cycle-011: rule 60 보안 정책 해제) + ai-context/external/integration.md 갱신

다음 단계

펌웨어 정보 확인 (Manufacturer / Model Wikipedia spec 비교)
docs/ai/catalogs/EXTERNAL_CONTRACTS.md에 drift 추가 (rule 96 R4)


## 절차

### Step 1: ping 실패

```bash
ping -c 3 <target_ip>
# 또는 (방화벽으로 ICMP 차단 시)
nc -zv <target_ip> <port>

원인:

네트워크 / VLAN 분리 → Agent 노드 라우팅 확인
ICMP 차단 → TCP SYN으로 대체

Step 2: port 실패

nc -zv <target_ip> 443       # Redfish / vSphere
nc -zv <target_ip> 22        # SSH (Linux)
nc -zv <target_ip> 5986      # WinRM HTTPS

원인:

서비스 미기동 (BMC 재시작 필요)
방화벽 (Agent IP 허용 규칙 확인)

Step 3: protocol 실패

# Redfish HTTPS handshake
curl -kv https://<ip>/redfish/v1/ 2>&1 | head -30

# SSH banner
ssh -o ConnectTimeout=10 -v root@<ip> 2>&1 | head -20

원인:

TLS 버전 (구 BMC = TLS 1.0/1.1)
Cipher suite 불일치
잘못된 protocol (예: target_type=esxi인데 실제는 Linux host)

Step 4: auth 실패

# Redfish Basic Auth
curl -k -u "user:pass" https://<ip>/redfish/v1/Systems

# SSH
ssh -i <key> root@<ip>

# WinRM
python -c "import winrm; s = winrm.Session('<ip>', auth=('<user>','<pass>'), transport='ntlm'); print(s.run_cmd('hostname'))"

원인:

vault 자격증명 stale (rotate-vault skill로 갱신)
사용자 잠김 (BMC 로그인 시도 횟수 초과)
privilege 부족 (read-only 사용자가 일부 endpoint 403)

server-exporter 도메인 적용

영향 채널: 모든 채널 (precheck 공통)
영향 vendor: 진단 대상

적용 rule / 관련

rule 27 (precheck-guard-first) — 4단계 정본
(cycle-011: rule 60 해제 — 자격증명 / TLS 정책은 운영 권장 수준)
rule 96 (external-contract-integrity) — protocol drift 발견 시
skill: classify-precheck-layer, debug-external-integrated-feature, rotate-vault
agent: precheck-engineer
정본: docs/11_precheck-module.md, common/library/precheck_bundle.py
reference: docs/ai/references/redfish/redfish-spec.md, docs/ai/references/winrm/pywinrm.md

同仓库更多 Skills

同仓库

update-output-schema-evidence

hshwang1994/server-exporter

schema/sections.yml + schema/field_dictionary.yml + schema/baseline_v1/ 3종 정합 갱신 (rule 13 R1). schema 변경 후 호출. 사용자가 "schema 정합 갱신", "field dictionary 동기화", "ERD 갱신" (server-exporter 어휘로는 schema doc) 등 요청 시 또는 schema 5개 이상 누적 변경 시 자동. - schema/sections.yml or field_dictionary.yml 수정 후 / 새 섹션 / 새 필드 / Round 검증 후 baseline 변경

2026-07-022

write-spec

hshwang1994/server-exporter

구조화된 server-exporter 기능 명세서 작성. 사용자가 "명세서 써줘", "스펙 정리" 등 요청 시. - 구조화된 spec 필요 / PR 본문 / 문서화

2026-06-142

add-new-vendor

hshwang1994/server-exporter

server-exporter에 새 벤더(예: Huawei iBMC, Inspur, Ampere)를 3단계로 추가하는 절차 안내. vendor_aliases.yml + adapters/{channel}/{vendor}_*.yml + (선택) OEM tasks + vault + baseline + ai-context + docs 동시 갱신. 사용자가 "Huawei vendor 추가", "새 벤더 추가", "Huawei 지원하자" 등 요청 시 자동 호출. - 새 vendor가 호출자 시스템에서 요청됨 / 펌웨어 프로파일링 후 정식 지원 / 기존 generic fallback 한계 시

2026-05-112

capture-site-fixture

hshwang1994/server-exporter

사용자 사이트 사고 환경 (HPE Gen12 / Lenovo XCC3 / Dell iDRAC8 / Cisco CIMC 등) 의 fixture를 캡처해 회귀 회피. cycle 2026-05-01 학습 — 사이트 사고 fixture 부재로 다음 reverse regression 위험. 사이트 envelope / probe 결과 / 펌웨어 응답을 tests/fixtures/redfish/{vendor}_{firmware}/ 에 저장 + tests/evidence/<날짜>-<vendor>.md 작성. 사용자가 "사이트 fixture 캡처", "사고 재현 입력 저장" 요청 시.

2026-05-072

add-vendor-no-lab

hshwang1994/server-exporter

lab 부재 vendor 추가 (web sources 의무). cycle 2026-05-06 학습 — 4 신규 vendor (Huawei/Inspur/Fujitsu/Quanta) + Superdome Flex 의 lab 부재 web sources 패턴 라이브러리화. 사용자가 "Huawei iBMC 추가", "lab 없는 vendor 어떻게?", "vendor 추가" 등 요청 시 + lab 부재 명시 시. - rule 50 R2 9단계 + rule 96 R1-A web sources 의무 + vault SKIP 사용자 명시 승인

2026-05-062

cycle-orchestrator

hshwang1994/server-exporter

다중 worker cycle 자동화 (Phase 0 ticket 작성 → Phase 1 분석 → Phase 2 결정 → Phase 3 구현 → Phase 4 회귀 → Phase 5 종료). cycle 2026-05-06 학습 — 24 ticket × 5 worker 패턴 라이브러리화. 사용자가 "cycle 시작", "사용자 N 작업 묶음 ticket 으로 분해해줘", "cycle 자동화" 등 요청 시. - 3 항목 이상 작업 묶음 / 다중 worker 동시 진행 / 호환성 / 큰 리팩토링

2026-05-062

name

debug-precheck-failure

description

debug-precheck-failure

목적

server-exporter의 4단계 진단(common/library/precheck_bundle.py) 어느 단계에서 실패했는지 분석 + 구체적 디버깅 절차 안내.

4단계 (rule 27 R2)

단계	책임	일반적 실패 원인
1. ping	ICMP / TCP SYN으로 host 도달성	네트워크 / firewall / VLAN
2. port	target_type별 포트 (SSH 22 / WinRM 5985-5986 / vSphere 443 / Redfish 443)	서비스 미기동 / firewall
3. protocol	TCP 응답 + 첫 응답 형식 (HTTPS handshake / SSH banner / Redfish JSON)	TLS 버전 / cipher suite / 잘못된 protocol
4. auth	자격증명으로 인증	vault 자격증명 잘못 / 사용자 잠김 / privilege 부족

입력

target_ip
target_type (os / esxi / redfish)
precheck 결과 JSON (envelope의 diagnosis.precheck)

출력

## Precheck 실패 분석 — 10.x.x.1 (target_type=redfish)

### 결과
- ping: ok
- port: ok (443 응답)
- protocol: **fail** ("HTTPS handshake failed: TLS version mismatch")
- auth: skipped

### 진단
3단계 protocol 실패 — TLS 버전 불일치.
구 BMC 펌웨어가 TLS 1.0/1.1만 지원하는데 Python 3.12 default ssl context는 TLS 1.2+.

### 해결 방향
1. 펌웨어 업그레이드 권고 (BMC 운영자 확인)
2. 또는 redfish_gather.py에 TLS 버전 fallback 추가:
   ```python
   ctx = ssl.create_default_context()
   ctx.minimum_version = ssl.TLSVersion.TLSv1

→ 코드에 의도 명시 주석 (cycle-011: rule 60 보안 정책 해제) + ai-context/external/integration.md 갱신

다음 단계

펌웨어 정보 확인 (Manufacturer / Model Wikipedia spec 비교)
docs/ai/catalogs/EXTERNAL_CONTRACTS.md에 drift 추가 (rule 96 R4)


## 절차

### Step 1: ping 실패

```bash
ping -c 3 <target_ip>
# 또는 (방화벽으로 ICMP 차단 시)
nc -zv <target_ip> <port>

원인:

네트워크 / VLAN 분리 → Agent 노드 라우팅 확인
ICMP 차단 → TCP SYN으로 대체

Step 2: port 실패

nc -zv <target_ip> 443       # Redfish / vSphere
nc -zv <target_ip> 22        # SSH (Linux)
nc -zv <target_ip> 5986      # WinRM HTTPS

원인:

서비스 미기동 (BMC 재시작 필요)
방화벽 (Agent IP 허용 규칙 확인)

Step 3: protocol 실패

# Redfish HTTPS handshake
curl -kv https://<ip>/redfish/v1/ 2>&1 | head -30

# SSH banner
ssh -o ConnectTimeout=10 -v root@<ip> 2>&1 | head -20

원인:

TLS 버전 (구 BMC = TLS 1.0/1.1)
Cipher suite 불일치
잘못된 protocol (예: target_type=esxi인데 실제는 Linux host)

Step 4: auth 실패

# Redfish Basic Auth
curl -k -u "user:pass" https://<ip>/redfish/v1/Systems

# SSH
ssh -i <key> root@<ip>

# WinRM
python -c "import winrm; s = winrm.Session('<ip>', auth=('<user>','<pass>'), transport='ntlm'); print(s.run_cmd('hostname'))"

원인:

vault 자격증명 stale (rotate-vault skill로 갱신)
사용자 잠김 (BMC 로그인 시도 횟수 초과)
privilege 부족 (read-only 사용자가 일부 endpoint 403)

server-exporter 도메인 적용

영향 채널: 모든 채널 (precheck 공통)
영향 vendor: 진단 대상

적용 rule / 관련

rule 27 (precheck-guard-first) — 4단계 정본
(cycle-011: rule 60 해제 — 자격증명 / TLS 정책은 운영 권장 수준)
rule 96 (external-contract-integrity) — protocol drift 발견 시
skill: classify-precheck-layer, debug-external-integrated-feature, rotate-vault
agent: precheck-engineer
정본: docs/11_precheck-module.md, common/library/precheck_bundle.py
reference: docs/ai/references/redfish/redfish-spec.md, docs/ai/references/winrm/pywinrm.md