|
1 |
| -# FOSSA's new container scanner |
| 1 | +# FOSSA's container scanner |
2 | 2 |
|
3 |
| -- [FOSSA's new container scanner](#fossas-new-container-scanner) |
| 3 | +- [FOSSA's container scanner](#fossas-new-container-scanner) |
4 | 4 | - [What's new in this scanner?](#whats-new-in-this-scanner)
|
5 | 5 | - [Documentation](#documentation)
|
6 | 6 | - [Container image source](#container-image-source)
|
|
21 | 21 | - [How do I exclude specific projects from container scanning?](#how-do-i-exclude-specific-projects-from-container-scanning)
|
22 | 22 | - [Limitations & Workarounds](#limitations--workarounds)
|
23 | 23 |
|
24 |
| -## What's new in this scanner? |
| 24 | +## What's supported in FOSSA's container scanner? |
25 | 25 |
|
26 |
| -FOSSA's new container scanner adds support for compliance and vulnerability checks for application dependencies inside of containers. |
| 26 | +FOSSA's container scanner adds support for compliance and vulnerability checks for application dependencies inside of containers. |
27 | 27 | The performance of analysis and support for container image sources is improved, and is more robust for future enhancement.
|
28 | 28 |
|
29 |
| -FOSSA's new container scanner brings support for standard FOSSA CLI features into containers: |
| 29 | +FOSSA's container scanner brings support for standard FOSSA CLI features into containers: |
30 | 30 | - Support for configuration via `.fossa.yml`.
|
31 | 31 | - Support for path filtering (exclusion and inclusion).
|
32 | 32 |
|
33 |
| -Finally, FOSSA's new container scanner improves the user experience and reports more information to FOSSA servers, |
34 |
| -improving both the information available to users and the ability for FOSSA to debug questions or issues. |
35 |
| -For example, images scanned with the container scanner show the origin path for each dependency discovered inside the image, just like analysis of a local project. |
36 |
| - |
37 |
| -Like the legacy container scanner, the container scanner fully supports the detection of OS dependencies (`apk`, `deb`, etc). |
| 33 | +The container scanner fully supports the detection of OS dependencies (`apk`, `deb`, etc). |
38 | 34 |
|
39 | 35 | Refer to following guides for integrating container scanning in your CI,
|
40 | 36 |
|
41 | 37 | - [Walthrough: Integrating in Generic CI](./../../../walkthroughs/container-scanning-generic-ci.md)
|
42 | 38 |
|
43 | 39 | # Documentation
|
44 | 40 |
|
45 |
| -FOSSA's new container scanner scans the base layer of the image, squashes all other layers, and scans those as well. |
| 41 | +FOSSA's container scanner scans the base layer of the image, squashes all other layers, and scans those as well. |
46 | 42 | Scans report compliance and security issues for operating system dependencies and application dependencies.
|
47 | 43 |
|
48 | 44 | To scan a container image with `fossa-cli`, use the `container analyze` command:
|
@@ -203,7 +199,7 @@ All `GET` request from step 2 to step 5, will make `HEAD` call prior to confirm
|
203 | 199 |
|
204 | 200 | ## Container image analysis
|
205 | 201 |
|
206 |
| -The new container scanner scans in two steps: |
| 202 | +The container scanner scans in two steps: |
207 | 203 | 1. The base layer.
|
208 | 204 | 2. The rest of the layers, squashed.
|
209 | 205 |
|
@@ -289,7 +285,7 @@ Example output:
|
289 | 285 |
|
290 | 286 | ### Utilize analysis target configuration
|
291 | 287 |
|
292 |
| -The new container scanner supports configuring analysis targets via `.fossa.yml`, as with a standard `fossa analyze` command. |
| 288 | +The container scanner supports configuring analysis targets via `.fossa.yml`, as with a standard `fossa analyze` command. |
293 | 289 | For more information on configuring analysis targets, see [analysis target configuration](../../files/fossa-yml.md#analysis-target-configuration).
|
294 | 290 |
|
295 | 291 | For example, the following `fossa.yml` excludes all `setuptools` targets:
|
@@ -366,7 +362,7 @@ fossa container analyze <IMAGE> -c .fossa.config.yaml --output
|
366 | 362 |
|
367 | 363 | ## Limitations & Workarounds
|
368 | 364 |
|
369 |
| -`fossa-cli` using the container scanner does not support [v1 docker manifest format](https://docs.docker.com/registry/spec/manifest-v2-1/). |
| 365 | +`fossa-cli` does not support [v1 docker manifest format](https://docs.docker.com/registry/spec/manifest-v2-1/). |
370 | 366 | This manifest format is officially deprecated, but is still found in some registries.
|
371 | 367 |
|
372 | 368 | The recommended workaround is to export the image to an archive, then analyze that:
|
|
0 commit comments