Skip to main content
Version: Config V2

GitHub Action - Scan your code for feature flag usages

ConfigCat's GitHub Action has the ability to scan your source code for feature flag and setting usages and upload the found code references to ConfigCat.

This feature makes the elimination of the technical debt easier, as it can show which repositories reference your feature flags and settings in one centralized place on your Dashboard.

Here you can find more details about how this feature works.

This section describes how to use ConfigCat's GitHub Action to automatically scan your source code for feature flag and setting usages and upload the found code references to ConfigCat. You can find more information about GitHub Actions here.

Setup

  1. Create a new ConfigCat Management API credential and store its values in your repository's GitHub Secrets with the following names: CONFIGCAT_API_USER, CONFIGCAT_API_PASS.

    Github Action secrets
  2. Get your selected Config's ID.

  3. Create a new Actions workflow in your GitHub repository under the .github/workflows folder, and put the following snippet into it. Don't forget to replace the PASTE-YOUR-CONFIG-ID-HERE value with your actual Config ID.

    on: [push]
    name: Code references
    jobs:
    scan-repo:
    runs-on: ubuntu-latest
    name: Scan repository for code references
    steps:
    - name: Checkout
    uses: actions/checkout@v3
    - name: Scan & upload
    uses: configcat/scan-repository@v2
    with:
    api-user: ${{ secrets.CONFIGCAT_API_USER }}
    api-pass: ${{ secrets.CONFIGCAT_API_PASS }}
    config-id: PASTE-YOUR-CONFIG-ID-HERE
    # line-count: 5 # optional
    # sub-folder: src # optional
    # exclude-keys: > # optional
    # flag_key_to_exclude_1
    # flag_key_to_exclude_2
    # alias-patterns: (\w+) = :CC_KEY,const (\w+) = feature_flags\.enabled\(:CC_KEY\) #optional
    # usage-patterns: feature_flags\.enabled\(:CC_KEY\) # optional, comma delimited flag key usage patterns
    # verbose: true # optional
  4. Commit & push your action.

The above example configures a workflow that executes the scan and code references upload on every git push event. Scan reports are uploaded for each branch of your repository that triggers the workflow.

Available Options

ParameterDescriptionRequiredDefault
config-idID of the ConfigCat config to scan against.
api-userConfigCat Management API basic authentication username.
api-passConfigCat Management API basic authentication password.
api-hostConfigCat Management API host.api.configcat.com
line-countContext line count before and after the reference line. (min: 1, max: 10)4
sub-folderSub-folder to scan, relative to the repository root folder.
exclude-keysList of feature flag keys that must be excluded from the scan report.
alias-patternsComma delimited list of custom regex patterns used to search for additional aliases.
usage-patternsComma delimited list of custom regex patterns that describe additional feature flag key usages.
verboseTurns on detailed logging.false