Visual Studio에서 Azure 클라우드 서비스 디버깅

Visual Studio는 Azure 클라우드 서비스와 가상 머신 디버깅에 여러 옵션을 제공합니다.

필수 조건

• Azure 계정. Azure 계정: Azure 계정이 없는 경우 평가판을 등록하거나 Visual Studio 구독자 혜택을 활성화할 수 있습니다.

로컬 컴퓨터에서 클라우드 서비스 디버그

Azure 컴퓨팅 에뮬레이터를 사용하여 로컬 머신에서 클라우드 서비스를 디버그하면 시간과 비용을 절약할 수 있습니다. 배포하기 전에 로컬로 서비스를 디버깅하면, 컴퓨팅 시간이 소요되지 않고 안정성과 성능을 향상할 수 있습니다. 그러나, Azure 자체에서 클라우드 서비스를 실행하는 경우, 일부 오류가 발생할 수 있습니다. 서비스를 게시하거나 역할 인스턴스에 디버거를 연결할 때 원격 디버깅을 사용하면 이 오류들을 디버그할 수 있습니다.

에뮬레이터가 로컬 환경에서 Azure 컴퓨팅 서비스를 시뮬레이트 및 실행하여 클라우드 서비스를 배포하기 전에 테스트 및 디버그할 수 있습니다. 에뮬레이터는 역할 인스턴스의 수명 주기를 처리하고 로컬 스토리지 같은 시뮬레이트된 리소스에 대한 액세스를 제공합니다. Visual Studio에서 서비스를 디버그하거나 실행할 때, 에뮬레이터가 백그라운드 애플리케이션으로 자동으로 시작된 다음, 서비스가 에뮬레이터에 배포됩니다. 로컬 환경에서 서비스가 실행되는 것을 보기 위해 에뮬레이터를 사용할 수 있습니다. 에뮬레이터의 정식 버전 또는 Express 버전을 사용할 수 있습니다. 로컬로 클라우드 서비스를 실행 및 디버그할 때 에뮬레이터 익스프레스 사용을 참조하세요.

로컬 컴퓨터에서 클라우드 서비스를 디버그 하려면

1. 메뉴 모음에서 디버그>디버깅 시작을 선택하여 Azure 클라우드 서비스 프로젝트를 실행합니다. F5를 눌러도 디버깅을 시작할 수 있습니다. 컴퓨팅 에뮬레이터가 시작된다는 메시지가 표기됩니다. 에뮬레이터를 시작할 때 시스템 트레이 아이콘을 확인합니다.

   

2. 알림 영역에서 Azure 아이콘에 대한 바로 가기 메뉴를 연 다음 Compute 에뮬레이터 UI 표시를 선택하여 컴퓨팅 에뮬레이터에 대한 사용자 인터페이스를 표시합니다.

   UI의 왼쪽 창에서는 현재 컴퓨팅 에뮬레이터와 각 서비스를 실행하는 역할 인스턴스가 배포되는 서비스를 보여줍니다. 오른쪽 창에서 수명 주기, 로깅 및 진단 정보를 표시하는 서비스 또는 역할을 선택할 수 있습니다. 포함된 창의 위쪽 여백에 포커스를 맞추면 오른쪽 창에 맞게 확장됩니다.

3. 디버그 메뉴에서 명령을 선택하고 코드에서 중단점을 설정하여 애플리케이션을 단계별로 실행합니다. 디버거에서 애플리케이션을 통해 단계를 진행하면 애플리케이션의 현재 상태로 창이 업데이트됩니다. 디버깅을 중지하면 애플리케이션 배포가 삭제됩니다. 애플리케이션이 웹 역할을 포함하고 웹 브라우저를 시작하도록 시작 동작 속성을 설정하면, Visual Studio는 브라우저에서 웹 애플리케이션을 시작합니다. 서비스 구성에서 역할의 인스턴스 수를 변경한 경우, 클라우드 서비스를 중지하고 역할의 이러한 새 인스턴스를 디버깅할 수 있도록 디버깅을 다시 시작해야 합니다.

   참고 항목

   서비스 실행이나 디버깅을 중지해도 로컬 컴퓨팅 에뮬레이터 및 스토리지 에뮬레이터는 중지되지 않습니다. 알림 영역에서 이 에뮬레이터들을 명시적으로 중지해야 합니다.

