From f524c8e8ab1ef3d5901dfc460808a891c7f01d04 Mon Sep 17 00:00:00 2001 From: mo khan Date: Tue, 10 Nov 2020 14:42:05 -0700 Subject: docs: add a getting started section to the README --- README.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8dfd028..d53c67b 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,27 @@ only, but this may change in the future. ## Development +### Getting Started + +Install [Docker](https://docs.docker.com/engine/installation/). + +```sh +$ git clone git@gitlab.com:gitlab-org/security-products/analyzers/license-finder.git +$ cd license-finder +``` + +Download the latest version of the Docker image. + +```sh +$ ./bin/docker-pull +``` + +Launch a shell in the Docker container. + +```sh +$ ./bin/docker-shell +``` + ### Running the application License Management is a Docker image. You can build it like this from the project root: @@ -42,7 +63,6 @@ $ docker run --rm --volume "/path/to/my/project":/code --env CI_PROJECT_DIR=/cod You can run the tests from inside a docker container: ```sh -$ ./bin/docker-build $ ./bin/docker-shell $ ./bin/setup $ ./bin/test [path to file] @@ -52,7 +72,6 @@ If you need to debug any specific issues you can do this from within the docker following these steps: ```sh -$ ./bin/docker-build $ ./bin/docker-shell $ enable_dev_mode $ bundle open license_finder @@ -80,7 +99,7 @@ The following table shows which languages and package managers are supported. | .NET | [.NET Core CLI][dotnet_core], [Nuget][nuget] | | C/C++ | [Conan][conan] | | Go | [Go modules][gomod], [Godep][godep], go get | -| Java | [Gradle][gradle], [Maven v3.2.5+)][maven] | +| Java | [Gradle][gradle], [Maven v3.2.5+][maven] | | JavaScript | [npm][npm], [yarn][yarn], [Bower][bower] | | PHP | [composer][composer] | | Python | [pip][pip], [pipenv][pipenv] | -- cgit v1.2.3