3 - Ohjeet

Dokumentaatiota:

4 - Linkkejä dokumentaatioihin

RedHatin pikakurssi OpenShftiin ja kontteihin (selitetään mitä ja miksi ja annetaan käytännön esimerkkejä, jotkin asiat kuitenkin tämän wikin ohjeissa selkeämmin ja/tai kattavammin)

Ohjeita tavanomaisten tilanteiden ratkaisuun:Sovellus ei toimi openshiftissä vaikka se toimii kuberneteksessa / docker swarmilla / docker-composella?Kyseessä on luultavasti oikeuksiin liittyvä ongelma. 3.4 Konttiprosessien UID:t OpenShiftissä

Miten saan sovelluksen palvelemaan konttialustan ulkopuolista maailmaa (sisä+eteisverkko tai ulkoverkko)?Tarvitset sovelluksen jonka portti on paljastettu OpenShiftissä (esim Dockerfilessä: expose 3000), palvelun, joka kuuntelee TCP-protokollalla samaa porttia ja Routen, joka liittyy Service-objektiin. Route avaa portin joko sisä+eteisverkkoon tai ulkoverkkoon. Tarkemmat ohjeet alla.

• 3.7 Miten julkaisen sovellukseni internetiin?

Lähtökohdat, alkuoletukset, perusteet:

1. Openshiftissä on oltava projekti, johon kontit pystytetään. Projektin luontiin on oikeudet vain konttiklusterin ylläpidolla. Ohjeet projektin tilaamiseen.
2. Softan koodin pitää olla git repositoryssä, johon openshiftistä pääsee kiinni. HUOM! Webhookit toimivat vain version.helsinki.fi Gitlabista.
3. Kukin repositoryn haara voidaan tarvittaessa mapata erillisiin Openshift-applikaatioihin. Kontin seuraamaa haaraa pystyy myös muuttamaan.
4. Gitissä tehdyt muutokset koodiin saadaan julkaistua Openshiftiin automaattisesti webhookeilla tai vaihtoehtoisesti painamalla build-nappia Openshift-projektissa
5. Softan käyttämät konfiguraatiot (ympäristömuuttujat  kuten tietokannan osoitteet, rajapintojen osoitteet yms.) laitetaan openshiftin configmappeihin ja secretteihin
   1. https://docs.openshift.com/container-platform/4.10/nodes/pods/nodes-pods-configmaps.html
      
      1. Vanha ohje: https://docs.openshift.com/container-platform/3.7/dev_guide/configmaps.html
   2. https://docs.openshift.com/container-platform/4.6/nodes/pods/nodes-pods-secrets.html
      1. Vanha ohje:https://docs.openshift.com/container-platform/3.7/dev_guide/secrets.html

Kantapään kautta opitut:

• Sovellusten deploy yml-tiedostot (myös Routen ja Servicen) kannattaa ottaa talteen, esim versionhallintaan. Ensimmäinen deploy kannattaa tehdä web-käyttöliittymällä.
  • Kun yamlit tallessa, voi kaiken laittaa takaisin pystyyn kätevästi Openshift CLI:llä tai käyttöliittymän oikeassa yläreunassa olevasta '+' - napista.
  • Etuna worst case -tilanteessa, jos esim koko klusteri hajoaa tai projekti kosahtaa → yhdellä komennolla taas pystyssä.

Lisämateriaalia:

• Yleistä konteista ja Kuberneteksesta:  https://btholt.github.io/complete-intro-to-containers/
• https://workgroups.helsinki.fi/pages/viewpage.action?pageId=164402789#Yleisi%C3%A4ohjeitakehitt%C3%A4jille-Routet,Servicet,Podit,Kontit,APUA