Skip to content

Latest commit

 

History

History
210 lines (133 loc) · 8.11 KB

02_builds.md

File metadata and controls

210 lines (133 loc) · 8.11 KB
Raw

Builds

Es gibt drei verschiedene Arten von Builds:

  1. Source-To-Image (s2i)
  2. Binary Builds
  3. Container aka. Docker Builds

Werfen wir einen Blick auf die verschiedenen Arten von Builds

Source-To-Image

Einfachster Einstieg von einer Codebasis (z. B. Ruby, Python, PHP) in eine ausgeführte Anwendung, die alle Abhängigkeiten enthält.

Es erstellt alle erforderlichen Build- und Deployment-Konfigurationen.

Erstellen Sie zunächst ein Projekt mit dem Namen "[USERNAME]-s2i"

Befehl zum Erstellen eines Projektsoc new-project [USERNAME]-s2i

Unser Beispiel basiert auf einer sehr einfachen PHP-Anwendung, welche auf APPUiO GitHub gehostet wird. Erstellen Sie eine Applikation mit dem Namen s2i aus diesem Repository: https://github.com/appuio/example-php-sti-helloworld.git

Hinweis zur Befehlshilfe:

oc new-app -h
Befehl zum Erstellen einer Appoc new-app https://github.com/appuio/example-php-sti-helloworld.git --name=s2i

Die new-app Funkionalität erkennt das Git Repo als PHP Projekt und erstellt eine s2i Applikation.

Überprüfen Sie den Status Ihres Projekts.

Projektstatusbefehloc status

Erkunden Sie die verschiedenen Ressourcen, die mit dem new-app Befehl erstellt wurden.

Um etwas im Browser anzuzeigen, erstellen Sie eine Route für den Zugriff auf die Anwendung:

oc create route edge --insecure-policy=Allow --service=s2i

Die URL, welche nun auf unsere ruby applikation zeigt, erhalten wir indem wir die route beschreiben (oc describe). Sie finden die URL auch in der Web Console. Sehen sie sich die applikation auch dort an.

Binary build

In diesem Beispiel wird beschrieben, wie Sie ein Webarchiv (war) in Wildfly mithilfe des OpenShift-Clients (oc) im binary Modus deployen. Das Beispiel ist vom APPUiO-Blog inspiriert: http://docs.appuio.ch/en/latest/app/wildflybinarydeployment.html

Erstellen Sie ein neues Projekt

Erstellen Sie ein Projekt mit dem Namen "[USERNAME]-binary-build"

Befehl zum Erstellen eines Projektsoc new-project [USERNAME]-binary-build

Erstellen Sie die Deployment Verzeichnisstruktur

Bereiten Sie einen temporären Ordner vor und erstellen Sie darin die Deployment Verzeichnisstruktur.

Mindestens ein War-File kann im Deployment Ordner abgelegt werden. In diesem Beispiel wird eine vorhandene War-Datei aus einem Git-Repository heruntergeladen.

Note: Das War-File muss den Namen ROOT.war haben, damit die Anwendung direkt auf der Route verfügbar ist. Wenn die Datei hello-world-war-1.0.0.war manuell heruntergeladen wurde, muss sie umbenannt werden: tmp-bin/deployments/ROOT.war

Befehle für Shell und PowerShell:

mkdir -p tmp-bin/deployments
cd tmp-bin
wget -O deployments/ROOT.war 'https://github.com/appuio/hello-world-war/blob/master/repo/ch/appuio/hello-world-war/1.0.0/hello-world-war-1.0.0.war?raw=true'

Erstellen Sie einen neuen Build mit dem Wildfly Container Image

Erstellen Sie eine Build-Konfiguration für einen binary-Build mit folgenden Attributen:

  • Basis Container Image: openshift/wildfly-160-centos7
  • Name: hello-world
  • Label: app=hello-world.
  • Typ: binary

Das Flag binary=true zeigt an, dass dieser Build seine Daten direkt als Input erhält, anstatt via URL (Git Repo).

Befehl:

oc new-build --image=openshift/wildfly-160-centos7 --binary=true --name=hello-world -l app=hello-world

Befehl mit Ausgabe:

