Import Wharf projects from GitLab repositories. Mainly focused on importing from self hosted GitLab CE instances, importing from gitlab.com is not well tested.
HTTP API using the gin-gonic/gin web framework.
Swagger documentation generated using swaggo/swag and hosted using swaggo/gin-swagger
GitLab API access using xanzy/go-gitlab
The wharf-provider-gitlab program can be configured via environment variables
and through optional config files. See the docs on the Config
type over at:
https://pkg.go.dev/github.com/iver-wharf/wharf-provider-gitlab#Config
Install Go 1.18 or later: https://golang.org/
Install dependencies using GNU Make or GNUWin32
$ make deps
Generate the Swagger files (this has to be redone each time the swaggo documentation comments has been altered):
$ make swag
Start hacking with your favorite tool. For example VS Code, GoLand, Vim, Emacs, or whatnot.
Replace the "v2.0.0" in make docker version=v2.0.0
with the new version. Full
documentation can be found at Releasing a new version.
Below are just how to create the Docker images using GNU Make or GNUWin32:
$ make docker version=v2.0.0
STEP 1: FROM golang:1.18 AS build
STEP 2: WORKDIR /src
--> Using cache de3476fd68836750f453d9d4e7b592549fa924c14e68c9b80069881de8aacc9b
--> de3476fd688
STEP 3: ENV GO111MODULE=on
--> Using cache 4f47a95d0642dcaf5525ee1f19113f97911b1254889c5f2ce29eb6f034bd550b
--> 4f47a95d064
STEP 4: RUN go install github.com/swaggo/swag/cmd/swag@v1.8.1
...
Push the image by running:
docker push quay.io/iver-wharf/wharf-provider-gitlab:latest
docker push quay.io/iver-wharf/wharf-provider-gitlab:v2.0.0
make deps # download linting dependencies
make lint
make lint-go # only lint Go code
make lint-md # only lint Markdown files
Some errors can be fixed automatically. Keep in mind that this updates the files in place.
make lint-fix
make lint-fix-go # only lint and fix Go files
make lint-fix-md # only lint and fix Markdown files
Maintained by Iver. Licensed under the MIT license.