Rahti UKK

Tälle sivulle on koottu usein kysyttyjä kysymyksiä ja käytännön ohjeita Rahtin käyttöön, mukaan lukien projektien hallinta, resurssirajat, verkotus, tallennus ja sovellusten käyttöönotto.

Miten kirjaudun Rahtiin?

Siirry osoitteeseen Rahti ja napsauta Login

Rahti login

Tämän jälkeen sinulle näytetään sivu, jossa ovat kaikki Rahtin tukemat tunnistautumisvaihtoehdot. Valitse niistä sinulle sopivin; kaikkien identiteettiesi tulisi olla linkitetty samaan Rahti-tiliin.

Saadaksesi "kirjautumiskomennon", kirjaudu ensin selainkäyttöliittymään, napsauta sitten nimeäsi ja valitse "Copy Login Command". Tietoturvasyistä sinun täytyy kirjautua uudelleen. Sen jälkeen sinulle näytetään sivu, jolla on kirjautumiskomento. Voit kopioida sen leikepöydälle ja liittää sen mihin tahansa järjestelmässäsi avoinna olevaan päätteeseen.

Copy Login Command

Miten luon projektin?

Projektin voi luoda useasta kohdasta selainkäyttöliittymässä. Yksi tapa luoda projekti on siirtyä kohtaan Home > Projects

Napsauta sitten "Create Project".

Kentät ovat seuraavat:

Sinun täytyy valita yksilöllinen nimi, joka ei ole minkään muun järjestelmässä olevan projektin käytössä.
Voit myös antaa ihmiselle luettavan näyttönimen.
Sinun täytyy myös syöttää CSC:n laskentaprojekti Description-kenttään. Sen täytyy olla tällä hetkellä voimassa oleva CSC-projekti, johon tunnuksellasi on käyttöoikeus. Tarkista osoitteesta https://my.csc.fi, mihin CSC-projekteihin sinulla on käyttöoikeus. Jos CSC-projektinumerosi on 1000123, syötä Description-kenttään seuraava:

csc_project: 1000123

Miten näen kiintiöt ja rajat?

Tietyn projektin kiintiöt ja rajat löytyvät projektin tietosivun alareunasta.

Project page

Jos napsautat projektinumeroasi kohdan "AppliedClusterResourceQuotas" alta

Quota details

Mitkä ovat oletusrajat?

Jokaiselle Podille täytyy määrittää resurssien ala- ja ylärajat, erityisesti suorittimelle ja muistille. Alarajoja kutsutaan pyynnöiksi (requests) ja ylärajoja rajoiksi (limits). Pyynnöt määrittävät vähimmäisresurssit, joita Pod tarvitsee toimiakseen, eikä Pod saa käyttää enempää resursseja kuin rajoissa on määritetty. Käyttäjä voi asettaa rajat eksplisiittisesti käytettävissä olevan kiintiön puitteissa.

Rahtissa oletusrajat ovat:

    - resources:
        limits:
          cpu: 500m
          memory: 1Gi
        requests:
          cpu: 50m
          memory: 500Mi

Suositeltu tapa löytää sovelluksellesi sopivat arvot on yrityksen ja erehdyksen menetelmä. Käynnistä sovelluksesi Rahtissa ja seuraa muistin ja suorittimen kulutusta. Jos sovelluksesi saavuttaa muistirajan, se lopetetaan virheellä OutOfMemoryError (OOM), yleensä 137-virhekoodilla. Suoritin puolestaan käyttäytyy eri tavalla, eikä sovellusta lopeteta. Molempia rajoja tulee kuitenkin käsitellä samalla tavalla: jos huomaat, että jompikumpi raja saavutetaan, nosta rajaa ja yritä uudelleen. On suositeltavaa jättää vähintään pieni 10–20 %:n marginaali odotettujen rajojen yläpuolelle. Tämän vaiheen voi tietenkin ohittaa, jos tiedät jo sovelluksesi resurssitarpeet. Voit myös tutustua horisontaaliseen autoskaalaajaan, jonka avulla voit automaattisesti luoda ja poistaa Podiesi replikoita. Saatavuuden ja resurssien ajoituksen kannalta on parempi käyttää useita pienempiä Podeja, mutta kaikki sovellukset eivät tue tätä.

Miten muokkaan Deploymentin/DeploymentConfigin oletusrajoja?

Actions>EditResourceLimits

Resurssirajojen kasvattamiseen tai pienentämiseen voi käyttää selainkäyttöliittymää tai komentoriviä.

Selainkäyttöliittymässä siirry kohtaan Workloads -> Deployment, valitse deployment ja paina Actions > Edit resource limits. Sinulle näytetään valintaikkuna, jossa ovat suorittimen pyyntö ja raja sekä muistin pyyntö ja raja. Raja ei voi olla yli 5 kertaa suurempi kuin pyyntö. Pyyntö on vähimmäismäärä suoritinta (tai muistia), jota käyttöönotto tarvitsee toimiakseen, ja sitä käytetään Podin ajoittamiseen. Raja on suorittimen (tai muistin) suurin sallittu käyttö. Jos Pod yrittää käyttää enemmän muistia kuin raja sallii, Pod lopetetaan (OOMKilled). Jos taas Pod yrittää käyttää enemmän suoritinta kuin raja sallii, sitä vain rajoitetaan, mutta sitä ei lopeteta.

Edit ResourceLimits

DeploymentConfig on vanhentunut

