Skip to main content

diagnostic add

[์‹คํ—˜์ ] [์—ฐ๊ฒฐ] ์ง„๋‹จ ์ •๋ณด๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.

๋ˆ„๊ฐ€ ์ด ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‚˜์š”?

CodeQL์€(๋Š”) ๋‹ค์Œ ๋ฆฌํฌ์ง€ํ† ๋ฆฌ ์œ ํ˜•์— ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • GitHub Code Security๋ฅผ ์ง€์›ํ•˜๋Š” ์กฐ์ง ์†Œ์œ  ๋ฆฌํฌ์ง€ํ† ๋ฆฌ

์ด ๋ฌธ์„œ์˜ ๋‚ด์šฉ

์ฐธ๊ณ  ํ•ญ๋ชฉ

์ด ์ฝ˜ํ…์ธ ๋Š” CodeQL CLI์˜ ์ตœ์‹  ๋ฆด๋ฆฌ์Šค์— ๋Œ€ํ•ด ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. ์ด ์š”์†Œ์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ https://github.com/github/codeql-cli-binaries/releases์„(๋ฅผ) ์ฐธ์กฐํ•˜์„ธ์š”.

์ด์ „ ๋ฆด๋ฆฌ์Šค์—์„œ ์ด ๋ช…๋ น์— ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์˜ต์…˜์˜ ์„ธ๋ถ€ ์ •๋ณด๋ฅผ ๋ณด๋ ค๋ฉด ํ„ฐ๋ฏธ๋„์—์„œ ์˜ต์…˜์„ ์‚ฌ์šฉํ•˜์—ฌ --help ๋ช…๋ น์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ์š”

Shell
codeql diagnostic add (--diagnostic-dir=<diagnosticDir>) --source-id=<id> --source-name=<name> <options>...

์„ค๋ช…

[์‹คํ—˜์ ] [์—ฐ๊ฒฐ] ์ง„๋‹จ ์ •๋ณด๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.

v2.12.6๋ถ€ํ„ฐ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์˜ต์…˜

๊ธฐ๋ณธ ์˜ต์…˜

--markdown-message=<markdownMessage>

์ง„๋‹จ ๋ฉ”์‹œ์ง€(GitHub Flavored Markdown ํ˜•์‹)์ž…๋‹ˆ๋‹ค.

--plaintext-message=<plaintextMessage>

์ง„๋‹จ ๋ฉ”์‹œ์ง€(์ผ๋ฐ˜ ํ…์ŠคํŠธ)์ž…๋‹ˆ๋‹ค. ์ด ์˜ต์…˜์€ --markdown-message๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ Markdown ๋ฉ”์‹œ์ง€๋ฅผ ์ฑ„์šฐ๋Š” ๊ฒƒ์ด ์‹ค์šฉ์ ์ด์ง€ ์•Š์€ ๊ฒฝ์šฐ์—๋งŒ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

--severity=<severity>

์ง„๋‹จ์˜ ์‹ฌ๊ฐ๋„์ž…๋‹ˆ๋‹ค. "error", "warning" ๋˜๋Š” "note"์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ง„๋‹จ ๊ด€๋ จ ๋„์›€๋ง ๋งํฌ์ž…๋‹ˆ๋‹ค.

--attributes-json=<attributesJson>

์ง„๋‹จ๊ณผ ๊ด€๋ จ๋œ ๊ตฌ์กฐํ™”๋œ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ์ž…๋‹ˆ๋‹ค.

์ง„๋‹จ ์ •๋ณด์˜ ์ €์žฅ ์œ„์น˜๋ฅผ ์ง€์ •ํ•˜๋Š” ์˜ต์…˜

๋‹ค์Œ ์˜ต์…˜ ์ค‘ ํ•˜๋‚˜๋งŒ ์ง€์ •ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

--diagnostic-dir=<diagnosticDir>

์ง„๋‹จ์„ ์ถ”๊ฐ€ํ•ด์•ผ ํ•˜๋Š” ๋””๋ ‰ํ„ฐ๋ฆฌ์ž…๋‹ˆ๋‹ค.

์ง„๋‹จ ๋ฉ”์‹œ์ง€๋ฅผ ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ๋Š” ์œ„์น˜๋ฅผ ๋‚˜ํƒ€๋‚ด๋Š” ์˜ต์…˜

