Skip to content

Latest commit

 

History

History
112 lines (65 loc) · 3.78 KB

03_first_steps.md

File metadata and controls

112 lines (65 loc) · 3.78 KB

Lab 3: Erste Schritte auf der Lab Plattform

In diesem Lab werden wir gemeinsam das erste Mal mit der Lab Plattform interagieren, dies sowohl über den oc Client wie auch über die Web Console.

Login

Note: Vergewissern Sie sich, dass Sie Lab 2 erfolgreich abgeschlossen haben, d.h. erfolgreich auf der Web Console einloggen sowie den oc Client installieren konnten.

Befehl kopieren via Web Console

Der Befehl für das Login mit oc kann komfortabel via Web Console geholt werden. Dazu oben rechts auf den eigenen Username und anschliessend auf Copy Login Command klicken:

oc-login

Nun kann der Befehl wie er unter "Log in with this token" dargestellt wird kopiert und in einem Terminal-Fenster eingefügt werden.

Login direkt mit oc

Als Alternative zum Kopieren des Befehls kann direkt mit oc eingeloggt werden:

oc login FIXME: URL

OpenShift Projekte

Ein Projekt in OpenShift ist das Top-Level Konzept um Ihre Ressourcen wie Deployments, Builds, Container Images etc. zu organisieren. Für das Projekt berechtigte User können diese Ressourcen verwalten. Innerhalb eines OpenShift Clusters muss der Name eines Projektes eindeutig sein. Siehe auch Lab 1.

Aufgabe 1: Neues Projekt erstellen

Erstellen Sie auf der Lab Plattform ein neues Projekt mit Namen [USERNAME]-example1.

Um herauszufinden, wie Sie ein neues Projekt mit oc erstellen, können Sie folgenden Befehl verwenden:

oc help
Tippoc new-project [USERNAME]-example1

Web Console

Die OpenShift Web Console erlaubt es den Benutzern gewisse Tasks direkt via Browser vorzunehmen.

Aufgabe 2: Applikation erstellen

  1. Gehen Sie in die Übersicht Ihres eben erstellten Projektes. Aktuell ist das Projekt noch leer.

  2. Fügen Sie Ihre erste Applikation Ihrem Projekt hinzu. Als Beispielprojekt verwenden wir ein APPUiO Example:

    1. Wechseln Sie zuerst von der Administrator- in die Developer-Ansicht oben links

    2. Stellen Sie sicher, dass bei "Project" Ihr neu erstelltes Projekt selektiert ist.

    3. Wählen Sie nun unten links unter "Developer Catalog" den Punkt "All services"

    4. Schränken Sie die Auswahl über einen Klick auf Languages und anschliessend PHP ein

    5. Wählen Sie nun das Feld "PHP" aus und klicken auf "Create Application"

    6. Füllen Sie das Feld "Git Repo URL" mit folgender URL

    https://github.com/appuio/example-php-sti-helloworld.git
    
  3. Belassen Sie die restlichen Felder leer oder auf deren Standardwert und klicken auf Create

Sie haben soeben Ihre erste Applikation mittels sog. Source to Image Build auf OpenShift deployed.

Tipp: Mit den folgenden Befehlen kann das obere Beispiel auf der Kommandozeile erstellt werden:

oc new-app https://github.com/appuio/example-php-sti-helloworld.git
oc expose svc example-php-sti-helloworld

Note: Der oc new-app-Befehl benötigt git. Falls git nicht installiert ist, insb. auf Windows, kann das Tool hier heruntergeladen und installiert werden.

Tipp: Eine so erstellte Applikation mitsamt den zusätzlich angelegten Ressourcen kann mithilfe von Labels auf einen Schlag gelöscht werden, bspw. mit folgendem Befehl:

oc delete all --selector app=example-php-sti-helloworld-git

Um die Labels der verschiedenen Ressourcen anzuzeigen kann folgender Befehl verwendet werden:

oc get all --show-labels

Ende Lab 3

Ein Container Image deployen →

← zurück zur Übersicht