Azure에서 클라우드 서비스 디버그

이 섹션의 절차를 통해 클라우드 서비스에 원격 디버깅을 사용하도록 설정면 성능이 저하되거나 추가 요금이 발생하지 않습니다. 서비스를 사용하는 클라이언트에 악영향을 줄 수 있으므로 원격 디버깅을 프로덕션 서비스에 사용하지 않도록 합니다.

참고 항목

Visual Studio에서 클라우드 서비스를 게시할 때 .NET Framework 4 또는 .NET Framework 4.x를 대상으로 하는 서비스의 모든 역할에 대해 IntelliTrace 를 사용할 수 있습니다. IntelliTrace를 사용하여 이전의 역할 인스턴스에서 발생한 이벤트를 검사하고 그 시점부터 컨텍스트를 재현할 수 있습니다. IntelliTrace 및 Visual Studio를 사용하여 게시된 클라우드 서비스 디버깅 및 IntelliTrace 사용하기를 참조하세요.

클라우드 서비스(추가 지원)에 대해 원격 디버깅을 사용하려면

1. 기본 msvsmon 포트에 대한 ServiceDefinition.csdef에 엔드포인트를 추가합니다. Visual Studio 2022의 경우 4026이고, Visual Studio 2019의 경우 4024입니다.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   참고 항목

   다른 버전의 Visual Studio에는 서로 다른 포트 원격 디버거 포트 할당이 있습니다.

2. .NET 4.8을 대상으로 하는 경우 ServiceConfiguration.Cloud.cscfg 파일을 열고 Cloud Services(추가 지원)를 게시할 때 ServiceConfiguration 요소의 osFamily 특성 값을 확인해야 합니다. .NET 4.8 프로젝트의 경우 osFamily="7"를 사용합니다.

3. Azure 프로젝트의 바로가기 메뉴를 열고, 게시를 선택합니다.

4. 스테이징 환경 및 디버그 구성을 선택합니다.

   단지 지침일 뿐입니다. 테스트 환경을 프로덕션 환경에서 실행하도록 선택할 수 있습니다. 그러나 프로덕션 환경에서 원격 디버깅을 사용할 경우 사용자에게 악영향을 끼칠 수 있습니다. 릴리스 구성을 선택할 수도 있지만, 디버그 구성이 디버깅을 더 쉽게 할 수 있습니다.

   

5. 클라우드 서비스(추가 지원)에 설명된 일반적인 단계를 차례로 수행하지만, 모든 역할에 대해 원격 데스크톱 활성화 체크박스를 꼭 선택하세요.

   나중에 해당 가상 머신에 로그인하는 데 필요한 원격 데스크톱 사용자의 사용자 이름과 암호를 만들라는 메시지가 표시됩니다.

6. 다음 화면으로 이동하여 설정을 검토하고, 준비가 되면 게시를 클릭하고 배포가 완료되기를 기다립니다.

7. Azure Portal에 로그인하고 디버그하려는 클라우드 서비스(추가 지원)로 이동합니다.

8. 왼쪽 창에서 역할 및 인스턴스를 선택한 다음 원격으로 디버깅하려는 역할을 선택합니다.

9. 오른쪽의 역할 인스턴스 팝아웃에서 연결을 클릭하고 연결 단추를 선택하여 가상 머신에 로그인할 수 있는 원격 데스크톱 파일을 다운로드합니다. 이전 단계에서 원격 데스크톱을 사용하도록 설정할 때 만든 자격 증명을 사용하여 로그인합니다.

   

10. 원격 Azure 가상 머신에서 원격 디버깅에 설명된 대로 Visual Studio 2022 원격 도구를 설치합니다.

11. 가상 머신의 데스크톱에서D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe 명령을 실행합니다. 관리자 권한으로 실행해야 합니다.

12. 프롬프트를 수락하여 방화벽을 통한 액세스를 허용합니다. msvsmon.exe가 연결을 위해 수신 대기하기 시작했음을 나타내는 메시지가 나타나야 합니다.

    

13. Azure 포털에서 리소스 그룹을 열고 클라우드 서비스(추가 지원)의 공용 IP 주소를 가져옵니다.

    

Azure에서 클라우드 서비스(추가 지원)에 디버거를 연결하려면

