CloudLand 2023, Juni 2023, Sascha Böhme, QAware Ein System wird heutzutage üblicherweise in Microservices geschnitten, die jedes für sich genommen ein alleinstehendes Projekt bilden. Wie schafft man es, dass sich ein Entwickler in einem Microservice sofort zuhause fühlt, ohne ihn vorher je gesehen zu haben? Wie schafft man es, dass alle Microservices die gleiche Grundstruktur behalten und warum sollte man das überhaupt wollen? Wie vermeidet man Divergenzen in Setup und Struktur, während unterschiedliche Teams an den Microservices arbeiten? Wie setzt man schnell einen neuen Microservice auf, der in seinem Aufbau den bestehenden ähnelt?Wir wollen zeigen, welche Vorteile Templates für die Entwicklung von Microservices haben und welche Methoden in diesem Kontext nützlich sind. Dies ergänzen wir mit weiteren Tools, um das Setup für alle Entwickler gleichermaßen zu erleichtern und zu beschleunigen.

1. qaware.de
Die nächsten 100 Microservices
Sascha Böhme
sascha.boehme@qaware.de

2. 2

3. 3
QAware
A
entwickelt
1

4. 4
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t Setup kopiert
1

5. 5
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
1 2

6. 6
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
Setup kopiert
C
entwickelt
1 2

7. 7
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
entwickelt
C
Setup geändert
1 2

8. 8
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
entwickelt
C
1 2
3

9. 9
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
entwickelt
C
D
Setup kopiert
entwickelt
1 2
3

10. 10
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
entwickelt
C
D
entwickelt
1 2
3
?
Setup kopiert?
Setup kopiert?
entwickelt

11. 11
QAware
A
entwickelt
B
e
n
t
w
i
c
k
e
l
t
entwickelt
C
D
entwickelt
1 2
3

12. 12
QAware
A
entwickelt
B
entwickelt
C
D
Setup kopiert
entwickelt
1 2
3
entwickelt
Setup angepasst?

13. 13
QAware
Beobachtete Probleme
Initialisieren von
Projekten
Aktualisieren von
Projekten
Woher nimmt man das initiale
Setup?
Einsteigen in neue
Projekte
Wie verteilt man
Änderungen am Setup?
Wie kommt man an alle
relevanten Projekte?
Wie passt man das initiale
Setup an neue Bedürfnisse
an?
Wie trennt man Setup-
Änderungen von anderen
Änderungen?
Was benötigt man für die
Entwicklung?

14. 14
QAware
Einblick in den Projektalltag
34 Mitarbeitende in
4 Teams
160 Repositories
31 Microservices 35 Jobs
51 Bibliotheken 43 weitere Repositories
Konventionen
Impulse für Neues
Vorgehensweisen
Problemlösungen

15. 15
QAware
Ein typisches Setup bei Projekten mit mehreren Teams
Getrennte Repositories Ähnlicher Aufbau
Kein Mono-Repo
Gleiche Entwicklungs-
umgebung
Gleiches Build-Tooling
Unterschiede in klar
umgrenzten Bereichen
Jedes Projekt in eigenem
Repository
Gleiche Versionsverwaltung
Ähnliches Deployment

16. 16
QAware
Faktoren für produktive Teams
Wiederverwendung
Expertenwissen
Entwickler-Fokus
Zusammenarbeit
Man muss das Rad nicht
immer neu erfinden.
Nicht jeder muss alle Details
kennen.
Gemeinsam sind wir stark.
Setup und Infrastruktur
müssen einfach gehen.

17. 17
QAware
Allgemeine Strategien für erhöhte Produktivität
geteilte Bibliotheken
Artefakte mit gemeinsam
genutztem Code
geteilte Workflows
Build-Plugins für
übergreifende Prozesse
Konventionen für alle Projekte
spezifisch für jede Projektart
parametrisiert für die
jeweiligen Unterschiede

18. 18
QAware
neues Repository anlegen
lokale Entwicklungsfähigkeit herstellen
Aspekte mit Automatisierungspotential
Änderungen am Projekt-Setup verteilen
Entwicklungsprozess vereinheitlichen
bei Projekteinstieg
basierend auf Wissen der
Vergangenheit
von einem Repository in alle
anderen ähnlichen
durch Konfigurationen

19. 19
QAware
Repo-M
an

20. 20
QAware
Repo-M
an
Automatisierung für Aktionen
an Repositories (CLI)
Integration mit Git und
GitHub
Konfiguration aller
Repositories (YAML)
Kompetenzen von Repo-Man

21. 21
QAware
Repo-M
an
Fähigkeiten von Repo-Man
Initialisieren
1
Aktualisieren
2
Verwalten
3

22. > git clone ssh://some.github.url/some-org/project-base
> cd project-base
>
22

23. 23
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
► templates
￭ README.md
￭ repo-man
￭ repo-man.bat

24. > git clone ssh://some.github.url/some-org/project-base
> cd project-base
> ./repo-man clone rocket
24
● klont alle Repositories vom Team “rocket”
● klont alle Repositories mit Tag “rocket”

25. > git clone ssh://some.github.url/some-org/project-base
> cd project-base
> ./repo-man clone rocket
> ls ..
rocket-lib-basket shared-lib-auth
rocket-srv-clothes shared-lib-error
rocket-srv-promotion shared-plg-secrets
>
25

