Update fuzzit.sh to latest fuzzit; more comments

Made it easier to re-use by defining TARGET variable.

Author: kjk

ci/fuzzit.sh

@@ -12,23 +12,35 @@ fi
 
 if [ -z "${FUZZIT_API_KEY}" ]; then
     echo "Please set env variable FUZZIT_API_KEY to api key for your project"
+    echo "Api key for your account: https://app.fuzzit.dev/orgs/<ACCOUNT>/settings"
     exit 1
 fi
 
 ## Install go-fuzz
 go get -u github.com/dvyukov/go-fuzz/go-fuzz github.com/dvyukov/go-fuzz/go-fuzz-build
 
-## build fuzzer
+## build fuzz target
 go build ./...
-go-fuzz-build -libfuzzer -o fuzzer.a .
-clang -fsanitize=fuzzer fuzzer.a -o fuzzer
 
-wget -q -O fuzzit https://github.com/fuzzitdev/fuzzit/releases/download/v2.4.2/fuzzit_Linux_x86_64
+# target name can only contain lower-case letters (a-z), digits (0-9) and a dash (-)
+TARGET=parse-complex
+
+go-fuzz-build -libfuzzer -o ${TARGET}.a .
+clang -fsanitize=fuzzer ${TARGET}.a -o ${TARGET}
+
+# you can repeat the above for more fuzzing targets
+
+wget -q -O fuzzit https://github.com/fuzzitdev/fuzzit/releases/download/v2.4.12/fuzzit_Linux_x86_64
 chmod a+x fuzzit
+
+# authenticate with fuzzit.dev server using api key from settings panel in the dashboard
 ./fuzzit auth ${FUZZIT_API_KEY}
 
+# create fuzzing target on the server if it doesn't already exist
+./fuzzit create target ${TARGET} || true
+
 if [ $1 == "fuzzing" ]; then
-    ./fuzzit create job --branch $TRAVIS_BRANCH --revision $TRAVIS_COMMIT parse-complex ./fuzzer
+    ./fuzzit create job --branch $TRAVIS_BRANCH --revision $TRAVIS_COMMIT ${TARGET} ./${TARGET}
 else
-    ./fuzzit create job --local parse-complex ./fuzzer
+    ./fuzzit create job --local ${TARGET} ./${TARGET}
 fi