--ready-for-status-page

์ง„๋‹จ์ด ์ƒํƒœ ํŽ˜์ด์ง€์— ํ‘œ์‹œํ•˜๊ธฐ์— ์ ํ•ฉํ•จ์„ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค.

--ready-for-cli-summary-table

์ง„๋‹จ์ด database analyze์™€ ๊ฐ™์€ ๋ช…๋ น์œผ๋กœ ์ถœ๋ ฅํ•œ ์ง„๋‹จ ์š”์•ฝ ํ…Œ์ด๋ธ”์— ํ‘œ์‹œํ•˜๊ธฐ์— ์ ํ•ฉํ•จ์„ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค.

์ง„๋‹จ ์›๋ณธ์„ ์„ค๋ช…ํ•˜๋Š” ์˜ต์…˜

--source-id=<id>

[ํ•„์ˆ˜] ์ด ์ง„๋‹จ์˜ ์›๋ณธ์— ๋Œ€ํ•œ ์‹๋ณ„์ž์ž…๋‹ˆ๋‹ค.

--source-name=<name>

[ํ•„์ˆ˜] ์ด ์ง„๋‹จ์˜ ์›๋ณธ์— ๋Œ€ํ•œ ์‚ฌ๋žŒ์ด ์ฝ์„ ์ˆ˜ ์žˆ๋Š” ์„ค๋ช…์ž…๋‹ˆ๋‹ค.

--extractor-name=<extractorName>

CodeQL ์ถ”์ถœ๊ธฐ์—์„œ ์ด ์ง„๋‹จ์„ ์ƒ์„ฑํ•œ ๊ฒฝ์šฐ CodeQL ์ถ”์ถœ๊ธฐ์˜ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค.

์ง„๋‹จ ์œ„์น˜๋ฅผ ์„ค๋ช…ํ•˜๋Š” ์˜ต์…˜

--file-path=<file>

์›๋ณธ ๋ฃจํŠธ๋ฅผ ๊ธฐ์ค€์œผ๋กœ ์ง„๋‹จ์ด ์ ์šฉ๋˜๋Š” ํŒŒ์ผ์˜ ๊ฒฝ๋กœ์ž…๋‹ˆ๋‹ค.

--start-line=<startLine>

์ง„๋‹จ ์œ„์น˜๊ฐ€ ์‹œ์ž‘๋˜๋Š” 1 ๊ธฐ์ค€ ์ค„ ๋ฒˆํ˜ธ(ํฌํ•จ)์ž…๋‹ˆ๋‹ค.

--start-column=<startColumn>

์ง„๋‹จ ์œ„์น˜๊ฐ€ ์‹œ์ž‘๋˜๋Š” 1 ๊ธฐ์ค€ ์—ด ๋ฒˆํ˜ธ(ํฌํ•จ)์ž…๋‹ˆ๋‹ค.

--end-line=<endLine>

์ง„๋‹จ ์œ„์น˜๊ฐ€ ๋๋‚˜๋Š” 1 ๊ธฐ์ค€ ์ค„ ๋ฒˆํ˜ธ(ํฌํ•จ)์ž…๋‹ˆ๋‹ค.

--end-column=<endColumn>

์ง„๋‹จ ์œ„์น˜๊ฐ€ ๋๋‚˜๋Š” 1 ๊ธฐ์ค€ ์—ด ๋ฒˆํ˜ธ(ํฌํ•จ)์ž…๋‹ˆ๋‹ค.

์ผ๋ฐ˜ ์˜ต์…˜

-h, --help

์ด ๋„์›€๋ง ํ…์ŠคํŠธ๋ฅผ ํ‘œ์‹œํ•ฉ๋‹ˆ๋‹ค.

-J=<opt>

[๊ณ ๊ธ‰] ๋ช…๋ น์„ ์‹คํ–‰ํ•˜๋Š” JVM์— ์˜ต์…˜์„ ์ง€์ •ํ•ฉ๋‹ˆ๋‹ค.

(๊ณต๋ฐฑ์„ ํฌํ•จํ•˜๋Š” ์˜ต์…˜์€ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ์ฒ˜๋ฆฌ๋˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ์œผ๋‹ˆ ์ฃผ์˜ํ•˜์„ธ์š”.)

