Hulpartikel overzicht

Hulpartikel

Quickstart handleiding Kubernetes

Kubernetes, ook bekend als K8s, is een open-source systeem voor het automatiseren van deployment, schalen en beheer van gecontainerizeerde applicaties.

Het TransIP Kubernetes-platform bevindt zich momenteel in een gesloten alpha-stadium en maakt gebruik van een nieuwe versie van het TransIP-controlepaneel. Kun jij niet wachten en wil je nu, of in de beta mee testen? Laat het ons weten!

In deze Kubernetes quickstart-handleiding laten we zien hoe je begint met Kubernetes: waar plaats je je kubeconfig-file en hoe maak je gebruik van Kubectl om met je Kubernetes-cluster te verbinden en de status daarvan te controleren.

  • Installeer voor je deze handleiding doorloopt Kubectl op je computer of laptop, zie onze Kubectl-installatiehandleiding.
  • De downloadprocedure van de Kubeconfig-file wordt tijdens de alpha aangepast. Deze documentatie zal daar tz..t op worden aangepast.

Verbinden met je Kubernetes-cluster vanuit Windows

 

Om te kunnen verbinden met je Kubernetes-cluster heb je de Kubeconfig data nodig die je in de vorige paragraaf hebt gedownload. In deze paragraaf laten we zien waar je deze configuratie plaatst en hoe je vervolgens de bereikbaarheid van je Kubernetes-cluster test.

 

Stap 1

Start de command prompt CMD door op de Window Start-knop te drukken, te zoeken op 'CMD' en het resultaat aan te klikken.

windows start cmd


 

Stap 2

De directory waar je configuratie in wordt opgeslagen bestaat zeer waarschijnlijk nog niet. Je maakt deze aan met de volgende commando's:

cd %USERPROFILE%
mkdir .kube
cd .kube
  • De cd commando's plaatsen je in respectievelijk de %USERPROFILE% directory (bijv c:\users\gebruiker) en de .kube directory binnen die %USERPROFILE% directory.
  • Het mkdir-commando maakt een directory aan

 

Stap 3

Sluit de command prompt nog niet af, die heb je bij stap 4 weer nodig.

Na het bestellen van je Kubernetes-cluster ontvang je een e-mail met daarin een linkje naar het overzicht van je Kubernetes-cluster in het (nieuwe) TransIP-controlepaneel.

Open de e-mail en klik op de link.

Je komt nu in het nieuwe TransIP-controlepaneel en krijgt een overzicht te zien zoals in het voorbeeld hieronder.

cp k8s overview download kubecfg

Klik op 'Download Kubeconfig' om je Kubeconfig-file te downloaden (dit bestand heet 'config' en heeft geen extensie) naar de directory die je in stap 2 hebt aangemaakt (bijvoorbeeld c:\username\.kube).

De 'Cluster ID' is ook de naam van jouw Kubernetes-cluster. Je cluster is ook onder deze naam terug te vinden in het overzicht van jouw producten en bij het gebruik van onze API.


 

 

Stap 4

Ga terug naar de command prompt en test de bereikbaarheid van je Kubernetes-cluster met het volgende commando:

kubectl get nodes

Je krijgt nu een output te zien die lijkt op:

NAME                                   STATUS   ROLES    AGE   VERSION
299eb31a-74a0-405a-8478-4b3c351b838d   Ready    <none>   13d   v1.23.2
849d476c-cf61-4e57-b364-2ef30a462397   Ready    <none>   13d   v1.23.2
d7ea2186-c226-4111-af30-048c439c778b   Ready    <none>   13d   v1.23.2

Gefeliciteerd! Je kunt nu verder aan de slag met je Kubernetes-cluster.

Voor het exposen van een service via de (door HA-IP Pro aangedreven) loadbalancers, zie deze handleiding.

Neem een kijkje op Kubernetes-website voor een uitgebreide cheatsheet met beschikbare commando's voor Kubectl. Tijdens de Alpha van ons Kubernetes-platform breiden wij onze documentatie verder uit met o.a. voorbeelden hoe je bepaalde use case configureert, zoals het hosten van een website.


Verbinden met je Kubernetes-cluster vanuit Linux/MacOS

 

Om te kunnen verbinden met je Kubernetes-cluster heb je de Kubeconfig data nodig die je in de vorige paragraaf hebt gedownload. In deze paragraaf laten we zien waar je deze configuratie plaatst en hoe je vervolgens de bereikbaarheid van je Kubernetes-cluster test.

 

Stap 1

Start eerst een Terminal.De directory waar je configuratie in wordt opgeslagen bestaat zeer waarschijnlijk nog niet. Maak deze aan en corrigeer de rechten met de commando's:

mkdir ~/.kube
chmod 644 ~/.kube

Met het laatste commando geef je respectievelijk je gebruiker, de primaire groep waar die gebruiker onder valt en andere accounts lees & schrijf, lees, en lees rechten.


 

Stap 2

Sluit de terminal nog niet af, die heb je bij stap 3 weer nodig.

Na het bestellen van je Kubernetes-cluster ontvang je een e-mail met daarin een linkje naar het overzicht van je Kubernetes-cluster in het (nieuwe) TransIP-controlepaneel.

Open de e-mail en klik op de link.

Je komt nu in het nieuwe TransIP-controlepaneel en krijgt een overzicht te zien zoals in het voorbeeld hieronder.

cp k8s overview download kubecfg

Klik op 'Download Kubeconfig' om je Kubeconfig-file te downloaden naar de directory die je in stap 1 hebt aangemaakt (bijvoorbeeld ~\.kube).

 

MacOS:

Het bestand heet config en heeft eigenlijk geen extensie, maar MacOS voegt automatisch de .yaml-extensie toe. Hernoem daarom het bestand om de extensie weer te verwijderen, bijvoorbeeld:

mv ~\.kube\config.yaml ~\.kube\config

 

Stap 3

Test de bereikbaarheid van je Kubernetes-cluster met het volgende commando:

kubectl get nodes

Je krijgt een output te zien die lijkt op:

NAME                                   STATUS   ROLES    AGE   VERSION
299eb31a-74a0-405a-8478-4b3c351b838d   Ready    <none>   13d   v1.23.2
849d476c-cf61-4e57-b364-2ef30a462397   Ready    <none>   13d   v1.23.2
d7ea2186-c226-4111-af30-048c439c778b   Ready    <none>   13d   v1.23.2

Gefeliciteerd! Je kunt nu verder aan de slag met je Kubernetes-cluster. Neem ook een kijkje op Kubernetes-website voor een uitgebreide cheatsheet met beschikbare commando's voor Kubectl. Tijdens de Alpha van ons Kubernetes-platform breiden wij onze documentatie verder uit met o.a. voorbeelden hoe je bepaalde use case configureert, zoals het hosten van een website.

Heb je ook een goed idee?

Stuur jouw idee in! Met genoeg stemmen komt jouw idee op onze wishlist!

Heeft dit artikel je geholpen?

Maak een account aan of log in om een beoordeling achter te laten.

Reacties

Maak een account aan of log in om een reactie te plaatsen.

0
Matthijs van Beek Admin 11 november 2022 (#9077)

@spruce,

Bedankt voor je feedback! MacOS blijkt inderdaad automatisch de extensie toe te voegen. We hebben de documentatie hierop aangepast.

0
spruce 7 november 2022 (#9056)

"dit bestand heet 'config' en heeft geen extensie"

echter je krijgt een .yml file

Kom je er niet uit?

Ontvang persoonlijke hulp van onze supporters

Neem contact op