Durchstarten mit dem EcoSystem

Cloudogu EcoSystem via VirtualBox installieren

Hallo und vielen Dank für Ihr Interesse an unserem Cloudogu EcoSystem. Sollten Sie Anregungen oder Fragen haben, kontaktieren Sie uns gerne via hello@cloudogu.com oder telefonisch unter +49. 531. 61 80 88 80.

Woher bekommen Sie Ihr Image?

Der einfachste Weg zu einem Cloudogu EcoSystem (CES) ist ein Download des VirtualBox Images über die myCloudogu Plattform. Für den Download benötigen Sie lediglich einen kostenlosen Account, der anschließend auch für die Registrierung der Instanz während der Installation genutzen werden kann.

CES herunterladen

Zur Verifizierung des Images können Sie noch den SHA256-Hash des Images herunterladen.


Vorbereitungen

Um mit dem Cloudogu EcoSystem zu starten, benötigen Sie eine Virtualisierungsumgebung um die Plattform zu betreiben. Idealerweise besitzen Sie eine leistungsstarke lokale Maschine oder verfügen über bereitgestellte Hardware in einem Rechenzentrum.

Ihr Hoster hält vermutlich eine Anleitung bereit, wie Sie Images von Dritten in Ihr System laden und verwenden können. Sollten Sie das Image nicht in einer Serverumgebung betreiben, empfehlen wir die aktuelle Version der VirtualBox.

Die Einrichtung in der VirtualBox

Über den Reiter „Importieren“ auf der Startseite des Programms bekommen Sie ein Kontextmenü angezeigt. Hier muss der „Expertenmodus“ ausgewählt werden, um die Option „Zuweisen neuer MAC-Adressen für alle Netzwerkkarten“ nutzen zu können.

Import der Maschine

Nachdem Sie das heruntergeladene Image angegeben und ggf. Anpassungen durchgeführt haben, können Sie den Import starten.

Import der Maschine

Nach einem erfolgreichen Import können Sie die Maschine hochfahren. Wichtig: Stellen Sie den Netzwerkadapter der Maschine auf Netzwerkbrücke.

Maschinenstatus

Die Einrichtung bei einem Hoster

Zum Importieren des Images bei Ihrem Hoster konsultieren Sie bitte dessen FAQ. Das Dateiformat könnte hierbei abweichen. Falls Sie das Image konvertieren müssen, können wir eine korrekte Funktionsfähigkeit nicht garantieren. Weitere Formate können bei uns angefragt werden.


Durchführen des Setups

Registrierung (CES Instance Registration)

Die Registrierung der Instanz ist notwendig um Zugriff auf die von uns bereitgestellten Dogus zu erhalten. Ihre erste Instanz ist gänzlich kostenfrei. Bei Fragen können Sie sich jederzeit an uns wenden. Sollten Sie Bedarfe haben die mit unserem Community Angebot nicht gedeckt sind, bieten wir Ihnen maßgeschneiderte Kooperationsverträge an. Hierzu zählt auch die Implementierung von weiteren Dogus, die Ihre Bedürfnisse komplettieren.

Die Maschine steht Ihnen in der Regel über die Website http://192.168.0.56:8080 für das Setup zur Verfügung. Sollte dies nicht der Fall sein, wurde der Maschine von Ihrem Netzwerk eine andere IP zugewiesen. Um die IP herauszufinden müssen Sie sich über das CLI anmelden. Die Logindaten sind Username ces-admin mit dem Passwort ces-admin. Hinweis: Das Standard-Keyboard-Layout ist Englisch, das “-“ ist auf der “ß” -Taste. Wichtig: Das Passwort des Users ces-admin wird am Ende des Setup-Prozesses durch eine zufällig generierte Zeichenfolge ersetzt, die Ihnen dann mitgeteilt wird.

IP Adresse

Nach dem erfolgreichen Login wird die IP der Maschine angezeigt. Sie können das Setup unter http://ip-adresse:8080 starten.

Registration

Dort können Sie den Prozess mit „Register instance“ starten.

Login

Um Ihre Instanz zu registrieren, können Sie Ihren myCloudogu Account nutzen. Alternativ können Sie sich auch mit einem GitHub- oder Google-Account anmelden oder einen neuen Account registrieren.

Abschließen der Registrierung

Bestätigen Sie anschließend die Registrierung Ihrer Instanz unter Ihrem Account.

Erfolgreiche Registrierung

Region (Set region specific settings)

Nach der Registrierung beginnt die Konfiguration Ihrer Instanz. Der erste Schritt ist die Festlegung der Region Ihrer Instanz.

Region Einstellungen

Naming (FQDN, Hostname, Domain and Certificates)

Im nächsten Schritt werden Informationen zur Erreichbarkeit Ihrer Instanz und dem E-Mail-Versand benötigt.