-v, --verbose

์ถœ๋ ฅ๋˜๋Š” ์ง„ํ–‰๋ฅ  ๋ฉ”์‹œ์ง€ ์ˆ˜๋ฅผ ์ ์ง„์ ์œผ๋กœ ๋Š˜๋ฆฝ๋‹ˆ๋‹ค.

-q, --quiet

์ถœ๋ ฅ๋˜๋Š” ์ง„ํ–‰๋ฅ  ๋ฉ”์‹œ์ง€ ์ˆ˜๋ฅผ ์ ์ง„์ ์œผ๋กœ ์ค„์ž…๋‹ˆ๋‹ค.

--verbosity=<level>

[๊ณ ๊ธ‰] ์„ธ๋ถ€ ์ •๋ณด ํ‘œ์‹œ ์ˆ˜์ค€์„ ์˜ค๋ฅ˜, ๊ฒฝ๊ณ , ์ง„ํ–‰๋ฅ , ์ง„ํ–‰๋ฅ +, ์ง„ํ–‰๋ฅ ++, ์ง„ํ–‰๋ฅ +++ ์ค‘ ํ•˜๋‚˜๋กœ ๋ช…์‹œ์ ์œผ๋กœ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. -v ๋ฐ -q๋ฅผ ์žฌ์ •์˜ํ•ฉ๋‹ˆ๋‹ค.

--logdir=<dir>

[๊ณ ๊ธ‰] ํƒ€์ž„์Šคํƒฌํ”„์™€ ์‹คํ–‰ ์ค‘์ธ ํ•˜์œ„ ๋ช…๋ น์˜ ์ด๋ฆ„์„ ํฌํ•จํ•˜๋Š” ์ƒ์„ฑ๋œ ์ด๋ฆ„์„ ์‚ฌ์šฉํ•˜์—ฌ ์ง€์ •๋œ ๋””๋ ‰ํ„ฐ๋ฆฌ์— ์žˆ๋Š” ํ•˜๋‚˜ ์ด์ƒ์˜ ํŒŒ์ผ์— ์ž์„ธํ•œ ๋กœ๊ทธ๋ฅผ ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค.

(๋ชจ๋“  ๊ถŒํ•œ์„ ๊ฐ€์ง„ ์ด๋ฆ„์œผ๋กœ ๋กœ๊ทธ ํŒŒ์ผ์„ ์ž‘์„ฑํ•˜๋ ค๋ฉด --log-to-stderr์„(๋ฅผ) ์ง€์ •ํ•˜๊ณ  stderr๋ฅผ ์›ํ•˜๋Š” ๋Œ€๋กœ ๋ฆฌ๋””๋ ‰์…˜ํ•ฉ๋‹ˆ๋‹ค.)

--common-caches=<dir>

[๊ณ ๊ธ‰] ๋‹ค์šด๋กœ๋“œํ•œ QL ํŒฉ ๋ฐ ์ปดํŒŒ์ผ๋œ ์ฟผ๋ฆฌ ๊ณ„ํš๊ณผ ๊ฐ™์ด ์—ฌ๋Ÿฌ CLI ์‹คํ–‰ ๊ฐ„์— ์œ ์ง€๋˜๋Š” ๋””์Šคํฌ์˜ ์บ์‹œ๋œ ๋ฐ์ดํ„ฐ์˜ ์œ„์น˜๋ฅผ ์ œ์–ดํ•ฉ๋‹ˆ๋‹ค. ๋ช…์‹œ์ ์œผ๋กœ ์„ค์ •ํ•˜์ง€ ์•Š์€ ๊ฒฝ์šฐ ์ด ๊ธฐ๋ณธ๊ฐ’์€ ์‚ฌ์šฉ์ž์˜ ํ™ˆ ๋””๋ ‰ํ„ฐ๋ฆฌ์— ์ด๋ฆ„์ด ์ง€์ •๋œ .codeql ๋””๋ ‰ํ„ฐ๋ฆฌ๋กœ ์„ค์ •๋˜๋ฉฐ, ์•„์ง ์—†๋Š” ๊ฒฝ์šฐ ๋งŒ๋“ค์–ด์ง‘๋‹ˆ๋‹ค.

v2.15.2๋ถ€ํ„ฐ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.