Loslegen - Archi-Lab/prox-documentation GitHub Wiki

Da die Prox-Plattform als Microservice-Architektur aufgesetzt ist, und jeder Microservice ein eigenes Repository besitzt, gibt es mittlerweile einige Repositories.

Prox-Repositories

• prox-project-service
• prox-module-service
• prox-web-client
• prox-service-discovery
• prox-api-gateway
• prox-proposal-service
• prox-tag-service

Projekte auschecken

Um die Übersicht zu behalten, empfehlen wir ein eigenes Verzeichnis für die verschiedenen Checkouts zu erstellen:

mkdir prox
cd prox/

In diesem Verzeichnis clonen wir uns nun alle Repositories. Die nachfolgenden Snippets kann man je nach Kommandozeile Copy&Paste (gesamter Block!) übernehmen und ausführen.

master Branch mit PowerShell

git clone https://github.com/Archi-Lab/prox-project-service.git;`
git clone https://github.com/Archi-Lab/prox-module-service.git;`
git clone https://github.com/Archi-Lab/prox-web-client.git;`
git clone https://github.com/Archi-Lab/prox-service-discovery.git;`
git clone https://github.com/Archi-Lab/prox-api-gateway.git;`
git clone https://github.com/Archi-Lab/prox-proposal-service.git;`
git clone https://github.com/Archi-Lab/prox-tag-service.git;

master Branch mit Bash/Terminal

git clone https://github.com/Archi-Lab/prox-project-service.git && 
git clone https://github.com/Archi-Lab/prox-module-service.git && 
git clone https://github.com/Archi-Lab/prox-web-client.git && 
git clone https://github.com/Archi-Lab/prox-service-discovery.git && 
git clone https://github.com/Archi-Lab/prox-api-gateway.git && 
git clone https://github.com/Archi-Lab/prox-proposal-service.git && 
git clone https://github.com/Archi-Lab/prox-tag-service.git && 

Da wir meistens in Branches arbeiten, ist es eher notwendig ein gewissen Branch direkt auszuchecken. Die Anweisungen sind exemplarisch für den dev Branch aufgeführt. Für andere Branches, einfach an allen Stellen das dev durch den entsprechenden Branchnamen ersetzen.

dev Branch mit Powershell

git clone https://github.com/Archi-Lab/prox-project-service.git; cd prox-project-service/; git checkout dev; cd ..; `
git clone https://github.com/Archi-Lab/prox-module-service.git; cd prox-module-service/; git checkout dev; cd ..; `
git clone https://github.com/Archi-Lab/prox-web-client.git; cd prox-web-client/; git checkout dev; cd ..; `
git clone https://github.com/Archi-Lab/prox-service-discovery.git; cd prox-service-discovery/; git checkout dev; cd ..; `
git clone https://github.com/Archi-Lab/prox-api-gateway.git; cd prox-api-gateway/; git checkout dev; cd ..;`
git clone https://github.com/Archi-Lab/prox-proposal-service.git; cd prox-proposal-service/; git checkout dev; cd ..;`
git clone https://github.com/Archi-Lab/prox-tag-service.git; cd prox-tag-service/; git checkout dev; cd ..;

dev Branch mit Bash/Terminal

git clone https://github.com/Archi-Lab/prox-project-service.git && cd prox-project-service/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-module-service.git && cd prox-module-service/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-web-client.git && cd prox-web-client/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-service-discovery.git && cd prox-service-discovery/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-api-gateway.git && cd prox-api-gateway/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-proposal-service.git && cd prox-proposal-service/ && git checkout dev && cd .. && 
git clone https://github.com/Archi-Lab/prox-tag-service.git && cd prox-tag-service/ && git checkout dev && cd ..

Wie geht es weiter?

Es gibt zwei Philosophien was das Debuggen und Loggen angeht. Die einen sind der Meinung das die Anwendung Ausführen und Loggen reicht, die anderen gehören eher zu den Leuten die gerne Debuggen.

Es gibt hierbei - wie so oft - kein richtig und kein falsch und man kann an Prox mit beiden Arbeiten!

Wenn man den Code am nächsten zur Produktionsumgebung ausführen möchte, dann sollte man in den jeweiligen Repositories in der README die Local usage with docker-Abschnitte befolgen.

Wenn man dagegen den Code gerne erstmal in der IDE/im Debugger starten möchte, dann bitte in den jeweiligen Repositories in der README die Local usage in IntelliJ IDEA-Abschnitte befolgen.

Umabhängig davon, bitte in den jeweiligen Repositories die Anweisungen in der README unter Installation beachten und ausführen!