Die Anmeldung zum Wettbewerb findet in diesem Jahr zum ersten Mal über das neue Online-Portal Teammates für Teilnehmer am informatiCup statt. Auf diesem Online-Portal könnt Ihr Euch als Teilnehmer registrieren, zu einem gemeinsamen Team einladen und dieses Team schließlich zum Wettbewerb anmelden.
Erforderlich für eine Teilnahme am informatiCup ist, dass sich jedes Mitglied eines Teams mit Namen, Email-Adresse und Passwort auf dem Online-Portal Teammates registriert.
Als registrierter Teilnehmer kannst Du, wenn Du ein sichtbarer Teil der informatiCup Community werden willst, für Dein Benutzerkonto ein Profil mit weiteren Information über Dich wie zum Beispiel Deinen sozialen Netzwerken oder beruflichen oder Ausbildungsstationen anlegen.
Sobald Du ein Profil angelegt hast, erscheinst Du in der öffentlichen Liste der informatiCup-Teilnehmer.
Das Anlegen eines Profils ist dabei komplett optional und für eine Teilnahme am informatiCup nicht erforderlich. Du kannst Dein Profil auch jederzeit löschen und nur Dein Benutzerkonto behalten.
Als registrierter Benutzer kannst Du ein Team anlegen. Gib dem Team dazu einen (kreativen) Namen und gib an von welchen Hochschulen die Teammitglieder kommen. Deine Teammitglieder kannst Du über die Email-Adresse, mit der sie sich bei Teammates registriert haben, einladen. Deine Einladung erscheint im Teammates-Dashboard Deiner Teamkollegen. Einladungen kannst Du annehmen oder ablehnen.
Ein Team mit mindestens 2 und höchstens 4 Teammitgliedern kannst Du für den informatiCup anmelden. Beachte dazu die Anmeldefrist des aktuellen Wettbewerbs.
Die Anmeldung zum informatiCup über Teammates ersetzt die bisherige Anmeldung via Email.
Für Fragen zu Teammates nutze bitte die Issues des aktuellen GitHub Repositories zum Wettbewerb.
In Teammates kannst Du zu Deinem Benutzerkonto einen öffentlichen SSH-Schlüssel eintragen. Mit diesem Schlüssel hast Du dann Zugriff auf das Git Repository Deines Teams in dem informatiCup CI System.
Der öffentliche Schlüssel findet sich in einer Datei mit .pub-Endung. Dieser muss ohne Zeilenumbrüche in Teammates eingetragen werden. Der Schlüssel sieht ähnlich dem folgendem Schema aus:
ssh-ed25519 AAAAC3NzaC1lXXXXXXXXXXXXXXX/rcj6SyU0CNdUE/w5NjoUxQDbKuwcFugyHzYhoGx5 marcus@localhost
folgende Beispiele sind KEINE gültigen öffentlichen Schlüssel:
SHA256:k/8OZpOFWkhOC+s+VIXBLTcJMHsUVjSuyADxhz3CLvs marcus@localhost
(nur die Checksumme, kein Schlüssel)
SHA256:k/8OZpOFWkhOC+s+VIXBLTcJMHsUVjSuyADxhz3CLvs
(nur die Checksumme, kein Schlüssel)
-----BEGIN OPENSSH PRIVATE KEY-----
b3BlbnNzaC1rZXktXXXXXXXXXXXXXXXXXXXXXXXXXXXXXAAAAAABAAAAMwAAAAtzc2gtZW
QyNTUxOQAAACDR/63I+ksXXXXXXXXXXXXXXXXXXXXXXXXoMh82IaBseQAAAJDdSEd73UhH
ewAAAAtzc2gtZWQyNTUxOQXXXXXXXXXXXXXXXXXXXXXXXXY6FMUA2yrsHBboMh82IaBseQ
AAAEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXTdH/rcj6SyU0CNdUE/w5NjoU
xQDbKuwcFugyHzYhoGx5AAAADXRvcHJhbmdlckBJdm8=
-----END OPENSSH PRIVATE KEY-----
(privater Schlüssel)
+--[ED25519 256]--+
| o. oo*O+. |
| + o =+.*. |
| * * ++.. |
| . = X.= . |
| . . +.S o . |
| o .. = o |
| . .. . B |
| . .. o + |
| E .. .o |
+----[SHA256]-----+
(randomart ist kein Schlüssel)
ssh-ed25519 AAAAC3NzaC1l
XXXXXXXXXXXXXX/rcj6S
yU0CNdUE/w5NjoUxQDbKuwcFugyHzYhoGx5 marcus@localhost
(Zeilenumbrüche sind nicht erlaubt)
Jedes angemeldete Team erhält in dem neuen informatiCup CI System ("ICUPCI") ein Git Repository. Auf dieses Repository hat jedes Mitglied des Teams Zugriff mit Git via SSH, zum Beispiel mit git clone ssh://ci@ci.informaticup.de:/repo
Die URL ist dabei für alle Teams die gleiche, der Zugriff auf das Repository des eigenen Teams wird über die SSH-Schlüssel der Teammitglieder geregelt.
Das ICUPCI Git Repository Eures Teams steht Euch für die Dauer des laufenden Wettbewerbs zur Verfügung: als mögliches Git "origin", für die Abgabe Eurer Lösung und für laufende Softwaretests.
Die Verwendung des ICUPCI Git Repository als "origin" ist komplett optional, steht Euch aber für den laufenden Wettbewerb natürlich gerne zur Verfügung.
Mit folgendem Befehl könnt Ihr Euren Code regelmäßig in das ICUPCI übertragen, falls Ihr das ICUPCI Git Repository nicht als "origin" nutzt:
git push --mirror ci@ci.informaticup.de:/repo
Für die Einreichung Eurer Lösung am Ende des Wettbewerbs ist die Verwendung des ICUPCI Git Repository erforderlich. Ihr müsst also mindestens einmal Eure Lösung pushen, um sie einzureichen.
Beachtet das erwartete Format Eurer Lösungseinreichung in der aktuellen Aufgabenbeschreibung.
Wenn Ihr Eure Software in das ICUPCI Git Repository Eures Teams gepusht habt, führt das informatiCup CI System automatisch Tests mit Eurer Software durch. Die Ergebnisse dieser Softwaretests könnt Ihr Euch in Teammates auf der Seite Eures Teams ansehen. Ihr werdet damit also schon während der Wettbewerb noch läuft über die funktionale Korrektheit und Performance Eurer Software informiert.
Die Continuous Integration basiert auf Docker. Wenn im Git Repository Eures Teams eine Dockerfile liegt, dann wird der Quelltext gebaut und mittels ```docker run`` gestartet. Das Programm erhält dann - wie in der Aufgabe beschrieben - die Eingabe über die Standardeingabe und muss das Ergebnis auf der Standardausgabe ausgeben. Die Eingabedateien werden wöchentlich gewechselt, es lohnt sich also, regelmäßig den Status zu überprüfen.
Das CI arbeitet auf dem main-Branch Eures Repositories. Existiert dieser nicht, wird der master-Branch versucht. Existiert auch dieser nicht, bricht die Verarbeitung mit einer Fehlermeldung ab.
Wenn kein neuer Commit im Git Repository vorliegt und sich die Eingabe nicht verändert hat, dann wird der Test übersprungen. In diesem Fall wird kein Eintrag in Teammates erstellt.
Der Zugriff auf das Git Repository Eures Teams im informatiCup CI System erfolgt mit Git via SSH mit dem öffentlichen SSH-Schlüssel den jedes Teammitglied für sich in Teammates eintragen kann.
Wichtig für einen funktionierenden Zugriff unter Windows ist ein laufender SSH Agent, eine aktive Identity für den SSH-Schlüssel aus Teammates sowie die Konfiguration von Git bzw. GitHub Desktop mit den passenden SSH Executables.
Für den Zugriff auf das ICUPCI Git Repository Eures Teams mit GitHub Desktop...
-
Erzeuge mit ssh-keygen -t ed25519 -C "your_email@example.com" einen SSH-Schlüssel
-
Trage den öffentlichen Schlüssel in Teammates ein
-
Starte den Windows Service "OpenSSH Authentication Agent". Setze den Startup Type auf Automatic
-
Füge den privaten SSH-Schlüssel mit ssh-add ~/.ssh/id_ed25519 (ggf. anderer Dateiname) dem OpenSSH Authentication Agent hinzu
-
In GitHub Desktop, im Menü File > Options > Advanced wähle für SSH die Option "Use system OpenSSH (recommended)"
-
Clone / Push mit GitHub Desktop das Repository mit der URL ssh://ci@ci.informaticup.de:/repo
Für den Zugriff auf das ICUPCI Git Repository Eures Teams mit git...
-
Erzeuge mit ssh-keygen -t ed25519 -C "your_email@example.com" einen SSH-Schlüssel
-
Trage den öffentlichen Schlüssel in Teammates ein
-
Starte den Windows Service "OpenSSH Authentication Agent". Setze den Startup Type auf Automatic
-
Füge den privaten SSH-Schlüssel mit ssh-add ~/.ssh/id_ed25519 (ggf. anderer Dateiname) dem OpenSSH Authentication Agent hinzu
-
Konfiguriere git nicht die eigenen sondern die Windows SSH Executables zu verwenden. Führe dazu in der Powershell dieses Kommando aus: [Environment]::SetEnvironmentVariable("GIT_SSH", "$((Get-Command ssh).Source)", [System.EnvironmentVariableTarget]::User)
-
Clone / Push mit git das Repository mit der URL ssh://ci@ci.informaticup.de:/repo
Für Fragen zum informatiCup CI System nutze bitte die Issues des aktuellen GitHub Repositories zum Wettbewerb.