DeploymentConfig on vanhentunut OpenShift OKD:n uudemmissa versioissa ja poistetaan kokonaan tulevaisuudessa. Katso Red Hatin ilmoitus DeploymentConfigin vanhentamisesta ja heidän korvaava ohjeensa DeploymentConfigille.

Miten luon routeja?

Oletus-URL-pääte

Rahti tarjoaa sovelluksille oletus-URL-osoitteet muodossa <whatever>.2.rahtiapp.fi.

Route voidaan luoda siirtymällä kohtaan Networking -> Routes.

Project page

Ja napsauttamalla sitten "Create Route"

Create Route

Routeja voidaan määrittää joko Form view- tai YAML view -näkymässä, jotka voi valita sivun yläreunasta.

Routella on kaksi pakollista parametria:

name, jonka täytyy olla yksilöllinen projektin sisällä.
service/port, johon liikenne ohjataan.

Muita valinnaisia parametreja ovat:

Hostname, jonka täytyy olla yksilöllinen Rahtissa. Jos sitä ei anneta, hostname luodaan automaattisesti routen name- ja project name -arvojen perusteella.
Path, jonka avulla vain tietty URL-polku ohjataan palveluun.
Service weight, joka määrittää, miten liikenne jaetaan, kun useat routet kohdistuvat samaan palveluun.
Secure Route voidaan ottaa käyttöön TLS-salauksen aktivoimiseksi (Rahti tukee vain TLS v1.3- ja v1.2 -versioita). Vaihtoehdot ovat samankaltaisia kuin kohdassa Rahti Routes

Miten muokkaan routea?

Routea voi muokata siirtymällä projektin tietosivulle, napsauttamalla Routea ja sitten sen routen nimeä, jota haluat muokata.

Napsauta sitten Actions > Edit Route. Routen YAML-esitys tulee näkyviin. Voit muokata sitä Concepts Route -sivun esimerkin mukaisesti. Jos haluat esimerkiksi lisätä TLS-tuen (https-tuki), sinun täytyy lisätä spec-osion sisään:

spec:
  tls:
    insecureEdgeTerminationPolicy: Redirect
    termination: edge

Tässä Redirect tarkoittaa, että route ohjaa käyttäjät automaattisesti http:stä https:ään.

Route modes

Mitä muutoksia palomuureihin täytyy tehdä?

Rahti käyttää kiinteää egress-IP-osoitetta lähtevälle liikenteelle. Rahtin nykyinen egress-IP-osoite on 86.50.229.150.

egress-IP voi muuttua

Rahtin egress-IP-osoite voi muuttua tulevaisuudessa. Esimerkiksi jos useita Rahtin versioita ajetaan rinnakkain, jokaisella on eri IP-osoite. Tai jos taustalla olevassa verkkoinfrastruktuurissa tapahtuu merkittävä muutos.

Joidenkin projektien, joilla on oma dedikoitu egress-IP-osoite, täytyy pyytää uusi dedikoitu IP-osoite Rahtiin ja päivittää palomuurinsa sen mukaisesti.

Miten poistan projektin?

Projektin voi poistaa projektin tietosivulta (Home > Projects) painamalla kolmea pistettä ja sitten Delete project. Näkyviin tulee valintaikkuna, jossa poistaminen vahvistetaan:

Delete Project

Projektin nimi (test tässä esimerkissä) täytyy kirjoittaa ennen kuin projekti poistetaan. Tällä vain vältetään vahinkopoistot.

Miten käytän tallennustilaa?

Siirry kohtaan Storage -> PersistentVolumeClaims ja napsauta sitten Create PersistentVolumeClaim.

Create PersistentVolumeClaim

Tällä hetkellä käytettävissä on vain yksi StorageClass (standard-csi). Se vastaa Cinder-taustaisia taltioita, joita vain yksi solmu voi lukea tai kirjoittaa (liittää). Jos haluat liittää sen useaan Podiin, sinun täytyy käyttää Pod affinity -ominaisuutta, jotta kaikki Podit luodaan samalle solmulle.
Projektin sisällä täytyy antaa yksilöllinen nimi.
StorageClass määrittää käyttötilaksi kiinteästi ReadWriteOnce (RWO), eikä sitä voi muuttaa.
Koko täytyy määrittää kiintiörajojen puitteissa.
Volume moden tulisi olla Filesystem. Block-tila on saatavilla, mutta tarkoitettu vain edistyneisiin käyttötapauksiin.

PVC:t voidaan myös luoda tai muokata käyttämällä Edit YAML -toimintoa edistyneisiin määrityksiin.

Taltion viivästetty luonti

Taltio luodaan vasta, kun se liitetään ensimmäisen kerran. Tämä on Rahtin nykyinen toimintatapa.

Miten luon Podin uudelleen Deploymentille, jolla on RWO-taltiot

Rahtin taltiot ovat ReadWriteOnce (RWO) -tyyppisiä, mikä tarkoittaa, että ne voidaan liittää vain yhteen Podiin kerrallaan.

Jos deploymentilla on liitetty taltio ja haluat päivittää deploymentin, muuta deployment-strategia arvosta "rolling update" arvoon "recreate". Siirry kohtaan Workloads -> Deployments, paina kolmea pistettä, napsauta "Edit update strategy" ja valitse sitten "recreate"

Action

Edit deployment stategy

Miten käytän integroitua rekisteriä

Jos haluat lisätietoja image-välimuistista ja käyttöoikeuksia hallitsevasta rekisteristä Rahtissa, katso seuraava artikkeli: Using Rahti Integrated Registry