조직이 관리하는 설치를 Online 또는 Offline 사용에 맞춰 준비합니다.
OS·네트워크 준비 기록을 완성하고 제공 제품·도구 체인 준비가 충족되면 새 SDK 후보 하나를 확인합니다. 공개 매뉴얼은 어플라이언스 설치 프로그램·활성화 서비스·모든 Rust 의존성 아카이브가 아닙니다.
실제 환경에 맞게 Online 또는 Offline을 선택합니다. Online은 승인된 네트워크 접근을 사용합니다. Offline은 폐쇄 온프렘용 선택 사항으로 반입 전에 호환 제품·컴파일러·네이티브 도구 체인·선언된 의존성을 준비해야 합니다. 문서 다운로드에는 이 패키지가 없습니다.
빈 워크시트를 내려받아 guide-practice-01 같은 새 폴더에 비공개 작업 사본으로 저장합니다. JSON은 UTF-8 텍스트 편집기로 열고 따옴표와 미관찰 필드의 null을 유지하며 .json.txt가 아닌 .json으로 저장합니다. 워크시트는 기록 문서이며 제품 요청이 아닙니다. SDK나 Helper에 제출하지 마십시오.
수행할 작업: on-premises-preflight.blank.json을 비공개로 저장합니다. 정확한 OS 버전·CPU 및 SDK 타깃·제품 버전·Online 또는 Offline 선택을 기록합니다. 작성 예시는 미검증 패키지·도구 체인 필드를 의도적으로 null로 두며 설치 완료 예시가 아님을 읽습니다.
결과 확인: 타깃 하나가 선택됩니다. MACOS_ARM64·DEBIAN_13_AMD64·WINDOWS_AMD64는 서로 다른 문서화된 SDK 타깃이며 호환 대체 패키지명이 아닙니다.
일치하지 않을 때: 목록에 없는 OS·아키텍처에는 해당 지원 패키지·절차가 필요합니다. 타깃 문자열을 바꿔도 바이너리·의존성 세트가 변환되지 않습니다.
수행할 작업: Online은 승인 대상·프록시·CA 요건을 기록합니다. Offline은 정확한 제품·의존성 및 도구 체인 세트·매니페스트·매뉴얼을 승인 경로로 반입합니다. 각 전달 아카이브의 SHA-256을 별도 제공 매니페스트와 비교하며 OS별 지문 명령은 아래 보존 절에 있습니다.
결과 확인: 패키지명·지문·출처 참조·타깃이 일치합니다. 일치 지문은 해당 매니페스트에 대한 무결성 증거이며 독립적인 보안 인증은 아닙니다.
일치하지 않을 때: 매니페스트 누락·불일치이면 해당 후보 설치를 중단합니다. 두 파일을 보존하고 올바른 승인 패키지를 확보하며 기존 정상 패키지를 덮어쓰지 않습니다.
수행할 작업: 해당 OS와 제공 전달물의 Part.1을 따릅니다. 실제 SDK 실행 파일·dependencies 디렉터리를 기록하고 rustc --version·cargo --version과 OS별 네이티브 준비 목록을 확인합니다. 폐쇄 환경에서는 미승인 네트워크 경로로 도구를 설치하지 않습니다.
결과 확인: 실행 파일이 존재하고 도구 버전이 기록되며 설치 패키지가 선택 OS·아키텍처와 맞습니다. SDK 디렉터리만으로 네이티브 링커 설치를 입증하지 않습니다.
일치하지 않을 때: 컴파일러·링커 누락·아키텍처 불일치·지원 최초 관리자 경로 부재는 명시적 준비 실패로 남깁니다. 의존 작업 전에 제공 절차로 해결합니다.
수행할 작업: 아래 예제 중 실제 타깃의 명령만 사용합니다. 설치 경로를 실제 제공 경로로 바꾸고 verify-offline-dependencies를 실행합니다. 종료 코드·반환 확인 결과를 기록합니다. 이 명령은 선언된 세트를 검증하며 임의 추가 crate 가용성을 입증하지 않습니다.
결과 확인: 정확한 타깃·패키지의 문서화된 검증이 성공합니다. 결과를 매니페스트·도구 버전과 함께 보존합니다.
일치하지 않을 때: 검증 실패 시 오류를 보존하고 의존 실습을 중단합니다. Offline을 임의로 Online으로 바꾸거나 타깃 표시를 변경하거나 실패 후검사를 숨기지 않습니다.
수행할 작업: 정확한 입력·새 폴더 구성은 Custom Execution 첫 사용 경로를 엽니다. Part.5에 따라 Online은 run, Offline은 run-offline을 선택합니다. macOS CLT 선택이 해당되면 일치하는 Offline 실행에 문서의 --macos-developer-selection COMMAND_LINE_TOOLS 옵션을 유지합니다.
결과 확인: 새 출력 디렉터리에 후보 산출물·매니페스트 검사가 있습니다. 단절 타깃에서 실제로 추가 다운로드 없이 실습이 완료되었는지를 기록합니다.
일치하지 않을 때: 의존성 디렉터리 복사·crate 해제 성공은 빌드 완료가 아닙니다. 실패 후보를 보존하고 정확한 누락 도구·의존성·검증 오류만 확인합니다.
수행할 작업: README.md·manifest.json을 읽고 adapter.rs를 확인하며 Part.5 OS 명령으로 소스·libadapter.rlib 지문을 각각 계산합니다. 입력 지문·SDK 및 컴파일러·의존성 식별·단계 결과·검토자 결정을 준비 및 관찰 기록에 보존합니다.
결과 확인: 기록에서 검증된 로컬 SDK 후보와 설치 전체 준비·등록 연동·승인 Pack·고객 실행을 구분합니다.
일치하지 않을 때: 누락 계정·활성화·최초 관리자 요건과 다음 담당자를 명시합니다. 후보를 승인으로 바꾸기 위해 매니페스트 상태·권한 필드를 수정하지 않습니다.
일치하는 ARM64 패키지에서만 사용합니다. Part.1 기본 위치이므로 실제 설치 위치로 바꾸십시오. Intel macOS용 명령이 아닙니다.
SDK_EXE="$HOME/VibePackr-SDK-install-01/sdk/bin/packr-sdk-engine"
SDK_DEPS="$HOME/VibePackr-SDK-install-01/dependencies"
"$SDK_EXE" verify-offline-dependencies MACOS_ARM64 "$SDK_DEPS"
# Record the exit code immediately: echo $?문서화된 Debian 타깃과 설치된 네이티브 도구를 사용합니다. 타깃 인수만 바꿔 다른 배포판으로 대체하지 않습니다.
SDK_EXE="$HOME/VibePackr-SDK-install-01/sdk/bin/packr-sdk-engine"
SDK_DEPS="$HOME/VibePackr-SDK-install-01/dependencies"
"$SDK_EXE" verify-offline-dependencies DEBIAN_13_AMD64 "$SDK_DEPS"
# Record the exit code immediately: echo $?반환 코드와 전체 결과를 기록합니다. 성공 검증의 범위는 제공된 이 타깃·의존성 세트입니다.
$SdkInstall = Join-Path $env:USERPROFILE 'VibePackr-SDK-install-01'
$SdkExe = Join-Path $SdkInstall 'sdk\bin\packr-sdk-engine.exe'
$SdkDeps = Join-Path $SdkInstall 'dependencies'
& $SdkExe verify-offline-dependencies WINDOWS_AMD64 $SdkDeps
$VerifyExit = $LASTEXITCODE
if ($VerifyExit -ne 0) { throw 'Preserve dependency verification error; stop here' }보존 사례는 명시된 릴리스·환경의 이미 공개된 관찰을 인용합니다. 절차 예시는 대응 방법 설명이며 추가로 관찰한 사고가 아닙니다. 이 가이드 작성을 위해 제품을 실행하지 않았습니다.
보존된 실제 관찰 사례
증상: 보존 SDK 사례에서 컴파일러 종료 0 뒤 candidate private path disclosure libadapter.rlib이 보고되었습니다.
증거의 의미: 컴파일과 전체 패키지 검증은 다른 게이트입니다. 관찰된 실패가 해당 라이브러리 배포를 허용하지는 않습니다.
완료 또는 재개 확인: 명령·필수 후검사가 모두 통과할 때만 완료로 기록하며 통과를 만들기 위해 증거를 수동으로 숨기거나 제거하지 않습니다.
보존된 실제 관찰 사례
증상: 보존 SDK 사례는 같은 adapter.rs와 다른 libadapter.rlib 지문을 비교했습니다.
증거의 의미: 소스 일치만으로 전체 컴파일 입력·SDK 및 컴파일러·타깃·의존성 버전 일치를 입증하지 않습니다. 전체 매니페스트에도 서로 다른 실행 기록이 있을 수 있습니다.
완료 또는 재개 확인: 해당 OS·버전·입력에서 실제 관찰한 재현성만 기록하며 서로 다른 OS 라이브러리에 동일 바이트가 필수라고 가정하지 않습니다.
대응 절차 예시 · 새 관찰 사고 아님
증상: 설명용 예: 폐쇄 환경에서 도구가 누락 crate·버전을 보고하거나 레지스트리를 조회하려 합니다.
증거의 의미: 제공 의존성 세트에는 선언 범위가 있습니다. crate 추가·lockfile 및 타깃 변경은 범위를 넘을 수 있으며 모든 의존성이 포함되었다는 증거가 아닙니다.
완료 또는 재개 확인: 해당 실습에 추가 다운로드가 없었다는 주장은 실제 단절 타깃에서 선택 실습을 완료해야 가능합니다.
대응 절차 예시 · 새 관찰 사고 아님
증상: 설명용 예: rustc·네이티브 링커를 찾지 못하거나 설치 실행 파일의 CPU 아키텍처가 다릅니다.
증거의 의미: SDK 바이너리·crate 아카이브는 모든 OS 도구를 설치하지 않습니다. Windows·Debian·macOS의 네이티브 준비 요건은 다릅니다.
완료 또는 재개 확인: 필수 도구가 존재하고 문서의 타깃·의존성 검증이 성공한 뒤에만 진행합니다.
대응 절차 예시 · 새 관찰 사고 아님
증상: 설명용 예: 패키지 지문이 맞고 VM에 도달하지만 지원 관리자 발급·앱 활성화 절차가 없습니다.
증거의 의미: 아카이브 무결성·호스트 도달은 제품 운영 권한을 입증하지 않습니다. 참고 최초 관리자 공백은 버전별 문제이며 이 가이드로 종결되지 않습니다.
완료 또는 재개 확인: 필요한 지원 설정·실제 허용 접근은 파일 무결성과 별도로 관찰해야 합니다.
패키지 및 매니페스트 식별·도구 버전·네트워크 모드·의존성 검증·입출력 지문·미충족 요건을 보존합니다. 로컬 합성 후보는 어플라이언스를 활성화·구성하지 않으며 전체 네트워크·모든 Rust 의존성을 인증하지 않습니다.
가이드에서 목적을 고른 뒤 해당 Part에서 정확한 도구 단계를 확인합니다. 두 문서는 같은 순서·용어·자료 역할을 사용합니다.
질문을 정하고 범위에 맞는 관찰을 모아 결과를 검토합니다. 보존 기록 독해에는 신규 설치가 필요하지 않습니다.
정확한 심사 전달물과 기준 증거를 연결합니다. Cloud 접근·문서 범위·실제 Google 승인은 각각 구분합니다.
정확한 OS·패키지·네트워크 선택·도구 체인을 준비합니다. 로컬 SDK 준비 요건이 제공된 뒤에만 해당 단축 경로를 사용합니다.
지원 작업을 선택합니다. 소스 문서 준비·전체 SDK 후보·실제 Work 및 보고서 확인을 서로 다른 경로로 구분합니다.
Helper B는 구현·새 Pack 필요 여부를 결정하기 전에 완성된 선언을 확인합니다. 구현·선언 변경 후에는 영향을 받은 지원 검사를 다시 수행하고 별도 구현·등록·Pack 승인 경로를 마친 뒤 사용합니다. 생성 후보는 운영 권한을 부여하지 않습니다.
목표에 필요한 경로만 선택합니다. 보존 PoC 독해는 설치 없이 시작할 수 있습니다. 제공된 로컬 SDK 실습은 Part.1 → Part.5를 따르며 새 GAPE 관찰·어플라이언스 계정이 필요하지 않습니다. 기존 승인 Pack은 현재 준비 요건 확인 후 Part.1 → Part.7 → Part.8을 따를 수 있습니다. 새 연동·Pack 작성은 조건부 전체 순서를 따릅니다.
| 구성 요소 | 역할과 기대 범위 |
|---|---|
| Part.1 · 설치·초기 연결 | OS 준비·제공 패키지·초기 연결입니다. 설치는 실행된 Work가 아닙니다. |
| Part.2 · GAPE 관찰·비교·공유 | 리비전에 고정된 구조 관찰입니다. 워크시트는 승인된 GAPE 입력 매니페스트가 아닙니다. |
| Part.3 · Integration Helper 사용 | A는 Document 작성 전 계획, B는 완성된 전체 요청 확인입니다. 단계마다 타입이 있는 status·reason을 읽습니다. |
| Part.4 · Contract·Document 작성 | 소스 Document·매핑을 작성하고 제공된 대상 Contract·리비전을 사용합니다. JSON 구문만으로 의미상 호환성이 확인되지 않습니다. |
| Part.5 · SDK Engine 실습·연동 후보 | 로컬 SDK 구현 후보를 생성합니다. 기존 구현·등록·릴리스 호환 연동이 요구를 충족하면 재사용합니다. |
| Part.6 · Builder·추가 Pack 사용 | 새 Pack이 필요할 때 Pack 후보를 준비합니다. 목표·설치 범위에 맞는 기존 승인 Pack은 재사용합니다. |
| Part.7 · PackrGUI·헤드리스 사용 | 현재 권한·사전 조건에 따라 제공 GUI·헤드리스 경로를 사용합니다. 반환된 Work 식별·결과를 확인합니다. |
| Part.8 · 운영·문제 해결·지원 | 동일 Work 산출물·영수증·종결을 비교하며 사람 인수은 실제 기록될 때까지 대기로 유지합니다. |
status.read 소스 전용 예제와 read_quality SDK 실습은 서로 다른 예제입니다. 일치하는 전체 요청을 사용하고 status 소스 파일을 quality SDK 전체 요청으로 제출하지 않습니다. 아래 매핑 값은 설명을 위한 기대값이며 새 실행 캡처가 아닙니다.
| 파일 / 역할 | 입력 | 출력 / 확인 |
|---|---|---|
status-document.jsonstatus.read의 소스 전용 CUSTOM_API 선언입니다. 제공된 전체 준비 요청 안에서 사용합니다. | service: string(문자열) | service: string·healthy: boolean을 선언합니다. 스키마이며 관찰된 서비스 응답이 아닙니다. |
read-only-custom-api.json / custom-api-01.json유지관리되는 전체 SDK 기준 요청이며 가이드 사본은 같은 JSON입니다. | fixture.response.component = "fixture-component"; score = "97" (문자열) | STRING_TO_INTEGER는 score를 기대 정수 quality_score 97로 매핑합니다. 문서의 SDK 결과는 로컬 후보입니다. |
custom-api-02.jsonfixture 응답 값 두 개만 바꾼 두 번째 전체 SDK 요청입니다. | component = "my-test-component"; score = "88" (문자열) | 기대 매핑 component는 "my-test-component", quality_score는 정수 88입니다. 실제 매니페스트·단계를 확인하며 매핑 소스는 같을 수 있습니다. |
custom-api-score-number.json정상 기준 예제가 아닌 의도적 오류 입력입니다. | 선언된 문자열 스키마에 fixture.response.score = 88 (JSON 숫자) 사용 | 실제 타입 오류 결과를 보존하며 이 예제를 성공 후보로 기록하지 않습니다. |
Worksheet / SDK artifacts / Work reports사람 기록·로컬 컴파일 후보·실제 Work 및 보고서·영수증이라는 서로 다른 산출물 종류입니다. | 해당 도구·현재 타깃을 사용하며 워크시트·이전 결과를 다음 전체 요청으로 제출하지 않습니다. | 실제 입력·버전·후보 또는 Work 식별에 출력을 연결합니다. 파일 존재·종료 0만으로는 충분하지 않습니다. |
사용자가 제공한 2026년 10월 8일 v1.5 개념도입니다. 고객 운영 Pack은 선언된 Contract·권한 안에서 동작하고 Builder는 검증·승인이 필요한 후보를 준비합니다. Pack 종류·자기 적응 표기는 예시·릴리스별이며 현재 실행 가능한 기능 목록이 아닙니다. 현재 표시본은 문서 변경을 반영한 영문 SVG이며, 이전 래스터 원본은 보존합니다.
조직이 관리하는 환경을 위한 준비·검증 절차입니다. 정확한 전달 버전에 맞는 지원 배포 절차와 패키지를 확보하십시오. 공개 매뉴얼 다운로드는 문서이며 어플라이언스 설치 프로그램이 아닙니다.
Online은 해당 설치에서 승인한 네트워크 접근을 사용합니다. Offline은 폐쇄 온프렘용 선택 사항이며, 반입 전에 정확한 OS·타깃 도구 체인과 의존성 세트를 준비합니다. 매뉴얼 ZIP에는 문서와 합성 입력이 있으며 제품 바이너리나 Rust 도구 체인은 없습니다.
승인 경로로 받은 매니페스트와 지문을 비교합니다. 아래 명령은 지문 계산 예시이며 신뢰할 수 없는 매니페스트의 진위를 보장하지 않습니다. 실제 제공 파일명으로 바꾸십시오.
# macOS
shasum -a 256 supplied-package.zip
# Linux
sha256sum supplied-package.zip
# Windows PowerShell
Get-FileHash -Algorithm SHA256 .\supplied-package.zip지문이나 타깃이 다르면 파일과 불일치 기록을 별도 보존하고 설치하지 말고 올바른 패키지를 확보합니다. 기존 정상 패키지와 매니페스트를 덮어쓰지 않습니다.
Helper B는 구현·새 Pack 필요 여부를 결정하기 전에 완성된 선언을 확인합니다. 구현·선언 변경 후에는 영향을 받은 지원 검사를 다시 수행하고 별도 구현·등록·Pack 승인 경로를 마친 뒤 사용합니다. 생성 후보는 운영 권한을 부여하지 않습니다.
목표에 필요한 경로만 선택합니다. 보존 PoC 독해는 설치 없이 시작할 수 있습니다. 제공된 로컬 SDK 실습은 Part.1 → Part.5를 따르며 새 GAPE 관찰·어플라이언스 계정이 필요하지 않습니다. 기존 승인 Pack은 현재 준비 요건 확인 후 Part.1 → Part.7 → Part.8을 따를 수 있습니다. 새 연동·Pack 작성은 조건부 전체 순서를 따릅니다.
설치 릴리스와 호환되며 구현·등록된 기존 연동이 요구를 충족할 때만 SDK 작성을 생략합니다. 기존 승인 Pack이 목표와 설치 범위를 충족할 때만 Builder 제작을 생략합니다. 어느 경우든 선언 확인·연동 검증·결과 검토는 수행합니다.
제공된 Golden 환경에 호환되는 의존성과 도구가 있으면 문서화된 구성을 재사용합니다. 그렇지 않으면 별도의 호환 의존성 패키지를 준비합니다. 오프라인 의존성 세트는 선언된 crate와 타깃을 대상으로 하며 모든 Rust crate·컴파일러·링커·외부 도구를 보장하지 않습니다.
문서의 SDK 실습은 새 결과 디렉터리에서 실행합니다. adapter.rs·manifest.json·필요한 컴파일 산출물과 패키지 검증 결과를 확인합니다. 실제 단절 환경에서는 추가 다운로드 없이 선택 실습이 완료되었음을 기록합니다. 캐시 복사만으로는 충분한 증명이 아닙니다.
선택 입력·정확한 버전·출력 위치와 지문·발생한 오류 원문·검증 결과·검토자 결정을 보존합니다. 실패·성공 후보를 분리합니다. 평가는 PoC 공통 점수표, 지원 기록은 Part.8을 사용합니다.
| 관찰된 문제 | 조치와 완료 확인 |
|---|---|
| Offline 빌드가 crate 또는 네트워크를 요구함 | 정확한 crate·버전 오류를 보존합니다. 제공된 lockfile·의존성 세트 매니페스트·타깃 설정을 확인합니다. 승인된 반입 경로에서 누락된 호환 세트를 확보한 뒤 새 결과 폴더를 사용합니다. 임의로 인터넷을 연결하지 않습니다. |
| 컴파일러 또는 네이티브 링커가 없음 | crate 아카이브는 컴파일러나 링커를 설치하지 않습니다. Part.1의 OS 준비 목록과 Part.5 SDK 설정을 제공 도구 체인과 비교합니다. 실습을 반복하기 전에 준비를 완료합니다. |
| 연결 실패 또는 엔드포인트 불명 | 정확한 메시지를 기록하고 운영자가 제공한 엔드포인트·서비스 릴리스·승인 경로·프록시 및 인증서 설정을 확인합니다. 실행 중 프로세스나 호스트 도달만으로 제품 준비 완료를 입증하지 않습니다. |
| 제공 릴리스의 지원 최초 관리자 절차가 없음 | 관리자 의존 작업을 멈추고 전달 담당자와 누락 절차를 기록합니다. 읽기·계획·합성 문서 준비는 계속할 수 있습니다. OS 관리자 접근에서 제품 권한을 추론하지 않습니다. |
| SDK 소스는 같지만 라이브러리 지문이 다름 | 입력 바이트·SDK·컴파일러·타깃·의존성 버전·실행 경로를 비교합니다. 두 출력을 보존하고 동일 빌드 결론 전에 Part.1과 Part.5의 재현성 확인 절차를 따릅니다. |