diff options
| author | Gilbert Roulot <groulot@gitlab.com> | 2018-06-06 15:21:06 +0000 |
|---|---|---|
| committer | Olivier Gonzalez <ogonzalez@gitlab.com> | 2018-06-06 15:21:06 +0000 |
| commit | 4d9048a99a9824ab7cb719771699a92c582b5bf2 (patch) | |
| tree | b950fc5b6e4f636208d56280dc03fa5b283ed8b4 /README.md | |
| parent | d706bac7750c57bf9092c9d2c9ef177ff5b8503f (diff) | |
First version
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 48 |
1 files changed, 45 insertions, 3 deletions
@@ -1,7 +1,7 @@ # GitLab License Management -[](https://gitlab.com/gitlab-org/security-products/license_management/commits/master) -[](https://gitlab.com/gitlab-org/security-products/license_management/commits/master) +[](https://gitlab.com/gitlab-org/security-products/license-management/commits/master) +[](https://gitlab.com/gitlab-org/security-products/license-management/commits/master) GitLab tool for detecting licenses of the dependencies used by the provided source. It is currently based on License Finder only, but this may change in the future. @@ -14,11 +14,53 @@ It is currently based on License Finder only, but this may change in the future. ```sh docker run \ --volume "$PWD":/code \ - registry.gitlab.com/gitlab-org/security-products/license_management:latest /code + --rm \ + registry.gitlab.com/gitlab-org/security-products/license-management:latest analyze /code ``` 1. The results will be stored in the `gl-license-management-report.json` file in the application directory. `gl-license-management-report.html` is also available with a human readable report. +## Development + +### Running the application + +License Management is a Docker image, you can build it like any Docker image like so in the +project root: + +```sh +docker build -t license-management . +``` + +You can then run License Management on some target directory: + +```sh +docker run --rm --volume "/path/to/my/project":/code license-management analyze /code +``` + +You can run integration tests on the image like this: + +```sh +docker run --rm license-management /test/test.sh +``` + +## Supported languages and package managers + +The following table shows which languages and package managers are supported. + +| Language | Package managers | +|------------|-------------------------------------------------------------------| +| JavaScript | [Bower](https://bower.io/), [npm](https://www.npmjs.com/) | +| Go | [Godep](https://github.com/tools/godep), go get | +| Java | [Gradle](https://gradle.org/), [Maven](https://maven.apache.org/) | +| .NET | [Nuget](https://www.nuget.org/) | +| Python | [pip](https://pip.pypa.io/en/stable/) | +| Ruby | [gem](https://rubygems.org/) | + + +## Versioning and release process + +Please check the [Release Process documentation](https://gitlab.com/gitlab-org/security-products/release/blob/master/docs/release_process.md). + # Contributing If you want to help, read the [contribution guidelines](CONTRIBUTING.md). |