Naming

Hinweis FQDN: Die „FQDN“ zeigt standardmäßig die IP-Adresse des virtuellen Systems an. Sie können die „FQDN“ auch ändern, indem Sie z.B. eine firmeneigene URL eintragen. Empfehlenswert ist eine Zusammensetzung aus „Hostname“ und „Domain“. Wenn kein FQDN angegeben wird, ist das CES nur über die IP erreichbar.

Hinweis Certificate Type: Wenn Sie noch keine Zertifikate für Ihre Instanz haben, können Sie „Self Signed“ auswählen. Für einen produktiven Betrieb empfehlen wir jedoch, dass Sie Third Party Zertifikate benutzen.

Hinweis Mail Relay Host: Nur wenn ein gültiger Mailserver angegeben ist kann das Cloudogu EcoSystem E-Mails verschicken. Der Mail Relay Host kann sowohl als URL als auch als IP-Adresse angegeben werden. Auch ein inkorrekter Mail Relay Host, bspw. für Testzwecke, ist möglich.

User Backend (Configure your directory service)

Wählen Sie bitte die gewünschte Nutzerverwaltungsdatenbank. Wir liefern Ihnen eine implementierte Version direkt mit. Sollten Sie bereits ein eigenes LDAP oder Active Directory zur Verfügung haben, können Sie dieses selbstverständlich anbinden und konfigurieren.

User Backend

Dogu (Choose your Dogus)

Suchen Sie Ihre Werkzeuge (Dogus) aus und legen Sie ein Dogu als Startseite nach dem Login (Default Dogu) fest.

Dogu Auswahl

Details zu den Dogus finden Sie in unserem Glossar.

Hinweis: Abhängigkeiten zwischen Dogus werden automatisch berücksichtigt. Wenn Sie also z.B. „Jenkins CI“ auswählen, werden automatisch auch „Central Authentication Service“, „Nginx“, „Postfix“ und „Registrator“ ausgewählt, da diese für den Betrieb von Jenkins benötigt werden.

In dem Default Dogu Feld können Sie auswählen welches Dogu nach dem Login an Ihrem Cloudogu EcoSystem als erstes angezeigt werden soll. Diese Einstellung gilt für alle Nutzer der Plattform.

Hinweis: Für die Community Edition des Cloudogu EcoSystem stehen keine Premium Dogus, wie z.B. „Backup & Restore“ zur Verfügung.

Admin (Configure the Administrator)

Im letzten Schritt der Konfiguration legen Sie den ersten User Ihres Cloudogu EcoSystem und einen Gruppennamen für Administratoren fest.

Administrator Konfiguration

Hinweis: Die Administratorengruppe (Admin Group) ist eine voreingestellte Gruppe des eingebetteten Directory Service, welche den Mitgliedern Administrationszugriff auf die installierten Tools gibt.

Um Ihren User auch als Administrator in den Dogus zu berechtigen, wählen Sie die Checkbox „Configure the user also as tool administrator“ aus.

Hinweis: Sollten Sie dem ersten User keine Administratorrechte geben, hat der User trotzdem die Rechte um weitere Benutzer in dem eingebetteten Directory Service anzulegen und Administratorrechte zu vergeben.

Wenn Sie einen gültigen Mail Relay Host angegeben haben, können Sie optional die automatisch generierten UNIX-Zugangsdaten an die hinterlegte E-Mail-Adresse senden lassen. Unabhängig davon werden diese nach Abschluss der Installation einmalig angezeigt.

Setup

In der letzten Phase sehen Sie, wie die Installation mit der von Ihnen vorgenommen Konfiguration Schritt für Schritt abgearbeitet wird.

Setupprozess

Nach Vollendung des Setup-Prozesses werden Ihnen einmalig Ihre UNIX-Zugangsdaten angezeigt. Sichern Sie sich diese Daten sorgfältig.

Zugangsdaten

Sie können über den angebotenen Link direkt ins Cloudogu EcoSystem navigieren. Je nachdem wie performant ihre Maschine ist, kann es einige Minuten dauern bis alle Dogus gestartet sind und Sie sich anmelden können.

Damit ist die Installation Ihres Cloudogu EcoSystem abgeschlossen. Sie können nun damit beginnen Benutzer und Daten zum System hinzuzufügen.


Ein kurzer Einstieg in das Cloudogu EcoSystem

Je nachdem welche Dogus sie ausgewählt haben, steht Ihnen nun eine umfangreiche Auswahl an unterschiedlichen Werkzeugen zur Verfügung.

Wichtig: Beachten Sie den Pfeil am rechten mittleren Bildschirmrand. Mit dieser Seitennavigationsleiste gelangen Sie auf die installierten Dogus.

CES WarpMenu