Vuls Docker components

This is the Git repo of the official Docker image for vuls.

Supported tags and respective `Dockerfile` links

go-cve-dictionary
- latest (go-cve-dictionary:latest Dockerfile)
vuls
- latest (vuls:latest Dockerfile)
vulsrepo
- latest (vulsrepo:latest Dockerfile)

This image version is same as the github repository version.

How to use this image

fetch nvd (vuls/go-cve-dictionary)
configuration (vuls/vuls)
prepare (vuls/vuls)
scan (vuls/vuls)
vulsrepo (vuls/vulsrepo)

Step1. Fetch NVD

$ for i in {2002..2016}; do \
    docker run --rm -it \
    -v $PWD:/vuls  vuls/go-cve-dictionary fetchnvd -years $i; \
  done

Step2. Configuration

Create config.toml referring to this.

[servers]

[servers.amazon]
host         = "54.249.93.16"
port        = "22"
user        = "vuls-user"
keyPath     = "/root/.ssh/id_rsa" # path to ssh private key in docker

$ docker run --rm \
    -v ~/.ssh:/root/.ssh:ro \
    -v $PWD:/vuls \
    vuls/vuls configtest \
    -config=./config.toml # path to config.toml in docker

Step3. Prepare

$ docker run --rm \
    -v ~/.ssh:/root/.ssh:ro \
    -v $PWD:/vuls \
    vuls/vuls prepare \
    -config=./config.toml # path to config.toml in docker

Step4. Scan

$ docker run --rm -it \
    -v ~/.ssh:/root/.ssh:ro \
    -v $PWD:/vuls \
    -v /etc/localtime:/etc/localtime:ro \
    -e "TZ=Asia/Tokyo" \
    vuls/vuls scan \
    -cve-dictionary-dbpath=/vuls/cve.sqlite3 \
    -config=./config.toml \ # path to config.toml in docker
    -report-json

Step5. vulsrepo

$docker run -dt \
    -v $PWD:/vuls \
    -p 80:80 \
    vuls/vulsrepo

User Feedback

Documentation

Documentation for this image is stored in the docker/ directory of the future-architect/vuls GitHub repo.

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

Contributing

fork a repository: github.com/future-architect/vuls to github.com/you/repo
get original code: go get github.com/future-architect/vuls
work on original code
add remote to your repo: git remote add myfork https://github.com/you/repo.git
push your changes: git push myfork
create a new Pull Request

2.4 KiB Raw Blame History Unescape Escape