Tag op persistent volume

Wat is Openshift

work in progress

Openshift is open source containerplatform op basis van RedHat linux. Openshift is een soort schil om Kubernetes heen met zowel een WebGUI als commandline tools. Met Openshift beheer je de containeromgeving, zo kunnen oa. eenvoudig builds worden gemaakt vanuit github repo’s.

De commandline

Hier volgen wat vaak terugkerende opdrachten waar ik regelmatig gebruik van maak.

Projecten

Wat binnen Openshift een project heet, heet op de commandline een namespace.

Aanmaken van een nieuw project:

oc create new-project <projectnaam>

Storage

De data binnen een container verdwijnt als de container verwijderd wordt, dat is uiteraard niet altijd gewenst. Denk bijv. aan data van een database of content van een website. Hiervoor wordt zgn. persistent storage aangemaakt, ofwel een pv. Als de pv bestaat kan hier middels een claim gebruik van gemaakt worden. Het koppelen van persistent storage ofwel blijvende data valt dus in 2 stappen uiteen: Het aanmaken van de pv en de claim vanuit de container er op.

Als we gebruik willen maken van een al bestaande pv (persistant volume) kan een lijst worden opgevraagd met:

oc get pv

Er wordt een overzicht getoond met oa. de naam, de grootte van de pv, de rechten, of de pv verwijderd wordt als het er aan gekoppelde project verwijderd word en aan welk project de pv gebound ofwel gekoppeld is.

Voorbeeld:

pvc-d355a45a-6d0f-4fc1-af9c-bfa40dd0de73 100Mi RWO Delete Bound git/gogs-conf ocs-storagecluster-1
pvc-b33dda94-1be2-4cb3-a960-afdbf74d007b 30Gi RWO Retain Bound mijntest/mongo-data-mongodb-0

Als een pv aangemaakt is met Delete waardoor de pv verwijderd wordt als bound word verwijderd kan de parameter persistentVolumeReclaimPolicy worden aangepast met:

oc edit pv

Zoek naar persistentVolumeReclaimPolicy en wijzig de waarde van Delete naar Retain.

NB: Dit dient vanuit de betreffende namespace te gebeuren, geef anders de parameter -n <namespace> mee om de juiste pv te editen.

De rechten van een pv kunnen n van de volgende drie zijn:

• ReadWriteMany : rw ook voor buiten de namespace
• ReadWriteOnce : rw alleen binnen de namespace
• ReadOnly : readonly binnen de namespace

Middels onderstaande yaml kan een pvc, persisitent storage claim worden gemaakt en word, indien Openshift zo ingericht is, ook de pv aangemaakt:

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: <naam v/d aan te maken pvc>
  labels:
    name: <label uit de namespace>
spec:
  accessModes:
   - ReadWriteMany
  resources:
  requests:
    storage: <grootte 100Mi/1Gi...>
  storageClassName: ocs-storage01
  volumeMode: Filesystem

Deze yaml kan worden uitgevoerd middels

oc apply -f <naam v/d yaml file>

Om te zien of de pvc aangemaakt is en dus klaar is om gemount te worden:

oc get pvc

Nu moet alleen nog de pvc gemount worden binnen de namespace, dit kan via een yaml file of door de parameters mee te geven op de commandline: oc set

oc set volume deployment/<deployment name> --add --mount-path=<mountpoint>

of via yaml:

apiVersion: v1
kind: Pod
spec:
 containers:
   volumeMounts:
   - name: <naam van de pvc>
    mountPath: <mountpath>
 volumes:
 - name: <naam de pv>
  persistentVolumeClaim:
    claimName: <naam v/d claim>

de ClaimName is een zelf te bedenken naam waarmee de claim op de pvc binnen Openshift bekend wordt gemaakt.

Het mounten van een bestaande directory zal een foutmelding geven. Om in een bestaande directory een file toe te voegen kan deze file worden toegevoegd aan het mountpath. Uiteraard moet de file zelf worden meegenomen in de yaml file of de inhoud ervan worden opgegeven.

—meer volgt binnenkort—