26. 26
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
► templates
￭ README.md
￭ repo-man
￭ repo-man.bat
# This group contains all services.
defaults:
...
repositories:
moon-srv-assistant:
teams: [ moon ]
...
rocket-srv-clothes:
teams: [ rocket ]
...
rocket-srv-promotion:
teams: [ rocket ]
...
sat-srv-shoes:
teams: [ sat ]
...

27. 27
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
► templates
￭ README.md
￭ repo-man
￭ repo-man.bat
# This group contains all services.
defaults:
...
repositories:
moon-srv-assistant:
teams: [ moon ]
...
rocket-srv-bags:
teams: [ rocket ]
...
rocket-srv-clothes:
teams: [ rocket ]
...
rocket-srv-promotion:
teams: [ rocket ]
...
sat-srv-shoes:
teams: [ sat ]
...

28. > git clone ssh://some.github.url/some-org/project-base
> cd project-base
> ./repo-man clone rocket
> ls ..
rocket-lib-basket shared-lib-auth
rocket-srv-clothes shared-lib-error
rocket-srv-promotion shared-plg-secrets
> ./repo-man create rocket-srv-bags
28
● erzeugt das lokale Verzeichnis “rocket-srv-bags”
● initialisiert Git in diesem Verzeichnis
● füllt das Verzeichnis mit dem initialen Setup für
einen Service
● erzeugt das GitHub-Repository “rocket-srv-bags”
● pusht den initialen Stand nach GitHub

29. 29
QAware
Repo-M
an
Fähigkeiten von Repo-Man
Initialisieren
1
Aktualisieren
2
Verwalten
3

30. 30
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
▼ templates
► base
► build
► library
► plugin
► sample-service
► service
￭ README.md
￭ repo-man
￭ repo-man.bat
Setup aller Arten von Repositories

31. 31
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
▼ templates
► base
► build
► library
► plugin
► sample-service
▼ service
► .github
► src
build.gradle
...
settings.gradle
￭ README.md
￭ repo-man
￭ repo-man.bat
Setup für einen Service mit
Parametern zur Anpassung
wird sowohl für Updates als auch
für Initialisierungen verwendet
muss bei Änderungen in einem
Repository mitgepflegt werden

32. 32
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
▼ templates
► base
► build
► library
► plugin
► sample-service
▼ service
► .github
► src
build.gradle
...
settings.gradle
￭ README.md
￭ repo-man
￭ repo-man.bat
pluginManagement {
repositories {
mavenCentral()
}
}
rootProject.name = “<@ name @>”
rootProject.group = “<@ topLevelPackage @>”

33. 33
project-base
▼ src
▼ repositories
￭ plugins.yaml
￭ libraries.yaml
￭ services.yaml
► secrets
▼ templates
► base
► build
► library
► plugin
► sample-service
▼ service
► .github
► src
build.gradle
...
settings.gradle
￭ README.md
￭ repo-man
￭ repo-man.bat
# This group contains all services.
defaults:
...
repositories:
moon-srv-assistant:
teams: [ moon ]
...
rocket-srv-bags:
teams: [ rocket ]
templates: [ base, build, service ]
properties:
topLevelPackage: com.some.shop.bags
...
rocket-srv-clothes:
teams: [ rocket ]
...
rocket-srv-promotion:
teams: [ rocket ]
...
sat-srv-shoes:
teams: [ sat ]
...

34. > ./repo-man update rocket-srv-clothes
34
wendet alle für dieses Repository konfigurierten
Templates der Reihe nach an

35. > ./repo-man update rocket-srv-clothes
> ./repo-man branch -n gradle-update services
> ./repo-man update -t base services
> ./repo-man commit -m “Updated Gradle to version 8.1.1” services
35
erzeugt den Branch “gradle-updates” vom
Standard-Branch
wendet das Template “base” auf alle
Service-Repositories an
erzeugt einen Commit der letzten Änderungen, pusht
den Commit zu GitHub und erstellt einen Pull-Request

36. 36
QAware
Repo-M
an
Fähigkeiten von Repo-Man
Initialisieren
1
Aktualisieren
2
Verwalten
3

37. > ./repo-man configure --setup libraries
> ./repo-man configure --secrets services
> ./repo-man configure --teams plugins
37
konfiguriert das GitHub-Setup aller
Library-Repositories
ersetzt die GitHub-Action-Secrets aller
Service-Repositories
aktualisiert alle Team-Berechtigungen in GitHub für
alle Plugin-Repositories

38. 38
QAware
Repo-M
an
Repo-Man in der Zusammenfassung
Repository-Setup as Code
automatisierte Verteilung von
Änderungen an Repositories
vervielfachte Ausführung von
gleichartigen Tätigkeiten

39. 39
QAware
34 Mitarbeitende
160 Repositories geteilte Bibliotheken
geteilte Workflows
Repo-Man
Wiederverwendung
✓
Expertenwissen
✓
Entwickler-Fokus
✓
Zusammenarbeit
✓

40. Bereit für die
nächsten 100 Microservices
✓

41. qaware.de
QAware GmbH
Aschauer Straße 32
81549 München
Tel. +49 89 232315-0
info@qaware.de
twitter.com/qaware
linkedin.com/company/qaware-gmbh
xing.com/companies/qawaregmbh
slideshare.net/qaware
github.com/qaware

42. 42
QAware
Bild von Font Awesome Bild von Clker-Free-Vector-Images
auf Pixabay