Differences

This shows you the differences between two versions of the page.

--- chp:cli [2018/08/30 15:47] – [Download] ferry
+++ chp:cli [2026/05/27 14:01] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Openshift Command Line Interface ======
+:!: Let op! deze documentatie is nog volop in ontwikkeling :!:
+\\ \\
+====== Openshift Command Line Interface (oc) ======
 ===== Download =====
-De CLI is beschikbaar voor Windows, MacOS en Linux en is [[https://github.com/openshift/origin/releases/latest|hier te  downloaden]]
+De OpenShift CLI (openshift-client of 'oc') is beschikbaar voor Windows, MacOS en Linux en is [[https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/|hier te  downloaden]]
-===== Setup =====
+Nadat je met de OpenShift web console ingelogd bent, kan je via je userprofile (rechtsboven op je eigen naam klikken) het login commando kopieren (Copy login command -> display token)  en uitvoeren (oc login --token etc.). Je maakt hierbij gebruik van het "oc" commando die je met de bovenstaande link kan installeren.
+Meestal kun je, als je met "oc get" ergens informatie over kan opvragen, met "oc describe" uitgebreidere informatie opvragen.
+Over het algemeen is het "OC" commando zo ingedeeld:
+<code bash>
+oc <handeling> <resource-type> [<naam (optioneel)>]
+#EXAMPLE:
+oc get project myproject1
+</code>
+===== Bash/tab completion =====
 In MacOS en Linux kun je gebruik maken van tab completion, voor verschillende beschikbare shell's kun je de completion file genereren.
-Bijv. voor BASH :
+Bijv. voor BASH onder MacOS:
-<code>
+<code bash>
 oc completion bash > ~/.bash_oc_completion
+#direct inladen
 source ~/.bash_oc_completion
+#permanent inladen, kopieer de file naar de bash_completion directory
+cp ./bash_oc_completion /usr/local/etc/bash_completion.d/oc
 </code>
 ===== Inloggen =====
 Inloggen op de betreffende Openshift omgeving gaat via
-<code>
-oc login -u <user> <openshift_master_url>
+^commando ^ opties ^beschrijving^
-bijv. : oc login -u gebruiker https://master.chp.npohosting.nl:8443/
+| oc login  | -u <user> <openshift_master_url> | inloggen in openshift |
+| oc whoami || laat zien als welke user je bent ingelogt |
+| oc project || laat zien in welk project je werkt |
+<code bash>
+#bijvoorbeeld:
+oc login -u gebruiker https://master.chp.npohosting.nl:8443/
 </code>
-===== Handige commando's =====
-==== Project Management ====
+===== Project Management =====
-  * Laat beschikbare projecten zien
-<code>oc get projects</code>
-  * Maak een project aan
-<code>oc add project <project_name></code>
-  * Laat zien in welk project je momenteel werkt
-<code>oc project <project_name></code>
-  * Verander je huidige workspace naar een ander project
-<code>oc project <project_name></code>
-==== Gebruiker beheer ====
+^commando ^ opties ^beschrijving^
+| oc projects || Laat beschikbare projecten zien |
+| oc new-project || Maak een project aan |
+| oc project || Laat zien in welk project je momenteel werkt |
+| oc project <project_name> | | Verander je huidige workspace naar een ander project |
+==== Gebruikers rechten geven of ontnemen binnen projecten ====
 **Note : alleen een project admin kan deze commando's uitvoeren**
@@ Line 43: / Line 63: @@
   * Voeg project rol toe aan gebruiker
-<code>oc policy add-role-to-user <role> <user></code>
+<code bash>oc policy add-role-to-user <role> <user></code>
   * Voeg project rol toe aan groep
-<code>oc policy add-role-to-group <role> <group></code>
+<code bash>oc policy add-role-to-group <role> <group></code>
   * Verwijder project rol van gebruiker
-<code>oc policy remove-role-from-user <role> <user></code>
+<code bash>oc policy remove-role-from-user <role> <user></code>
   * Verwijder project rol van groep
-<code>oc policy remove-role-from-group <role> <group></code>
+<code bash>oc policy remove-role-from-group <role> <group></code>
   * Laat zien welke rollen er uitgedeeld zijn in het project
-<code>oc get rolebinding</code>
+<code bash>oc get rolebinding -o wide</code>
+//Bijvoorbeeld, je wilt gebruiker //
-==== Pod controle ====
+==== Status en informatie binnen je project ====
-  * Laat pods binnen het project zien
-<code>oc get pods</code>
+^commando ^ opties ^beschrijving^
-  * Zet een portforward op naar een pod
+|oc status| | laat alle services, deployment configs, build configurations, en actieve deployments zien binnen je project|
-<code>
+|oc logs | -f | Logs tonen van een object \\ -f voor persistent (vergelijkbaar met tail -f) |
+|oc get ev | |events tonen van het hele cluster |
+|oc get all | |list alle resource types binnen je project |
+|oc describe |	|uitgebreidere informatie listen over een resource type
+|oc get pods |-o wide | list alle pods (zoals met ps) \\ -o wide voor meer opties |
+==== Troubleshooting & debugging ====
+  * Direct vanaf je werkstation connectie maken. Zet een portforward op naar een pod:
+<code bash>
 oc port-forward <pod_name> <listen_port>:<port_in_pod>
-example mysql : oc port-forward mysql-1-ghb5q 6001:3306
+# example mysql : oc port-forward mysql-1-ghb5q 6001:3306
 mysql -p 6001 -h localhost -u <mysql_user> -p<mysql_pass> <mysql_database>
 </code>
+ * Direct commando's binnen een container uitvoeren
+<code bash>
+oc exec <pod> [-c <container> (optioneel] <commando>
+</code>
+==== Netwerk-gerelateerd ====
+^commando ^ opties ^beschrijving^
+|oc get svc| | list alle services binnen je project|
+|oc expose | --hostname| Route creëren \\ (zonder --hostname wordt het <route-name>-<project-name>.<default-domain> )|