Skip to content

Latest commit

 

History

History
99 lines (68 loc) · 3.36 KB

11_template.md

File metadata and controls

99 lines (68 loc) · 3.36 KB

Lab 11: Applikationstemplates

In diesem Lab zeigen wir auf, wie Templates ganze Infrastrukturen beschreiben und entsprechend mit einem Befehl instanziert werden können.

Templates

Wie Sie in den vorangegangenen Labs gesehen haben, können einfach über die Eingabe unterschiedlicher Befehle Applikationen, Datenbanken, Services und deren Konfiguration erstellt und deployt werden.

Dies ist fehleranfällig und eignet sich schlecht zum Automatisieren.

OpenShift bietet dafür das Konzept von Templates, in welchen man eine Liste von Ressourcen beschreiben kann, die parametrisiert werden können. Sie sind also quasi ein Rezept für eine ganze Infrastruktur (bspw. 3 ApplikationsContainer, eine Datenbank mit Persistent Storage)

Note: der Clusteradmin kann globale Templates erstellen, welche allen Usern zur Verfügung stehen.

Alle vorhandenen Templates anzeigen

$ oc get template -n openshift

Über die Web Console kann dies via "Add to Project" gemacht werden, über diese Funktionalität können Templates direkt instanziert werden.

Diese Templates können im JSON-Format sowohl im Git Repository neben Ihrem Source Code abgelegt werden als auch über eine URL aufgerufen oder gar lokal im Filesystem abgelegt sein.

Aufgabe: LAB11.1: Template instanzieren.

Die einzelnen Schritte die wir in den vorherigen Labs manuell vorgenommen haben, können nun mittels Template in einem "Rutsch" durchgeführt werden.

$ oc new-project [USER]-template

Template erstellen

$ oc create -f https://raw.githubusercontent.com/appuio/example-spring-boot-helloworld/master/example-spring-boot-template.json

Template instanzieren

$ oc new-app example-spring-boot

--> Deploying template example-spring-boot for "example-spring-boot"
     With parameters:
      APPLICATION_DOMAIN=
      MYSQL_DATABASE_NAME=appuio
      MYSQL_USER=appuio
      MYSQL_PASSWORD=appuio
      MYSQL_DATASOURCE=jdbc:mysql://mysql/appuio?autoReconnect=true
      MYSQL_DRIVER=com.mysql.jdbc.Driver
--> Creating resources ...
    imagestream "example-spring-boot" created
    deploymentconfig "example-spring-boot" created
    deploymentconfig "mysql" created
    route "example-spring-boot" created
    service "example-spring-boot" created
    service "mysql" created
--> Success
    Run 'oc status' to view your app.

Mittels:

oc import-image example-spring-boot

wird das image importiert und das deployment gestartet.

Mittels:

oc rollout latest mysql

wird ebenso die Datenbank deployed

Tipp: Sie könnten Templates auch direkt verarbeiten in dem Sie ein Template direkt $ oc new-app -f template.json -p Param = value aufrufen

Als Abschluss dieses Labs können Sie sich noch das Template anschauen

https://github.com/appuio/example-spring-boot-helloworld/blob/master/example-spring-boot-template.json

Note: Bestehende Ressourcen können als Template exportiert werden, verwenden Sie dafür den oc export [ResourceType] --as-myapptemplate Command. Bspw.

oc export is,bc,dc,route,service --as-template=example-spring-boot -o json > example-spring-boot-template.json

Wichtig ist, dass die Imagestreams zuoberst im Template File definiert sind. Ansonsten wird der erste Build nicht funktionieren.

Ende Lab 11

Eigene Templates erstellen →

← zurück zur Übersicht