$ oc new-build --image=openshift/wildfly-160-centos7 --binary=true --name=hello-world -l app=hello-world
--> Found Docker image 7ff222e (7 months old) from Docker Hub for "openshift/wildfly-160-centos7"

    WildFly 16.0.0.Final
    --------------------
    Platform for building and running JEE applications on WildFly 16.0.0.Final

    Tags: builder, wildfly, wildfly16

    * An image stream tag will be created as "wildfly-160-centos7:latest" that will track the source image
    * A source build using binary input will be created
      * The resulting image will be pushed to image stream tag "hello-world:latest"
      * A binary build was created, use 'start-build --from-dir' to trigger a new build

--> Creating resources with label app=hello-world ...
    imagestream.image.openshift.io "wildfly-160-centos7" created
    imagestream.image.openshift.io "hello-world" created
    buildconfig.build.openshift.io "hello-world" created
--> Success

Siehe die Befehlsausgabe für die erstellten Ressourcen.

Überprüfen Sie die erstellten Ressourcen mit dem oc-Tool und in der Web Console. Finden Sie den erstellten Build in der Web Console?

Build starten

Um einen Build auszulösen, geben Sie den folgenden Befehl ein. In einem kontinuierlichen Deployment-Prozess kann dieser Befehl wiederholt werden, wenn eine neue Binärdatei oder eine neue Konfiguration verfügbar ist.

Die Kernfunktion des Binary-Builds besteht darin, die Dateien für den Build aus dem lokalen Verzeichnis bereitzustellen. Diese Dateien werden in den Build-Container geladen, der in OpenShift ausgeführt wird.

oc start-build hello-world --from-dir=. --follow

Der Parameter --from-dir=. teilt dem oc-Tool mit, welches Verzeichnis hochgeladen werden soll.

Das --follow-Flag zeigt das Build-Protokoll auf der Konsole an und wartet, bis der Build abgeschlossen ist.

Eine neue Applikation erstellen

Erstellen Sie eine neue App basierend auf dem Container-Image, das mit dem Binary-Build erstellt wurde.

oc new-app hello-world -l app=hello-world

Siehe die Befehlsausgabe für die erstellten Ressourcen.

Überprüfen Sie die erstellten Ressourcen mit dem oc-Tool und in der Web Console. Versuchen Sie herauszufinden, ob Wildfly gestartet ist.

Applikations-Service als Route zur Verfügung stellen

oc create route edge --service=hello-world

Klicken Sie in der Web Console auf die Route, um die Ausgabe der hello-world-Anwendung anzuzeigen.

Container Build

Wir können auch beliebige Container basierend auf Dockerfiles erstellen.

Erstellen Sie zunächst ein Projekt mit dem Namen "[USERNAME]-docker-build"

Projektbefehl erstellenoc new-project [USERNAME]-docker-build

Befehl zum Erstellen eines Docker-Builds:

oc new-build --strategy=docker --binary=true --name=web -l app=web centos/httpd-24-centos7

Klonen Sie das techlab Git-Repository, falls Sie es noch nicht getan haben. Alternativ kann das Repository als Zip-Datei hier geholt und entpackt werden.

git clone https://github.com/appuio/techlab.git --branch=lab-4

Navigieren Sie zum Stammverzeichnis des Git-Repositorys (cd techlab). Stellen Sie sicher, dass Sie sich auf dem lab-4 Git Branch befinden.

Starten Sie den Build mit den Daten aus dev-labs/data/02_httpd:

oc start-build web --from-dir=dev-labs/data/02_httpd --follow

Verfolgen Sie, wie der Build abläuft und ob das Image in Ihrer Registry vorhanden sein wird.

Erstellen Sie eine Applikation mit diesem Image und machen Sie es verfügbar:

oc new-app web -l app=web
oc create route edge --service=web

Klicken Sie in der Web Console auf die Route, um die Website Ihrer Anwendung anzuzeigen.

Versuchen Sie, ein Easter-Egg unter der URL /easter-egg.txt hinzuzufügen. Wie würden Sie vorgehen? Untersuchen Sie "dev-labs/data/02_httpd" auf einen Hinweis.

Lösung     Fügen Sie im Dockerfile einen COPY-Befehl hinzu, um die Datei easter-egg.txt nach /var/www/html/ zu kopieren :
...
COPY ./easter-egg.txt /var/www/html/
...
Nach der Anpassung muss ein neuer Build gestartet werden.

Hat es funktioniert? -> https://web-[USERNAME]-docker-build.techlab-apps.openshift.ch/easter-egg.txt