-
Notifications
You must be signed in to change notification settings - Fork 89
fix:codeql full scan #327
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: develop
Are you sure you want to change the base?
fix:codeql full scan #327
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| # Full CodeQL scan config. | ||
| paths-ignore: | ||
| - '**/target/' | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,32 @@ | ||
| #!/bin/bash | ||
|
|
||
| set -euo pipefail | ||
|
|
||
| matrix_entries="" | ||
|
|
||
| has_files() { | ||
| git ls-files "$@" | grep -q . | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win 🔎 Supported by static analysis🏁 Script executed: #!/usr/bin/env bash
set -euo pipefail
repo="$(mktemp -d)"
trap 'rm -rf "$repo"' EXIT
git -C "$repo" init -q
mkdir -p "$repo/src"
for i in $(seq 1 10000); do
: > "$repo/src/CodeQlMatrixProbe${i}.java"
done
git -C "$repo" add .
has_files() {
git -C "$repo" ls-files "$@" | grep -q .
}
if has_files '*.java'; then
echo "Unexpected success: SIGPIPE was not reproduced."
exit 1
fi
echo "Confirmed: pipefail treats the early consumer exit as a failed detection."Repository: opentiny/tiny-engine-backend-java Length of output: 282 🏁 Script executed: #!/usr/bin/env bash
set -u
printf '%s\n' '--- review conventions ---'
find /tmp/coderabbit-repo-knowledge/opentiny-tiny-engine-backend-java-1b9e840d \
-maxdepth 2 -type f -name '*.md' -print -exec sed -n '1,120p' {} \;
printf '%s\n' '--- target script ---'
cat -n .github/scripts/codeql-matrix.sh
printf '%s\n' '--- repository status and relevant references ---'
git diff --stat
rg -n --fixed-strings 'git ls-files' .github . 2>/dev/null | head -80Repository: opentiny/tiny-engine-backend-java Length of output: 2472 Consume the complete With 🤖 Prompt for AI Agents |
||
| } | ||
|
|
||
| add_entry() { | ||
| local entry="$1" | ||
| if [ -n "$matrix_entries" ]; then | ||
| matrix_entries="$matrix_entries,$entry" | ||
| else | ||
| matrix_entries="$entry" | ||
| fi | ||
| } | ||
|
|
||
| if has_files '.github/workflows/*.yml' '.github/workflows/*.yaml'; then | ||
| add_entry '{"language":"actions","build-mode":"none"}' | ||
| fi | ||
|
|
||
| if has_files '*.java'; then | ||
| add_entry '{"language":"java-kotlin","build-mode":"autobuild"}' | ||
| fi | ||
|
|
||
| if has_files '*.js' '*.jsx' '*.ts' '*.tsx' '*.mjs' '*.cjs' '*.vue' '*.html'; then | ||
| add_entry '{"language":"javascript-typescript","build-mode":"none"}' | ||
| fi | ||
|
|
||
| printf '{"include":[%s]}\n' "$matrix_entries" | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| name: CodeQL Full Scan | ||
|
|
||
| on: | ||
| schedule: | ||
| - cron: '42 12 * * 5' | ||
| workflow_dispatch: | ||
|
|
||
| permissions: | ||
| contents: read | ||
| security-events: write | ||
| packages: read | ||
| actions: read | ||
|
|
||
| jobs: | ||
| detect: | ||
| name: Detect CodeQL languages | ||
| runs-on: ubuntu-latest | ||
| outputs: | ||
| matrix: ${{ steps.matrix.outputs.matrix }} | ||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
| with: | ||
| fetch-depth: 0 | ||
|
|
||
| - name: Build matrix | ||
| id: matrix | ||
| shell: bash | ||
| run: | | ||
| matrix=$(bash .github/scripts/codeql-matrix.sh) | ||
| printf 'matrix=%s\n' "$matrix" >> "$GITHUB_OUTPUT" | ||
|
|
||
| analyze: | ||
| needs: detect | ||
| name: Full scan (${{ matrix.language }}) | ||
| runs-on: ubuntu-latest | ||
| strategy: | ||
| fail-fast: false | ||
| matrix: ${{ fromJSON(needs.detect.outputs.matrix) }} | ||
|
|
||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
| with: | ||
| fetch-depth: 0 | ||
|
|
||
| - name: Set up JDK 17 | ||
| if: matrix.language == 'java-kotlin' | ||
| uses: actions/setup-java@v5 | ||
| with: | ||
| java-version: '17' | ||
| distribution: 'temurin' | ||
| cache: maven | ||
|
|
||
| - name: Initialize CodeQL | ||
| uses: github/codeql-action/init@v4 | ||
| with: | ||
| languages: ${{ matrix.language }} | ||
| build-mode: ${{ matrix.build-mode }} | ||
| config-file: ./.github/codeql/codeql-full-config.yml | ||
|
|
||
| - name: Build project | ||
| if: matrix.language == 'java-kotlin' | ||
| run: mvn -B clean test-compile -DskipTests -Dcheckstyle.skip=true -Dpmd.skip=true -Dspotbugs.skip=true -Dcpd.skip=true | ||
|
|
||
| - name: Perform CodeQL Analysis | ||
| uses: github/codeql-action/analyze@v4 | ||
| with: | ||
| category: "/codeql-full:${{ matrix.language }}" |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,102 +1,66 @@ | ||
| # For most projects, this workflow file will not need changing; you simply need | ||
| # to commit it to your repository. | ||
| # | ||
| # You may wish to alter this file to override the set of languages analyzed, | ||
| # or to provide custom queries or build logic. | ||
| # | ||
| # ******** NOTE ******** | ||
| # We have attempted to detect the languages in your repository. Please check | ||
| # the `language` matrix defined below to confirm you have the correct set of | ||
| # supported CodeQL languages. | ||
| # | ||
| name: "CodeQL Advanced" | ||
| name: CodeQL Incremental | ||
|
|
||
| on: | ||
| push: | ||
| branches: [ "develop" ] | ||
| pull_request: | ||
| branches: [ "develop" ] | ||
| schedule: | ||
| - cron: '24 15 * * 1' | ||
|
|
||
| jobs: | ||
| analyze: | ||
| name: Analyze (${{ matrix.language }}) | ||
| # Runner size impacts CodeQL analysis time. To learn more, please see: | ||
| # - https://gh.io/recommended-hardware-resources-for-running-codeql | ||
| # - https://gh.io/supported-runners-and-hardware-resources | ||
| # - https://gh.io/using-larger-runners (GitHub.com only) | ||
| # Consider using larger runners or machines with greater resources for possible analysis time improvements. | ||
| runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }} | ||
| permissions: | ||
| # required for all workflows | ||
| security-events: write | ||
| permissions: | ||
| contents: read | ||
| security-events: write | ||
| packages: read | ||
| actions: read | ||
|
|
||
| # required to fetch internal or private CodeQL packs | ||
| packages: read | ||
| jobs: | ||
| detect: | ||
| name: Detect CodeQL languages | ||
| runs-on: ubuntu-latest | ||
| outputs: | ||
| matrix: ${{ steps.matrix.outputs.matrix }} | ||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
| with: | ||
| fetch-depth: 0 | ||
|
|
||
| # only required for workflows in private repositories | ||
| actions: read | ||
| contents: read | ||
| - name: Build matrix | ||
| id: matrix | ||
| shell: bash | ||
| run: | | ||
| matrix=$(bash .github/scripts/codeql-matrix.sh) | ||
| printf 'matrix=%s\n' "$matrix" >> "$GITHUB_OUTPUT" | ||
|
|
||
| analyze: | ||
| needs: detect | ||
| name: Analyze (${{ matrix.language }}) | ||
| runs-on: ubuntu-latest | ||
| strategy: | ||
| fail-fast: false | ||
| matrix: | ||
| include: | ||
| - language: actions | ||
| build-mode: none | ||
| - language: java-kotlin | ||
| build-mode: autobuild # This mode only analyzes Java. Set this to 'autobuild' or 'manual' to analyze Kotlin too. | ||
| # CodeQL supports the following values keywords for 'language': 'actions', 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'rust', 'swift' | ||
| # Use `c-cpp` to analyze code written in C, C++ or both | ||
| # Use 'java-kotlin' to analyze code written in Java, Kotlin or both | ||
| # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both | ||
| # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis, | ||
| # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning. | ||
| # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how | ||
| # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages | ||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
| matrix: ${{ fromJSON(needs.detect.outputs.matrix) }} | ||
|
|
||
| # Add any setup steps before running the `github/codeql-action/init` action. | ||
| # This includes steps like installing compilers or runtimes (`actions/setup-node` | ||
| # or others). This is typically only required for manual builds. | ||
| # - name: Setup runtime (example) | ||
| # uses: actions/setup-example@v1 | ||
|
|
||
| # Initializes the CodeQL tools for scanning. | ||
| - name: Initialize CodeQL | ||
| uses: github/codeql-action/init@v4 | ||
| with: | ||
| languages: ${{ matrix.language }} | ||
| build-mode: ${{ matrix.build-mode }} | ||
| config-file: ./.github/codeql/codeql-config.yml | ||
| # If you wish to specify custom queries, you can do so here or in a config file. | ||
| # By default, queries listed here will override any specified in a config file. | ||
| # Prefix the list here with "+" to use these queries and those in the config file. | ||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
| with: | ||
| fetch-depth: 0 | ||
|
|
||
| # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs | ||
| # queries: security-extended,security-and-quality | ||
| - name: Set up JDK 17 | ||
| if: matrix.language == 'java-kotlin' | ||
| uses: actions/setup-java@v5 | ||
| with: | ||
| java-version: '17' | ||
| distribution: 'temurin' | ||
| cache: maven | ||
|
|
||
| # If the analyze step fails for one of the languages you are analyzing with | ||
| # "We were unable to automatically build your code", modify the matrix above | ||
| # to set the build mode to "manual" for that language. Then modify this step | ||
| # to build your code. | ||
| # ℹ️ Command-line programs to run using the OS shell. | ||
| # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun | ||
| - name: Run manual build steps | ||
| if: matrix.build-mode == 'manual' | ||
| shell: bash | ||
| run: | | ||
| echo 'If you are using a "manual" build mode for one or more of the' \ | ||
| 'languages you are analyzing, replace this with the commands to build' \ | ||
| 'your code, for example:' | ||
| echo ' make bootstrap' | ||
| echo ' make release' | ||
| exit 1 | ||
| - name: Initialize CodeQL | ||
| uses: github/codeql-action/init@v4 | ||
| with: | ||
| languages: ${{ matrix.language }} | ||
| build-mode: ${{ matrix.build-mode }} | ||
| config-file: ./.github/codeql/codeql-config.yml | ||
|
|
||
| - name: Perform CodeQL Analysis | ||
| uses: github/codeql-action/analyze@v4 | ||
| with: | ||
| category: "/language:${{matrix.language}}" | ||
| - name: Perform CodeQL Analysis | ||
| uses: github/codeql-action/analyze@v4 | ||
| with: | ||
| category: "/codeql-incremental:${{ matrix.language }}" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🎯 Functional Correctness | 🟠 Major | 🏗️ Heavy lift
🔎 Supported by static analysis
🏁 Script executed:
Repository: opentiny/tiny-engine-backend-java
Length of output: 19384
🏁 Script executed:
Repository: opentiny/tiny-engine-backend-java
Length of output: 6174
🌐 Web query:
GitHub CodeQL workflow configuration paths-ignore compiled languages build mode autobuild Java generated sources💡 Result:
In GitHub CodeQL, handling generated sources and ignoring specific paths in compiled languages (such as Java) differs significantly depending on the chosen build mode. The standard
pathsandpaths-ignoreworkflow configuration filters (used foron:pull_requestandon:push) only control when a workflow is triggered; they do not instruct the CodeQL extractor to ignore files during the analysis build process [1][2]. Build Modes and Generated Sources For compiled languages, CodeQL analyzes all code built during the workflow execution [2]. Consequently, if you usebuild-mode: autobuildorbuild-mode: manual, the resulting CodeQL database will include any generated sources that were compiled by your build system [3][2]. 1. If usingbuild-mode: autobuild: The autobuilder automatically detects and runs your build system (e.g., Maven, Gradle) [4][5]. Because it executes the entire build process, it inherently includes all generated code [2]. To ignore specific paths, you must transition away from autobuild to a manual build [6][2]. 2. If usingbuild-mode: manual: This is the recommended approach for excluding generated sources [2]. You must explicitly define your build steps in the workflow using a run block [7][3]. By crafting your build commands to avoid compiling the generated source directories, you effectively prevent those files from being included in the CodeQL database [6][2]. 3. If usingbuild-mode: none: For Java, you can choosebuild-mode: noneto generate a database directly from the source code without building [3][5]. In this specific mode, you can utilize CodeQL configuration files to applypathsandpaths-ignorefilters to restrict which files are extracted for analysis [1][2]. Note that this mode is best suited for scenarios where a build is not strictly required for accurate analysis [3]. Summary of Recommendations - For Projects with Complex Builds: Replaceautobuildwithmanualbuild steps and ensure your build commands explicitly exclude generated source directories [2]. - For Projects where a Build is Unnecessary: Switch tobuild-mode: noneto leverage configuration-based file filtering [1][3]. - Trigger Control vs. Analysis Control: Ensure you distinguish between workflow trigger filters (at the top level of the YAML) and analysis extraction filters (available fornonebuild mode or through custom build commands) [1][2].Citations:
Exclude generated Java sources through the build, not
paths-ignore. The full matrix usesbuild-mode: autobuild, and the workflow compiles the Maven project withmvn ... test-compile. CodeQL can include generated sources compiled during built-language analysis. Iftarget/**contains generated Java sources that must be excluded, use a build configuration that omits them.🤖 Prompt for AI Agents