1a: Einrichtung für Windows
Um die cloudControl Plattform in die eigene Arbeitsumgebung unter Windows zu integrieren, sind einige wenige Schritte notwendig. Diese müssen auch nur beim ersten Mal durchgeführt werden.
Abhängigkeiten
Folgende Abhängigkeiten müssen installiert sein, damit die 'cctrl' Applikation genutzt werden kann.
- Bazaar VCS für Windows (Wir empfehlen den Standalone Installer. Anderenfalls müssen weitere Dependencies von Hand installiert werden.)
- PuTTY (Wir empfehlen den Installer. Zwingend benötigt werden puttygen.exe und pageant.exe)
- Microsoft Visual C++ 2008 Redistributable Package (x86) (Windows XP und Windows Vista)
'cctrl' installieren
'cctrl' ist der Kommandozeilen Client mit dem die cloudControl Plattform kontrolliert werden kann.
'cctrl' bietet zwei Aufrufe. Zum einen 'cctrlapp' für alle Befehle, die eine Applikation betreffen, und 'cctrluser' für alle Befehle, die einen User betreffen. Mittels -h bzw. --help kann man sich jeweils die Hilfe anzeigen lassen.
Account anlegen
Um mit der cloudControl Plattform arbeiten zu können, müssen wir zuerst einen Account anlegen. Dazu nutzen wir den folgenden Befehl:
> cctrluser create
Tipp: 'cctrl' ist eine Konsolenanwendung. Unter Windows startet man die Konsole am schnellsten per Windows-Taste + r und führt dann cmd aus.
Die Anwendung fragt dann den Namen, eine E-Mail Adresse und ein Passwort ab. Danach muss der Account nur noch aktiviert werden - entweder direkt über den Link in der Email oder per Kommandozeile
> cctrluser activate user_name activation_code
SSH Key
Sofern noch kein SSH Key existiert, muss ein Neuer erstellt werden. Hierzu starten wir PuTTYgen.
Eine Präsentation am Ende dieser Seite zeigt die einzelnen Schritte nochmals im Detail.
Wir benötigen einen 2048 Bit SSH2-RSA Key. Screenshot 1 zeigt die notwendigen Einstellungen. Nach einem Klick auf Generate beginnt PuTTYgen den Schlüssel zu berechnen. Währenddessen muss man, um Zufallszahlen zu erzeugen, die Maus innerhalb des leeren grauen Bereichs bewegen.
Sobald der Key erzeugt ist, erscheint der für uns wichtige Teil innerhalb des grauen Bereichs. Diesen öffentlichen Schlüssel bitte vollständig manuel kopieren und auf der Festplatte in einer Datei abspeichern. Der Name der Datei ist frei wählbar. Wir empfehlen allerdings "id_rsa.pub". Wichtig ist, dass der gesamte kopierte Schlüssel in einer Zeile in dieser Datei steht. Wichtig: Falls der Key mit PuTTYGen gespeichert wird, enthält diese Datei Zeilenumbrüche, was zu Fehlern bei der Erkennung führt.
Anschliessend muss der private Teil des Schlüssels gespeichert werden. Zur Sicherheit ist es ratsam, diesen Schlüssel mit einem Passwort zu versehen.
Damit die Authentifizierung mittels Schlüssel möglich ist, muss der öffentliche Teil des Schlüssels (die Datei "id_rsa.pub") mit dem cloudControl User verknüpft werden. Wichtig, wir benötigen ausschließlich den öffentlichen Teil.
> cctrluser key.add ..\Pfad_zum_öffentlichen_Schlüssel\id_rsa.pub
PuTTY Agent einrichten
Zu guter letzt muss der private Teil des Schlüssels noch in den Pageant geladen werden. Dazu diesen starten und per Rechtsklick im Systemtray den eben erzeugten privaten Schlüssel dem Agent hinzufügen. Wichtig: Der Agent muss immer laufen und der Schlüssel hinzugefügt sein um auf das integrierte Versionskontrollsystem zugreifen zu können.
Damit ist die Einrichtung auch schon abgeschlossen. Weiter geht's mit der ersten Applikation.