Share via


관리 코드에 대한 사용자 지정 코드 분석 체크 인 정책 구현

코드 분석 체크 인 정책은 버전 제어에 체크 인하기 전에 Azure DevOps 프로젝트의 멤버가 소스 코드에서 실행해야 하는 규칙 집합을 지정합니다. Microsoft는 코드 분석 규칙을 기능 영역으로 그룹화한 표준 규칙 집합 을 제공합니다. 사용자 지정 체크 인 정책 규칙 집합 은 프로젝트별 코드 분석 규칙 집합을 지정합니다. 규칙 집합은 .ruleset 파일에 저장됩니다.

체크 인 정책은 Azure DevOps 프로젝트 수준에서 설정되며 버전 제어 트리에서 .ruleset 파일의 위치에 의해 지정됩니다. 팀 정책 사용자 지정 규칙 집합의 버전 제어 위치에 대한 제한은 없습니다.

코드 분석은 각 프로젝트에 대한 속성 창의 개별 코드 프로젝트에 대해 구성됩니다. 코드 프로젝트에 대한 사용자 지정 규칙 집합은 로컬 컴퓨터에서 .ruleset 파일의 물리적 위치에 의해 지정됩니다. 코드 프로젝트와 동일한 드라이브에 있는 .ruleset 파일이 지정된 경우 Visual Studio의 프로젝트 구성에서는 해당 파일에 대한 상대 경로가 사용됩니다.

Azure DevOps 프로젝트 사용자 지정 규칙 집합을 만드는 데 권장되는 방법은 코드 프로젝트의 일부가 아닌 특수 폴더에 체크 인 정책 .ruleset 파일을 저장하는 것입니다. 전용 폴더에 파일을 저장하는 경우 규칙 파일을 편집할 수 있는 사람을 제한하는 권한을 적용할 수 있으며 프로젝트가 포함된 디렉터리 구조를 다른 디렉터리 또는 컴퓨터로 쉽게 이동할 수 있습니다.

프로젝트 사용자 지정 체크 인 규칙 집합 만들기

Azure DevOps 프로젝트에 대한 사용자 지정 규칙 집합을 만들려면 먼저 소스 제어 탐색기에서 체크 인 정책 규칙 집합에 대한 특수 폴더를 만듭니다. 그런 다음 규칙 집합 파일을 만들고 버전 제어에 파일을 추가합니다. 마지막으로 규칙 집합을 프로젝트의 코드 분석 체크 인 정책으로 지정합니다.

참고 항목

Azure DevOps 프로젝트에서 폴더를 만들려면 먼저 프로젝트 루트를 로컬 컴퓨터의 위치에 매핑해야 합니다.

체크 인 정책 규칙 집합에 대한 버전 제어 폴더를 만들려면

  1. 팀 탐색기에서 프로젝트 노드를 확장한 다음 소스 제어를 클릭합니다.

  2. 폴더 창에서 프로젝트를 마우스 오른쪽 단추로 클릭한 다음 새 폴더를 클릭합니다.

  3. 기본 소스 제어 창에서 새 폴더를 마우스 오른쪽 단추로 클릭하고 이름 바꾸기를 클릭한 다음 규칙 집합 폴더의 이름을 입력합니다.

체크 인 정책 규칙 집합을 만들려면

  1. 파일 메뉴에서 새로 만들기를 가리킨 다음 파일을 클릭합니다.

  2. 범주 목록에서 일반을 클릭합니다.

  3. 템플릿 목록에서 코드 분석 규칙 집합을 두 번 클릭합니다.

  4. 규칙 집합에 포함할 규칙을 지정한 다음, 만들어 둔 규칙 집합 폴더에 규칙 집합 파일을 저장합니다.

