청구 어댑터 샘플을 빌드하고 실행하는 방법
적용 대상: Windows Azure 팩
청구 어댑터 샘플은 에서 https://www.microsoft.com/en-us/download/details.aspx?id=41146사용할 수 있는 Windows Azure Pack 개발자 키트 샘플의 일부로 제공됩니다. 다음 항목에서는 샘플을 콘솔 애플리케이션 또는 Windows 서비스로 빌드하고 실행하는 방법을 보여 줍니다. 샘플을 Windows 서비스로 실행하는 방법을 보여 주는 스크립트도 제공됩니다.
참고
청구 어댑터가 처음 시작되면 Windows Azure 팩 사용량 API의 모든 기록 데이터를 사용하는 데 시간이 걸릴 수 있습니다. 사용할 이벤트가 많은 경우 동기화 문제를 방지하려면 테넌트 기능을 일시적으로 사용하지 않도록 설정해야 합니다. 이 작업을 수행하지 않으면 구매 시 종속 이벤트가 청구 시스템으로 처리되지 않은 경우 일부 구매 작업이 차단되었을 수 있습니다. 이 작업은 TenantSite, TenantAPI 및 TenantPublicAPI의 애플리케이션 풀 또는 사이트 서비스를 중지하여 수행할 수 있습니다.
청구 어댑터 샘플 빌드
청구 어댑터 샘플을 빌드하려면
폴더에 Windows Azure Pack 개발자 키트 zip 파일을 추출합니다.
추출된 폴더의 BillingAdapter 폴더에서 청구 어댑터 Visual Studio 솔루션 Microsoft.WindowsAzurePack.Samples.Billing.sln 찾습니다.
Visual Studio에서 솔루션(.sln) 파일을 엽니다.
도구 메뉴 옵션을 선택한 다음 확장 및 업데이트 선택하여 최신 NuGet 패키지 설치 관리자가 설치되어 있는지 확인합니다. 표시된 대화 상자에서 온라인 을 선택한 다음 Visual Studio 갤러리 를 선택하여 NuGet 패키지 관리자에 대한 업데이트가 있는지 확인합니다. 있는 경우 설치합니다.
NuGet 패키지 관리자가 설치되어 있지 않으면 를 참조하세요 https://www.nuget.org/.
NuGet 패키지 설치 관리자 옵션 대화 상자를 열어 필요한 패키지가 자동으로 다운로드되도록 합니다. 도구 메뉴, 라이브러리 패키지 관리자, 솔루션용 Nuget 패키지 관리...를 선택하여 이 작업을 수행합니다. NuGet 패키지 관리 대화 상자가 표시됩니다. 설정을 클릭하여 옵션 대화 상자를 엽니다.
패키지 관리자를 선택한 다음 일반을 선택합니다.
패키지 복원 섹션에서 Nuget이 누락된 패키지를 다운로드하도록 허용하고 Visual Studio에서 빌드하는 동안 누락된 패키지에 대해 자동으로 검사 확인합니다.
확인을 클릭하여 설정 대화 상자를 닫은 다음 닫기를 클릭하여 NuGet 패키지 관리 대화 상자를 닫습니다.
Visual Studio에서 솔루션을 빌드합니다.
청구 어댑터 샘플 실행
청구 어댑터 샘플은 콘솔 애플리케이션 또는 Windows 서비스로 실행할 수 있습니다.
빌드 출력 디렉터리(일반적으로 프로젝트 폴더의 bin\Debug 또는 bin\Release 아래)를 다른 위치에 복사하고 프로덕션 환경 설정에 따라 이 위치의 app.config 편집하는 것이 좋습니다. 빌드 출력을 다른 위치에 복사하면 향후 빌드에서 app.config 변경 내용을 덮어쓰지 않습니다. 또한 청구 어댑터 시스템 특정 어셈블리가 모든 종속성(또는 전역 어셈블리 캐시에 등록됨)을 포함하여 동일한 폴더에 있는지 확인합니다. app.config 파일에 대한 자세한 내용은 청구 어댑터 핵심 엔진 샘플 파일 정보를 참조하세요.
청구 어댑터는 추적 메시지를 Windows 이벤트 로그 채널로 내보낸다. 이 채널을 사용하려면 먼저 등록해야 합니다. 채널을 등록하려면 registerlog 인수를 사용하여 청구 어댑터 실행 파일을 호출합니다. 예를 들어 레지스터로그를 Microsoft.WindowsAzurePack.Samples.Billing.exe.
청구 어댑터를 콘솔 애플리케이션으로 실행하려면
명령 프롬프트 열기
출력 폴더의 registerlog 인수를 사용하여 Microsoft.WindowsAzurePack.Samples.Billing.exe 실행합니다(일반적으로 프로젝트 폴더의 bin\Debug 또는 bin\Release 아래).
Windows 서비스로 청구 어댑터를 실행하려면
명령 프롬프트를 엽니다.
registerlog 매개 변수를 사용하여 Microsoft.WindowsAzurePack.Samples.Billing.exe 실행합니다.
청구 어댑터 폴더에서 서비스를 실행하는 데 사용할 계정에 읽기 & 실행 권한을 부여합니다.
청구 어댑터를 Windows 서비스로 등록합니다. 청구 어댑터 실행 파일을 Windows 서비스로 등록하는 경우 "서비스" 인수인 Microsoft.WindowsAzurePack.Samples.Billing.exe 서비스를 제공해야 합니다.
Windows 서비스를 시작합니다.
Windows 서비스로 청구 어댑터 샘플을 실행하는 스크립트
다음 스크립트는 청구 어댑터 샘플을 Windows 서비스로 실행하는 방법을 보여 줍니다.
# \"Install\" the billing adapter (creates the event log channel where the service will log events)
<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog
# Give permissions to the account running the service to access the folder where it is installed and run the executable
icacls <Path to Sample Build Location>/T /grant "NT AUTHORITY\NETWORK SERVICE:(RX)"
# Create (register) the service to be run on startup using the account given access above.
sc create wapbill start= auto binPath= "<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe service" obj= "NT AUTHORITY\NetworkService" DisplayName= "Azure Pack Billing Adapter"
# start the service
sc start wapbill