OpenShift - CLI
OpenShift CLI viene utilizzato per gestire le applicazioni OpenShift dalla riga di comando. OpenShift CLI ha la capacità di gestire il ciclo di vita delle applicazioni end-to-end. In generale, utilizzeremmo OC che è un client OpenShift per comunicare con OpenShift.
Configurazione della CLI di OpenShift
Per configurare il client OC su un sistema operativo diverso, è necessario eseguire diverse sequenze di passaggi.
OC Client per Windows
Step 1 - Scarica l'oc cli dal seguente link https://github.com/openshift/origin/releases/tag/v3.6.0-alpha.2
Step 2 - Decomprimere il pacchetto su un percorso di destinazione sulla macchina.
Step 3 - Modifica la variabile d'ambiente del percorso del sistema.
C:\Users\xxxxxxxx\xxxxxxxx>echo %PATH%
C:\oraclexe\app\oracle\product\10.2.0\server\bin;C:\Program Files
(x86)\Intel\iCLS Client\;C:\Program Files\Intel\iCLS Client\;C:\Program Files
(x86)\AMD APP\bin\x86_64;C:\Program Files (x86)\AMD APP\bin\x86;
C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\
v1.0\;C:\Program Files (x86)\Windows Live\Shared;C:\Program Files
(x86)\ATI Technologies\ATI.ACE\C
ore-Static;C:\Program Files\Intel\Intel(R) Management Engine
Components\DAL;C:\Program Files\Intel\Intel(R) Management Engine
Components\IPT;C:\Program Files (x86)\Intel\Intel(R) Management Engine Components\DAL;
Step 4 - Convalida la configurazione OC su Windows.
C:\openshift-origin-client-tools-v3.6.0-alpha.2-3c221d5-windows>oc version
oc v3.6.0-alpha.2+3c221d5
kubernetes v1.6.1+5115d708d7
features: Basic-Auth
OC Client per Mac OS X
Possiamo scaricare i file binari di installazione di Mac OS per la stessa posizione di Windows e successivamente decomprimerlo in una posizione e impostare un percorso di eseguibile nella variabile PATH dell'ambiente.
Alternatively
Possiamo usare Home brew e configurarlo usando il seguente comando.
$ brew install openshift-cli
OC Client per Linux
Nella stessa pagina, abbiamo il file tar per l'installazione di Linux che può essere utilizzato per l'installazione. Successivamente, è possibile impostare una variabile di percorso che punta a quella particolare posizione eseguibile.
https://github.com/openshift/origin/releases/tag/v3.6.0-alpha.2
Decomprimere il file tar utilizzando il seguente comando.
$ tar –xf < path to the OC setup tar file >
Eseguire il comando seguente per verificare l'autenticazione.
C:\openshift-origin-client-tools-v3.6.0-alpha.2-3c221d5-windows>oc login
Server [https://localhost:8443]:
File di configurazione CLI
Il file di configurazione OC CLI viene utilizzato per gestire la connessione di più server OpenShift e il meccanismo di autenticazione. Questo file di configurazione viene utilizzato anche per memorizzare e gestire più profili e per passare da uno all'altro. Un normale file di configurazione è simile al seguente.
$ oc config view
apiVersion: v1
clusters:
- cluster:
server: https://vklnld908.int.example.com
name: openshift
contexts:
- context:
cluster: openshift
namespace: testproject
user: alice
name: alice
current-context: alice
kind: Config
preferences: {}
users:
- name: vipin
user:
token: ZCJKML2365jhdfafsdj797GkjgjGKJKJGjkg232
Configurazione del client CLI
Per impostare le credenziali dell'utente
$ oc config set-credentials <user_nickname>
[--client-certificate = <path/to/certfile>] [--client-key=<path/to/keyfile>]
[--token = <bearer_token>] [--username = <basic_user>] [--password = <basic_password>]
Per l'impostazione del cluster
$ oc config set-cluster <cluster_nickname> [--server = <master_ip_or_fqdn>]
[--certificate-authority = <path/to/certificate/authority>]
[--api-version = <apiversion>] [--insecure-skip-tls-verify = true]
Esempio
$ oc config set-credentials vipin --token = ZCJKML2365jhdfafsdj797GkjgjGKJKJGjkg232
Per impostare il contesto
$ oc config set-context <context_nickname> [--cluster = <cluster_nickname>]
[--user = <user_nickname>] [--namespace = <namespace>]
Profili CLI
In un singolo file di configurazione CLI, possiamo avere più profili in cui ogni profilo ha una diversa configurazione del server OpenShift, che in seguito può essere utilizzata per passare da diversi profili CLI.
apiVersion: v1
clusters: --→ 1
- cluster:
insecure-skip-tls-verify: true
server: https://vklnld908.int.example.com:8443
name: vklnld908.int.example.com:8443
- cluster:
insecure-skip-tls-verify: true
server: https://vklnld1446.int.example.com:8443
name: vklnld1446.int.example.com:8443
contexts: ---→ 2
- context:
cluster: vklnld908.int.example.com:8443
namespace: openshift-project
user: vipin/vklnld908.int.example.com:8443
name: openshift-project/vklnld908.int.example.com:8443/vipin
- context:
cluster: vklnld908.int.example.com:8443
namespace: testing-project
user: alim/vklnld908.int.example.com:8443
name: testproject-project/openshift1/alim
current-context: testing-project/vklnld908.int.example.com:8443/vipin - 3
kind: Config
preferences: {}
users:
- name: vipin/vklnld908.int.example.com:8443
user: ---→ 4
token: ZCJKML2365jhdfafsdj797GkjgjGKJKJGjkg232
Nella configurazione sopra, possiamo vedere che è diviso in quattro sezioni principali a partire dal cluster che definisce due istanze di macchine master OpenShift. La seconda sezione del contesto definisce due contesti denominati vipin e alim. Il contesto corrente definisce quale contesto è attualmente in uso. Può essere cambiato in un altro contesto o profilo, se cambiamo la definizione qui. Infine viene definita la definizione dell'utente e il suo token di autenticazione che nel nostro caso è vipin.
Se vogliamo controllare il profilo corrente in uso, può essere fatto usando -
$ oc status
oc status
In project testing Project (testing-project)
$ oc project
Using project "testing-project" from context named "testing-
project/vklnld908.int.example.com:8443/vipin" on server "https://vklnld908.int.example.com:8443".
Se vogliamo passare ad un'altra CLI, può essere fatto dalla riga di comando utilizzando il seguente comando.
$ oc project openshift-project
Now using project "Openshift-project" on server "
https://vklnld908.int.example.com:8443".
Usando il comando precedente, possiamo passare da un profilo all'altro. In qualsiasi momento, se desideriamo visualizzare la configurazione, possiamo usare il comando $ oc config view.