버전 제어에 규칙 집합 파일을 추가하려면

  1. 소스 제어 탐색기에서 새 폴더를 마우스 오른쪽 단추로 클릭한 다음 폴더에 항목 추가 를 클릭합니다.

    자세한 내용은 Git 및 Azure Repos를 참조하세요.

  2. 만든 규칙 집합 파일을 클릭한 다음 마침을 클릭합니다.

    파일이 소스 제어에 추가되고 체크 아웃됩니다.

  3. 소스 제어 탐색기 세부 정보 창에서 파일 이름을 마우스 오른쪽 단추로 클릭한 다음 보류 중인 변경 내용 체크 인을 클릭합니다.

  4. 체크 인 대화 상자에서 주석을 추가한 다음 체크 인을 클릭할 수 있습니다.

    참고 항목

    Azure DevOps 프로젝트에 대한 코드 분석 체크 인 정책을 이미 구성했고 현재 솔루션의 일부인 파일만 포함하도록 체크 인 적용을 선택한 경우 정책 실패 경고가 트리거됩니다. 정책 실패 대화 상자에서 정책 오류 재정의 및 계속 체크 인을 선택합니다. 필요한 주석을 추가한 다음 확인을 클릭합니다.

규칙 집합 파일을 체크 인 정책으로 지정하려면

  1. 메뉴에서 프로젝트 설정을 가리킨 다음 소스 제어를 클릭합니다.

  2. 체크 인 정책을 클릭한 다음 추가를 클릭합니다.

  3. 체크 인 정책 목록에서 코드 분석을 두 번 클릭하고 관리 코드에 대한 코드 분석 적용 확인란이 선택되어 있는지 확인합니다.

  4. 이 규칙 집합 실행 목록에서 소스 제어>에서 규칙 집합 선택을 클릭합니다<.

  5. 버전 제어에 체크 인 정책 규칙 집합 파일의 경로를 입력합니다.

    경로는 다음 구문을 따라야 합니다.

    $/ TeamProjectName / VersionControlPath

    참고 항목

    소스 제어 탐색기에서 다음 절차 중 하나를 사용하여 경로를 복사할 수 있습니다.

    • 폴더 창에서 규칙 집합 파일이 포함된 폴더를 클릭합니다. 원본 상자에 표시되는 폴더의 버전 제어 경로를 복사하고 규칙 집합 파일의 이름을 수동으로 입력합니다.

    • 세부 정보 창에서 규칙 집합 파일을 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다. 일반 탭에서 서버 이름의 값을 복사합니다.

체크 인 정책 규칙 집합에 코드 프로젝트 동기화

프로젝트 체크 인 정책 규칙 집합을 코드 프로젝트의 속성 대화 상자에서 코드 프로젝트 구성의 코드 분석 규칙 집합으로 지정합니다. 규칙 집합이 코드 프로젝트와 동일한 드라이브에 있는 경우 상대 경로는 파일 대화 상자에서 경로를 선택할 때 규칙 집합을 지정하는 데 사용됩니다. 상대 경로를 사용하면 유사한 로컬 버전 제어 구조를 사용하는 다른 컴퓨터로 프로젝트 속성 설정을 이식할 수 있습니다.

프로젝트 규칙 집합을 코드 프로젝트의 규칙 집합으로 지정하려면

  1. 필요한 경우 버전 제어에서 체크 인 정책 규칙 집합 폴더 및 파일을 찾아옵니다.

    규칙 집합 폴더를 마우스 오른쪽 단추로 클릭한 다음 최신 버전 가져오기를 클릭하여 소스 제어 탐색기에서 이 단계를 수행할 수 있습니다.

  2. 솔루션 탐색기에서 코드 프로젝트를 오른쪽 마우스 단추로 클릭한 다음, 속성을 클릭합니다.

  3. 코드 분석을 클릭합니다.

  4. 필요한 경우 구성플랫폼 목록에서 적절한 옵션을 클릭합니다.

  5. 지정한 구성을 사용하여 코드 프로젝트를 빌드할 때마다 코드 분석을 실행하려면 이진 분석기 섹션에서 빌드 시 실행을 선택합니다.

  6. Run this rule set(이 규칙 집합 실행) 목록에서 Browse(찾아보기 ) <를 클릭합니다>.

  7. 체크 인 정책 규칙 집합 파일의 로컬 버전을 선택합니다.