빠른 시작과 배포¶

빠른 시작¶

Windows PowerShell 7, Node.js 22 이상, Azure CLI, Bicep가 필요합니다. 모든 명령은 저장소 루트에서 실행합니다. Azure CLI 인증은 az login으로 준비합니다. 권한은 리소스 생성 및 OpenAI 리소스 범위 RBAC 생성이 가능해야 합니다. 모델별 quota와 가용 버전은 배포 직전에 다시 확인합니다.

npm ci
npm test
npm run demo:offline

Offline은 모델 호출·Azure export 없이 세 모델별 9개 fixture와 독립적인 비용 수학 예제를 실행합니다.

Azure 배포와 시연¶

# 먼저 validate와 what-if만 실행합니다.
.\scripts\Deploy-Demo.ps1 `
  -SubscriptionId "<subscription-guid>" `
  -ResourceGroupName "rg-aoai-monitor-demo" `
  -ResourcePrefix "<globallyuniqueprefix>" `
  -Location "eastus2"

# 검토 후 -Execute를 추가합니다. 실제 과금 리소스를 생성합니다.
.\scripts\Deploy-Demo.ps1 `
  -SubscriptionId "<subscription-guid>" `
  -ResourceGroupName "rg-aoai-monitor-demo" `
  -ResourcePrefix "<globallyuniqueprefix>" `
  -Location "eastus2" -Execute

.\scripts\Use-Demo.ps1 -Mode live -CountPerModel 1
.\scripts\Use-Demo.ps1 -Mode replay

각 실행의 마지막 줄에 출력되는 run UUID를 기록합니다. 메일 경로 시연은 배포 시 -AlertEmail "<authorized-email>"을 추가하고 .\scripts\Test-AlertEmail.ps1 -EmailAddress "<authorized-email>"로 한 번 테스트합니다. 수신자 인증, Azure 발송 결과, 실제 inbox 수신을 별도 확인합니다.

.\scripts\Use-Demo.ps1 -Mode verify `
  -LiveRunId "<live-run-uuid>" -ReplayRunId "<replay-run-uuid>" `
  -CountPerModel 1

모델 하나만 실행하려면 -Deployments "gpt-5.6-terra"를 추가하고 verify에도 같은 선택을 적용합니다. 단일 실행에서 같은 safe counting 메시지와 출력 상한으로 모델들을 streaming 순차 호출합니다. 작은 smoke test의 지연값은 모델 품질/성능 벤치마크가 아닙니다.

관측은 Azure Portal의 Shared Dashboard와 Workbook에서 시작합니다. 화면 링크와 사용법을 확인하십시오. native 화면을 위한 로컬 서버는 필요하지 않습니다. Managed Grafana와 참고 저장소 Dashboard는 Hybrid 비교 경로입니다. 참고 저장소의 실제 React/Fastify 코드는 integration에 포함했습니다. MIT license와 upstream commit을 보존하고 API-only LAW adapter, streaming/ledger와 null 비용을 반영했습니다. Native/Grafana는 배포·조회 검증됐지만 custom UI의 Azure 호스팅은 Microsoft Graph 재인증에 막혀 있습니다. 인증을 끈 공개 호스팅으로 우회하지 않았습니다.