Go Packages kennen keine Versionen und keine Abhängigkeiten. Noch nicht. Mit Go 1.11 und dem experimentellen Support für versionierte Go-Module ändert sich das. Go-Module bringen native Unterstützung für Versionen und Module in Go als festen Bestandteil zur Go Toolchain. Go Modules haben den Anspruch, Communitylösungen wie dep oder glide abzulösen und eine neue einheitliche Lösung zu schaffen. Aber gelingt das auch wirklich? Mal sehen …
Ein Go-Projekt startet mit einem Package. Noch ohne Version und Abhängigkeiten. Die Abhängigkeiten kommen schnell hinzu. Als HTTP-Router nutzen wir das Package github.com/gorilla/mux, also: go get github.com/gorilla/mux. Weil wir XML verarbeiten, noch etree, also go get github.com/beevik/etree. Das Projekt nimmt Fahrt auf, ein neuer Mitarbeiter kommt dazu. Nicht lange, und wir haben Version 1.0.3 in Produktion, und ein ganzes Team entwickelt Version 1.1.0.
Aber was ist jetzt los? Auf einmal schlagen diverse Tests fehl – die XML-Verarbeitung geht nicht mehr! Da hat doch keiner was geändert, oder? Naja, stimmt nicht ganz. Keiner aus dem Team hat etwas geändert, dafür aber die Entwickler von etree. Der letzte Build hat die Abhängigkeit auf etree via go get github.com/beevik/etree heruntergeladen und damit ein geändertes etree Package bekommen. Denn go get lädt immer den aktuellen Stand des Master Branches eines Packages herunter. Mit diesem Stand von etree schlagen die Tests fehl.
Und jetzt? Bleiben zwei Möglichkeiten: Entweder auf einen Fix von etree warten. Oder die vorherige Version von etree verwenden, indem wir etree ins vendor-Verzeichnis (Abschnitt „Vendoring“) packen und einchecken. Mit Go 1.11 kommt eine neue, dritte Möglichkeit dazu, nämlich Go Modules.
Ein erstes Go-Modul
Also drehen wir die Zeit zurück und starten unser Go-Projekt nochmal neu, diesmal mit Go Modules. Ein Go-Modul sind ein oder mehrere Go Packages mit einer Version und Abhängigkeiten zu anderen Modulen. Jedes Modul hat einen eindeutigen Modulpfad. In Go 1.11 sind Modules noch experimentell und müssen mit der Umgebungsvariable GO111MODULE=on aktiviert werden.
Wir starten unser Projekt mit einem Package (github.com/red6/gomod) im GOPATH. Damit aus dem Projekt ein Go-Modul wird, müssen wir es mit go mod init initialisieren. Liegt das Package im GOPATH, übernimmt Go den Importpfad des Packages github.com/red6/gomod als Modulpfad und erzeugt die Datei go.mod. In der Datei go.mod sind der Modulpfad und alle Abhängigkeiten des Moduls hinterlegt. Bis jetzt steht in der go.mod nur module github.com/red6/gomod.
Jetzt kommt die erste Abhängigkeit auf das Package github.com/gorilla/mux, wie gewohnt via go get github.com/gorilla/mux. Aber welche Version haben wir bekommen? In der go.mod steht Version 1.6.2. Aber warum? Go ermittelt die höchste Version des Packages als höchstes Tag nach semantischer Versionierung. Alternativ kann auch explizit eine Version angegeben werden (Tabelle 1). Go hat jetzt noch eine weitere Datei go.sum erzeugt, mit einem Hash des Packages sowie Hashes aller transitiven Abhängigkeiten des Packages. Mit diesem Hash prüft Go, dass jeder zukünftige Build für die angegebene Version des Packages auch denselben Code verwendet. Die heruntergeladenen Abhängigkeiten werden von Go zentral unter $GOPATH/pkg/mod abgelegt und nicht eingecheckt. Das Gorilla Mux Package finden wir dort unter $GOPATH/pkg/mod/github.com/gorilla/[email protected]. Jetzt holen wir uns noch das Package etree via go get github.com/beevik/etree. Die ermittelte Version 1.0.1 wird automatisch in go.mod und go.sum eingetragen. Jetzt noch die Konfigurationsdateien go.mod und go.sum einchecken und fertig ist unser erstes Go-Modul. Um Go Modules besser verstehen zu können, schauen wir uns den Weg zu ihnen näher an.
|
Befehl |
Modulversion |
|---|---|
|
go get github.com/gorilla/mux@latest |
Lädt die aktuellste Modulversion (aktuelles Verhalten von go get) |
|
go get github.com/gorilla/mux@master |
Lädt den Master Branch des Moduls |
|
go get github.com/gorilla/[email protected] |
Lädt Modulversion v1.6.2 über Versionsnummer |
|
go get github.com/gorilla/mux@e3702bed2 |
Lädt Modulversion v1.6.2 über Commit Hash |
|
go get github.com/gorilla/mux@c856192 |
Lädt einen nicht getaggten Stand über Commit Hash und bildet die Pseudoversionsnummer v0.0.0-20180517173623-c85619274f5d |
Tabelle 1: Befehle zum Laden spezifischer Modulversionen
Der Weg zu Go Modules
Am Anfang von Go war der GOPATH, das war 2012. Schnell war klar, dass er in seiner Form ...

