robusta

robuste

Juste un simple site Web pour partager des connaissances technologiques. La démo en direct est disponible sur : https://goway.herokuapp.com

Ce projet suit les normes golang/project-layout et peut donc être utilisé comme référence pour les nouveaux développeurs Go.

Notez que ce projet n'est plus en développement actif, mais n'hésitez pas à faire une pull request.

Conditions préalables

Assurez-vous que l'environnement de développement correspond à ces notes ci-dessous afin que nous puissions atténuer tout problème de non-concordance de version.

• Back-end :

  • Allez SDK : 1.13. Assurez-vous de définir correctement $GOROOT et $GOPATH . Vous pouvez vérifier ces variables d'environnement en tapant : go env .
  • MongoDB : 4.1 (dernière version 4.1.8).
  • Aller au module

• L'extrémité avant:

  • NodeJS : 11.10 (dernière version 11.10.0).
  • Utilisez yarn au lieu de npm .
  • Framework : VueJS 2.x (dernière version 2.6.6).
  • Cadre de composants d'interface utilisateur : Element-UI (dernière version 2.5.4).

• Chambre des communes:

  • Système d'exploitation : doit utiliser Linux (la dernière version d'Ubuntu ou la distribution de votre choix) si possible. Windows ne fonctionne pas bien avec Docker et certaines autres technologies que nous pouvons utiliser. Si vous préférez toujours utiliser Windows, vous devrez peut-être résoudre les problèmes vous-même plus tard puisque nous supposons que tout sera développé et exécuté sous Linux.
  • Installez Docker CE (dernière version 18.x) et docker-compose.
  • Installez git pour gérer le code source.
  • IDE de votre choix, Goland ou VS Code recommandé.

Développement

1. Cloner le code en local

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

Après cette étape, le code source doit être disponible sur $GOPATH/src/github.com/pthethanh/robusta .

2. Démarrez l'environnement de développement avec Docker

Vous pouvez utiliser Docker pour démarrer tous les services en même temps. Cela prendra en charge le rechargement automatique pour le frontend et le backend

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

Une fois démarrés, les services seront disponibles sur localhost avec les ports comme ci-dessous :

 MongoDB: 27017
Backend: 8080
Frontend: 8081

Tester l'authentification Google localement

Google ne prend pas en charge OAuth avec localhost ou tout domaine avec port, mais notre serveur fonctionne sur 8080, nous devons donc créer un domaine local nommé mylocalhost.com et nous assurer que toutes les requêtes adressées à ce domaine sont transmises au serveur en cours d'exécution. au port 8080

Les étapes suivantes doivent être effectuées :

1. Mettre à jour iptables

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

2. Mettre à jour /etc/hosts

127.0.0.1 mylocalhost.com

3. Mettez à jour les configurations de Google OAuth2

Assurez-vous que mylocalhost.com est mis à jour dans la console Google. Ajoutez http://mylocalhost.com/auth/google/callback dans les Authorized redirect URIs de l'API de la console Google.

Vérification des performances Web à l'aide de la limite de taille

 make size

Pour plus de détails, voir la limite de taille sur github

Plugins VS Code utiles

• Vetur (octref.vetur)
• Allez (ms-vscode.go)
• format vue (febean.vue-format)
• Vérificateur orthographique du code (streetsidesoftware.code-spell-checker)
• GitLens — Git suralimenté (eamodio.gitlens)
• Docker (ms-azuretools.vscode-docker)

Remarques

• Assurez-vous d'exécuter go fmt , go vet , go test et go build / go install avant de transmettre votre code à Github. Ou vous pouvez simplement exécuter make avant de pousser.
• Ne vous engagez jamais directement à master ou develop des branches (vous n'avez de toute façon pas la permission de le faire). Au lieu de cela, passez de la branche develop à une branche séparée, puis travaillez là-dessus.
  Chaque fois que vous avez terminé votre travail, vous pouvez créer une Pull Request (PR) / Merge Request (MR) pour demander une révision du code et fusionner votre branche pour develop .
  La branche master sera réservée lorsque l'administrateur décidera de publier une version stable de l'application.
• Toutes les documentations doivent être rédigées au format Markdown, il est recommandé d'utiliser Typora comme éditeur Markdown.

Exigences techniques :

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

FAIRE

Besoin d'une mise à jour