robusta

Robusta

Nur eine einfache Website zum Austausch von Technologiewissen. Eine Live-Demo ist verfügbar unter: https://goway.herokuapp.com

Dieses Projekt folgt Golang-Standards/Projektlayout und kann daher als Referenz für neue Go-Entwickler verwendet werden.

Beachten Sie , dass sich dieses Projekt derzeit nicht mehr in der aktiven Entwicklung befindet. Sie können jedoch jederzeit eine Pull-Anfrage stellen.

Voraussetzungen

Stellen Sie sicher, dass die Entwicklungsumgebung mit den folgenden Hinweisen übereinstimmt, damit wir etwaige Probleme aufgrund von Versionskonflikten abmildern können.

• Backend:

  • Go SDK: 1.13. Stellen Sie sicher, dass $GOROOT und $GOPATH richtig eingestellt sind. Sie können diese Umgebungsvariablen überprüfen, indem Sie Folgendes eingeben: go env .
  • MongoDB: 4.1 (neueste Version 4.1.8).
  • Go-Modul

• Frontend:

  • NodeJS: 11.10 (neueste Version 11.10.0).
  • Verwenden Sie yarn anstelle von npm .
  • Framework: VueJS 2.x (neueste Version 2.6.6).
  • UI-Komponenten-Framework: Element-UI (neueste Version 2.5.4).

• Commons:

  • Betriebssystem: Sollte nach Möglichkeit Linux (neuestes Ubuntu oder die Distribution Ihrer Wahl) verwenden. Windows funktioniert nicht gut mit Docker und einigen anderen Technologien, die wir möglicherweise verwenden. Wenn Sie weiterhin lieber Windows verwenden, müssen Sie die Probleme möglicherweise später selbst bewältigen, da wir davon ausgehen, dass alles unter Linux entwickelt und ausgeführt wird.
  • Installieren Sie Docker CE (neueste Version 18.x) und Docker-Compose.
  • Installieren Sie Git, um den Quellcode zu verwalten.
  • IDE Ihrer Wahl, empfohlen Goland oder VS Code .

Entwicklung

1. Code auf lokal klonen

$ go get -u -v github.com/pthethanh/robusta
or
$ cd $GOPATH /src
$ git clone https://github.com/pthethanh/robusta.git

Nach diesem Schritt muss der Quellcode unter $GOPATH/src/github.com/pthethanh/robusta verfügbar sein.

2. Entwicklungsumgebung mit Docker starten

Mit Docker können Sie alle Dienste auf einmal starten. Dadurch wird das automatische Neuladen sowohl für das Frontend als auch für das Backend unterstützt

$ cd /web && yarn install && cd ../
$ make compose_dev

Nach dem Start sind die Dienste bei localhost mit den folgenden Ports verfügbar:

 MongoDB: 27017
Backend: 8080
Frontend: 8081

Testen Sie die Google-Authentifizierung lokal

Google unterstützt kein OAuth mit localhost oder einer Domäne mit Port, aber unser Server läuft auf 8080, daher müssen wir eine lokale Domäne namens mylocalhost.com erstellen und sicherstellen, dass alle Anfragen an diese Domäne an den laufenden Server weitergeleitet werden am Port 8080

Folgende Schritte müssen durchgeführt werden :

1. Aktualisieren Sie iptables

sudo iptables -t nat -I OUTPUT -p tcp -d 127.0.0.1 --dport 80 -j REDIRECT --to-ports 8080

2. Aktualisieren Sie /etc/hosts

127.0.0.1 mylocalhost.com

3. Aktualisieren Sie die Google OAuth2-Konfigurationen

Stellen Sie sicher, dass mylocalhost.com in der Google Console aktualisiert ist. Fügen Sie http://mylocalhost.com/auth/google/callback zu den Authorized redirect URIs der Google Console API hinzu

Überprüfung der Webleistung mithilfe der Größenbeschränkung

 make size

Weitere Einzelheiten finden Sie unter Größenbeschränkung auf Github

Nützliche VS-Code-Plugins

• Vetur (octref.vetur)
• Los (ms-vscode.go)
• Vue-Format (febean.vue-Format)
• Code-Rechtschreibprüfung (streetsidesoftware.code-spell-checker)
• GitLens – Git supercharged (eamodio.gitlens)
• Docker (ms-azuretools.vscode-docker)

Notizen

• Stellen Sie sicher, dass Sie go fmt , go vet , go test und go build / go install ausführen, bevor Sie Ihren Code an Github übertragen. Oder Sie können einfach make ausführen, bevor Sie pushen.
• Verpflichten Sie sich niemals direkt dazu, Zweige zu master oder develop (Sie haben dazu sowieso keine Berechtigung). Wechseln Sie stattdessen vom develop zu einem separaten Zweig und arbeiten Sie dann daran.
  Sobald Sie mit Ihrer Arbeit fertig sind, können Sie einen Pull Request (PR) / Merge Request (MR) erstellen, um eine Codeüberprüfung und das Zusammenführen Ihres Zweigs für develop anzufordern.
  Der master wird reserviert, wenn der Administrator beschließt, eine stabile Version der Anwendung zu veröffentlichen.
• Alle Dokumentationen müssen im Markdown-Format verfasst sein, empfohlen wird die Verwendung von Typora als Markdown-Editor.

Technische Anforderungen:

Farbe: https://www.colourlovers.com/palette/173625/Browser_wars

TODO

Muss aktualisiert werden