11# ` @nexB/scancode-action `
22
3- Run [ ScanCode.io] ( https://github.com/nexB/scancode.io ) pipelines from your Workflows.
4-
5- > [ !IMPORTANT]
6- > The scancode-action is currently in the ** alpha stage** , and we invite you to
7- > contribute to its improvement. Please feel free to submit bug reports or share
8- > your ideas by creating new entries in the "Issues" section.
9- > Your collaboration helps us enhance the action and ensures a more stable and
10- > effective tool for the community.
11- > Thank you for your support!
12-
13- - [ Usage] ( #usage )
14- - [ Basic] ( #basic )
15- - [ Inputs] ( #inputs )
16- - [ Examples] ( #examples )
17- - [ Scan repo codebase] ( #scan-repo-codebase )
18- - [ Run a specific pipeline] ( #run-a-specific-pipeline )
19- - [ Run multiple pipelines] ( #run-multiple-pipelines )
20- - [ Choose the output formats] ( #choose-the-output-formats )
21- - [ Provide download URLs inputs] ( #provide-download-urls-inputs )
22- - [ Fetch pipelines inputs] ( #fetch-pipelines-inputs )
23- - [ Define a custom project name] ( #define-a-custom-project-name )
24- - [ Where does the scan results go?] ( #where-does-the-scan-results-go )
3+ Run [ ScanCode.io] ( https://github.com/aboutcode-org/scancode.io ) pipelines from
4+ your Workflows.
5+
6+ > [ !IMPORTANT] The scancode-action is currently in the ** alpha stage** , and we
7+ > invite you to contribute to its improvement. Please feel free to submit bug
8+ > reports or share your ideas by creating new entries in the "Issues" section.
9+ > Your collaboration helps us enhance the action and ensures a more stable and
10+ > effective tool for the community. Thank you for your support!
11+
12+ - [ Usage] ( #usage )
13+ - [ Basic] ( #basic )
14+ - [ Inputs] ( #inputs )
15+ - [ Examples] ( #examples )
16+ - [ Scan repo codebase] ( #scan-repo-codebase )
17+ - [ Run a specific pipeline] ( #run-a-specific-pipeline )
18+ - [ Run multiple pipelines] ( #run-multiple-pipelines )
19+ - [ Choose the output formats] ( #choose-the-output-formats )
20+ - [ Provide download URLs inputs] ( #provide-download-urls-inputs )
21+ - [ Fetch pipelines inputs] ( #fetch-pipelines-inputs )
22+ - [ Define a custom project name] ( #define-a-custom-project-name )
23+ - [ Where does the scan results go?] ( #where-does-the-scan-results-go )
2524
2625## Usage
2726
2827### Basic
2928
3029``` yaml
3130steps :
32- - uses : actions/checkout@v4
33- with :
34- path : scancode-inputs
35- - uses : nexB/scancode-action@alpha
36- with :
37- pipelines : " scan_codebase"
38- output-formats : " json xlsx spdx cyclonedx"
31+ - uses : actions/checkout@v4
32+ with :
33+ path : scancode-inputs
34+ - uses : nexB/scancode-action@alpha
35+ with :
36+ pipelines : ' scan_codebase'
37+ output-formats : ' json xlsx spdx cyclonedx'
3938` ` `
4039
4140### Inputs
4241
4342` ` ` yaml
4443- uses : nexB/scancode-action@alpha
4544 with :
46- # Names of the pipelines (comma-separated) and in order.
47- # Default is 'scan_codebase'
48- pipelines :
45+ # Names of the pipelines (comma-separated) and in order.
46+ # Default is 'scan_codebase'
47+ pipelines :
4948
50- # The list of output formats to generate.
51- # Default is 'json xlsx spdx cyclonedx'
52- output-formats :
49+ # The list of output formats to generate.
50+ # Default is 'json xlsx spdx cyclonedx'
51+ output-formats :
5352
54- # Relative path within the $GITHUB_WORKSPACE for pipeline inputs.
55- # Default is 'scancode-inputs'
56- inputs-path :
53+ # Relative path within the $GITHUB_WORKSPACE for pipeline inputs.
54+ # Default is 'scancode-inputs'
55+ inputs-path :
5756
58- # Provide one or more URLs to download for the pipeline run execution
59- input-urls :
57+ # Provide one or more URLs to download for the pipeline run execution
58+ input-urls :
6059
61- # Name of the project.
62- # Default is 'scancode-action'
63- project-name :
60+ # Name of the project.
61+ # Default is 'scancode-action'
62+ project-name :
6463
65- # Name of the outputs archive.
66- # Default is 'scancode-outputs'
67- outputs-archive-name :
64+ # Name of the outputs archive.
65+ # Default is 'scancode-outputs'
66+ outputs-archive-name :
6867
69- # Python version that will be installed to run ScanCode.io
70- # Default is '3.11'
71- python-version :
68+ # Python version that will be installed to run ScanCode.io
69+ # Default is '3.11'
70+ python-version :
7271` ` `
7372
7473## Examples
7574
76- See https://github.com/nexB /scancode-action/tree/main/.github/workflows for Workflows
77- examples.
75+ See https://github.com/aboutcode-org /scancode-action/tree/main/.github/workflows
76+ for Workflows examples.
7877
7978### Scan repo codebase
8079
8180` ` ` yaml
8281steps :
83- - uses : actions/checkout@v4
84- with :
85- path : scancode-inputs
86- - uses : nexB/scancode-action@alpha
82+ - uses : actions/checkout@v4
83+ with :
84+ path : scancode-inputs
85+ - uses : nexB/scancode-action@alpha
8786` ` `
8887
8988### Run a specific pipeline
@@ -93,70 +92,70 @@ steps:
9392` ` ` yaml
9493- uses : nexB/scancode-action@alpha
9594 with :
96- pipelines : " scan_codebase"
95+ pipelines : ' scan_codebase'
9796` ` `
9897
9998### Run multiple pipelines
10099
101100` ` ` yaml
102101- uses : nexB/scancode-action@alpha
103102 with :
104- pipelines : " scan_codebase,find_vulnerabilities"
103+ pipelines : ' scan_codebase,find_vulnerabilities'
105104 env :
106- VULNERABLECODE_URL : https://public.vulnerablecode.io/
105+ VULNERABLECODE_URL : https://public.vulnerablecode.io/
107106` ` `
108107
109108#### Configuring ` find_vulnerabilities` Pipeline
110109
111- The `find_vulnerabilities` pipeline requires access to a VulnerableCode instance,
112- which can be defined using the `VULNERABLECODE_URL` environment variable.
110+ The `find_vulnerabilities` pipeline requires access to a VulnerableCode
111+ instance, which can be defined using the `VULNERABLECODE_URL` environment
112+ variable.
113113
114- In the example provided, a public instance is referenced.
115- However, you also have the option to run your own VulnerableCode instance.
116- For details on setting up and configuring your own instance, please refer to the
114+ In the example provided, a public instance is referenced. However, you also have
115+ the option to run your own VulnerableCode instance. For details on setting up
116+ and configuring your own instance, please refer to the
117117[VulnerableCode documentation](https://vulnerablecode.readthedocs.io/en/latest/index.html).
118118
119119# ## Choose the output formats
120120
121121` ` ` yaml
122122- uses: nexB/scancode-action@alpha
123123 with:
124- output-formats: " json xlsx spdx cyclonedx"
124+ output-formats: ' json xlsx spdx cyclonedx'
125125` ` `
126126
127127# ## Provide download URLs inputs
128128
129129` ` ` yaml
130130- uses: nexB/scancode-action@alpha
131131 with:
132- pipelines: "map_deploy_to_develop"
133- input-urls:
134- https://domain.url/source.zip#from
135- https://domain.url/binaries.zip#to
132+ pipelines: 'map_deploy_to_develop'
133+ input-urls:
134+ https://domain.url/source.zip#from https://domain.url/binaries.zip#to
136135` ` `
137136
138137# ## Fetch pipelines inputs
139138
140139` ` ` yaml
141140- name: Download repository archive to scancode-inputs/ directory
142141 run: |
143- wget --directory-prefix=scancode-inputs https://github.com/${GITHUB_REPOSITORY}/archive/${GITHUB_REF}.zip
142+ wget --directory-prefix=scancode-inputs https://github.com/${GITHUB_REPOSITORY}/archive/${GITHUB_REF}.zip
144143- uses: nexB/scancode-action@alpha
145144 with:
146- pipelines: " scan_single_package"
145+ pipelines: ' scan_single_package'
147146` ` `
148147
149148# ## Define a custom project name
150149
151150` ` ` yaml
152151- uses: nexB/scancode-action@alpha
153152 with:
154- project-name: " my-project-name"
153+ project-name: ' my-project-name'
155154` ` `
156155
157156# # Where are the Scan Results?
158157
159- Upon completion of the workflow, you can **find the scan results** in the dedicated
160- **artifacts section** at the bottom of the workflow summary page.
161- Look for a file named `scancode-outputs` in that section.
162- This file contains the outputs generated by the `scancode-action`.
158+ Upon completion of the workflow, you can **find the scan results** in the
159+ dedicated **artifacts section** at the bottom of the workflow summary page. Look
160+ for a file named `scancode-outputs` in that section. This file contains the
161+ outputs generated by the `scancode-action`.
0 commit comments