Skip to main content

CodeQL 구성 파일에서 명령 옵션 지정하기

자주 사용하는 명령 옵션과 사용자 지정 CodeQL 팩을 CodeQL 구성 파일에 추가하여 시간을 절약하십시오.

누가 이 기능을 사용할 수 있나요?

CodeQL은(는) 다음 리포지토리 유형에 사용할 수 있습니다.

CodeQL 구성 파일 사용하기

  1. 홈(Linux 및 macOS) 디렉터리 또는 사용자 프로필(Windows) 디렉터리의 .config/codeql/ 하위 디렉터리에 config 파일을 만들고 저장합니다. 예: $HOME/.config/codeql/config.

  2. config 파일에 CodeQL 명령에 적용할 옵션을 지정하세요. 옵션을 지정하는 구문은 다음과 같습니다.

    <command> <subcommand> <option> <value>
    
  3. 둘 이상의 명령에 동일한 옵션을 적용하려면 다음을 수행할 수 있습니다.

    • 생략하십시오 <subcommand>- 이로 인해 모든 관련 <subcommand>에 대한 옵션이 지정됩니다.
    •     `<command>` 및 `<subcommand>`를 모두 생략하면 모든 관련 `<command>` 및 `<subcommand>` 옵션에 대해 전역적으로 설정됩니다.
      

참고 항목

* config 파일은 옵션 플래그와 값 사이에 공백만 허용하고, =는 허용하지 않습니다.

  • 명령줄에서 옵션을 지정하면 해당 옵션에 대해 정의된 모든 config 값을 재정의합니다.
  • 또는 전역적으로 둘 이상의 옵션을 <command>``<subcommand>지정하려면 옵션당 한 줄을 사용합니다.

예시

  • CSV 형식으로 codeql database analyze에 의해 생성된 모든 분석 결과를 출력하려면 다음을 지정합니다.

    database analyze --format csv
    

    여기서는 database analyze에 동일한 --format 옵션이 전달되는 동안 실행되는 하위 수준 명령을 방지하기 위해 명령 및 하위 명령을 지정해야 합니다.

  • CodeQL 명령을 실행할 때 사용할 RAM(4096MB) 및 스레드 수(4)를 정의하려면 별도의 줄에서 다음을 지정합니다.

    --ram 4096
    --threads 4
    
  • CodeQL에 대한 디렉터리를 전역적으로 지정하여 CodeQL 팩(설치 디렉터리의 형제가 아님)을 스캔하려면 다음을 사용합니다.

    --search-path <path-to-directory>