참고 항목

가능하면 게시 프로세스에서 선택한 디버그 구성으로 디버그해야 하지만 릴리스 구성을 디버깅하는 경우 Visual Studio에서 Ctrl+Q를 사용하여 "내 코드만"을 검색하고 도구>옵션>디버거>일반에서 내 코드만 사용을 선택 취소합니다. 출시 빌드는 최적화되어 있으므로 "내 코드"로 간주되지 않습니다.

1. 디버그>프로세스에 연결을 선택합니다(또는 Ctrl+Alt+P를 누릅니다).

2. 연결 유형을 기본값으로 유지합니다.

3. IP 주소와 포트({ipaddress}:4026)를 사용하여 연결 대상을 입력합니다.

4. 연결 대상을 자동으로 설정합니다.

5. 원격 데스크톱 사용자와 동일한 자격 증명을 사용하여 로그인합니다.

6. 모든 사용자의 프로세스 표시를 선택합니다. 작업자 역할을 디버깅하는 경우에는 WaWorkerHost.exe에 연결하고, 웹 역할을 디버깅하는 경우에는 w3wp.exe 프로세스에 연결하며, Web API 역할의 경우에는 WaIISHost.exe에 연결합니다.

7. 중단점을 설정하고(해당 줄로 이동하여 F9 키 누르기), 사이트의 공용 URL에 액세스한 후, 디버그할 시나리오를 재현합니다.

Azure에서 원격 디버깅의 제한 사항

원격 디버깅에는 다음과 같은 제한 사항이 있습니다.

• 원격 디버깅을 사용하면 모든 역할에 25개 이상의 인스턴스가 있는 클라우드 서비스를 게시할 수 없습니다.

• 디버거는 30400에서 30424, 31400에서 31424 및 32400에서 32424의 포트를 사용합니다. 이 포트 중 하나를 사용하려는 경우, 서비스를 게시할 수 없으며, 다음과 같은 오류 메시지 중 하나가 Azure 활동 로그에 표시됩니다.

  • .csdef 파일에 대한 .cscfg 파일의 유효성 검사 오류가 발생했습니다. 역할 'role'의 끝점 Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector에 예약된 포트 범위 'range'가 이미 정의된 포트 또는 범위와 겹칩니다.
  • 할당하지 못했습니다. 다음에 다시 시도하거나, 가상 컴퓨터 사이즈 또는 역할 인스턴스의 수를 줄이거나 다른 지역에 배포해 보십시오.

Azure App Service 디버깅

Visual Studio의 프로세스에 연결 대화 상자를 사용하여 Azure App Service에서 실행되는 프로그램을 디버그할 수 있습니다.

참고 항목

Visual Studio 2022 17.1부터 Azure App Service에서만 사용할 수 있습니다.

Windows Azure App Service를 디버그하려면

1. 디버그 아래에서 프로세스에 연결을 선택합니다.

2. 연결 유형을 Microsoft Azure App Services로 변경한 다음 찾기..를 선택합니다.

3. 열리는 대화 상자에서 구독 이름을 선택합니다.

   

   참고 항목

   Azure App Service가 포함된 구독에 액세스할 수 있는 Microsoft 계정에 로그인해야 합니다.

4. 리소스 그룹 또는 리소스 종류별로 보기를 필터링하거나 이름으로 검색합니다.

5. 다음으로 디버그할 App Service를 선택한 다음 확인을 선택합니다.

   이렇게 하면 App Service 원격 디버깅이 가능하며 연결할 수 있는 프로세스 목록이 표시됩니다.

   

6. 연결할 프로세스를 선택한 다음 연결을 선택하여 디버깅을 시작합니다.

관련 콘텐츠

• IntelliTrace를 사용하여 릴리스 서버에서 호출 및 이벤트 로그를 수집합니다. IntelliTrace 및 Visual Studio를 사용하여 게시된 클라우드 서비스 디버깅을 참조하세요.

• Azure Diagnostics를 이용하여 개발 환경 또는 Azure에서 실행되는 역할 내에서 실행되는 코드의 자세한 내용을 기록합니다. Azure Diagnostics를 사용하여 로깅 데이터 수집을 참조하세요.

• 다른 원격 디버깅 시나리오는 원격 디버깅을 참조 하세요.