@@ -31,7 +31,6 @@ cat results/issues.sarif-latest| jq '.runs[].results'
3131# with custom format and output
3232./scripts/run.py -l javascript -s /tmp/cc/code-scanning-javascript-demo --format=csv -o sample
3333# your output will be store at sample/issues.csv
34-
3534```
3635
3736### Run with docker command
@@ -41,12 +40,15 @@ With `/tmp/src` is your source code and `/tmp/results` is where result store.
4140> NOTE: make sure /tmp/results folder exist otherwise it won't work
4241
4342``` shell
44- # simple usage
43+ # simple usage which will run the QL Packs of that language
4544docker run --rm --name codeql-docker -v " /tmp/src:/opt/src" -v " /tmp/results:/opt/results" -e " LANGUAGE=go" j3ssie/codeql-docker:latest
4645
47- # more options
46+ # Run with specific Queries Suite and different output format
4847docker run --rm --name codeql-docker -v " /tmp/src:/opt/src" -v " /tmp/results:/opt/results" -e " LANGUAGE=javascript" -e " FORMAT=csv" -e " QS=javascript-security-and-quality.qls" j3ssie/codeql-docker:latest
4948
49+ # Override the source code DB tree
50+ docker run --rm --name codeql-docker -v " /tmp/src:/opt/src" -v " /tmp/results:/opt/results" -e " LANGUAGE=javascript" -e " FORMAT=csv" -e " QS=javascript-security-and-quality.qls" -e " OVERRIDE=True" j3ssie/codeql-docker:latest
51+
5052```
5153
5254### Manual analyze
@@ -58,12 +60,16 @@ docker run -it --entrypoint=/bin/bash -t j3ssie/codeql-docker:latest
5860# Copy your code to container
5961docker cp < your-source-cde> < docker-ID> :/opt/src
6062
61- # create DB in this folder /opt/src/db
62- # This might take a while depend on your code
63+ # You use the helper scripts to run CodeQL
64+ python3 analyze.py -d /opt/src/db -s /opt/src/ -l javascript --override=True
65+
66+ # Or using raw command from codeQL
67+ # # create DB in this folder /opt/src/db
68+ # # This might take a while depend on your code
6369codeql database create --language=< language> /opt/src/db -s /opt/src
6470
65- # run analyze
66- # normally query-suites will will be: <language>-security-and-quality.qls
71+ # # run analyze
72+ # # normally query-suites will will be: <language>-security-and-quality.qls
6773codeql database analyze --format=sarif-latest --output=/opt/issues.sarif /opt/src/db < query-suites>
6874
6975# copy the result back to host machine
@@ -73,12 +79,17 @@ docker cp <docker-ID>:/opt/issues.sarif .
7379### Other commands
7480
7581``` shell
82+ # List all query packs
83+ codeql resolve qlpacks --format=json | jq -r ' keys[]'
84+
7685# List all query suites
7786codeql resolve queries
7887
7988# Upgrade DB
8089codeql database upgrade < database>
8190
91+ # Building the base image
92+ docker build -f base-image-Dockerfile -t j3ssie/codeql-base:latest .
8293```
8394
8495## Donation
0 commit comments