OpenShift Client: Instalasi dan Operasi Dasar

Instalasi dan operasi dasar OpenShift Client (OC)

OKD adalah sebuah platform untuk mengembangkan dan menjalankan aplikasi yang containerized. OKD didesain untuk membuat aplikasi dan data center yang terhubung dapat bekembang dari hanya beberapa mesin dan aplikasi menjadi ribuan mesin yang melayani jutaan clients. Dengan pondasinya di Kubernetes, OKD menggunakan teknologi yang sama yang berperan sebagai engine untuk berbagai macam aplikasi.

OpenShift (OKD) Client membantu kita untuk develop, build, deploy, dan run aplikasi pada platform OpenShift atau Kubernetes.

Dengan OKD command line interface (CLI), kita bisa membuat aplikasi dan mengatur project OKD melalui terminal. CLI ini sangat berguna dalam situasi seperti:

• Mengerjakan source code project
• Membuat script untuk operation OKD
• Ada keterbatasan bandwidth dan tidak bisa menggunakan web console

sumber: https://spiritedengineering.net/wp-content/uploads/2019/07/openshift.png

Installation

Download oc client tools: https://www.okd.io/download.html#oc-platforms
Di bawah tulisan “Download the latest OKD4 Release” klik “Latest Release”. Pada halaman berikutnya scroll ke bawah dan pilih file sesuai OS.

Lalu cek lokasi PATH di terminal, dan pindahkan binary oc ke lokasi tersebut.

echo $PATH //macOS
path //Windows

Untuk Windows, jika ingin membuat folder baru, tambahkan pada path folder tersebut pada Environment Variables di Control Panel. Lalu pindahkan file tadi yang sudah di-extract ke folder tersebut.

Untuk macOS, CLI juga bisa diinstal menggunakan Homebrew:

brew install openshift-cli

Jika berhasil, seharusnya akan muncul versi oc saat command “oc version” dijalankan.

Alex:~ alexanderang$ oc version
oc v3.11.0+0cbc58b
kubernetes v1.11.0+d4cacc0
features: Basic-Auth

Operation

Langkah selanjutnya adalah login ke okd server. Buka openshift dan pada pojok kanan atas klik menu user lalu pilih “Copy Login Command”, lalu paste di terminal.

Alex:~ alexanderang$ oc login https://xxxxx:8080 --token=[REDACTED]
Logged into "https://xxxxx:8080" as "alexander" using the token provided.
You have access to 73 projects, the list has been suppressed. You can list all projects with 'oc projects'
Using project "test-project".

Beberapa command basic yg sering digunakan:

• oc projects: list semua project

Alex:~ alexanderang$ oc projects
You have access to the following projects and can switch between them with 'oc project <projectname>':
    project1
    project2
    project3
    project4
    project5
    ....

• oc project: melihat project yg digunakan saat ini

Alex:~ alexanderang$ oc project
Using project "test-project" on server "https://xxxxx:8080".

• oc project <project_name>: switch ke project tersebut

Alex:~ alexanderang$ oc project test-project
Now using project "test-project" on server "https://xxxxx:8080".

• oc status: overview dari project yg sedang digunakan

Alex:~ alexanderang$ oc status
In project test-project on server https://xxxxx:8080
http://test-project-dev.xxx.xx.xxx.xx to pod port 8080-tcp (svc/test-project)
  dc/test-project deploys docker.xxxxx.com/test-project:latest 
    deployment #13 deployed 4 days ago - 1 pod
    deployment #12 deployed 5 days ago
    deployment #11 deployed 6 days ago
svc/test-project-db - xxx.xx.xxx.xx:5432
  dc/test-project-db deploys docker.xxxxx.com/test-project-db:latest
    deployment #4 deployed 4 days ago - 1 pod
    deployment #3 failed 6 days ago: manual change
2 infos identified, use 'oc status --suggest' to see details.

• oc get <object_type>: menampilkan list dari object type tersebut. Jenis object type dapat dilihat pada: https://docs.okd.io/1.5/cli_reference/basic_cli_operations.html#object-types

Alex:~ alexanderang$ oc get job
NAME                                       DESIRED   SUCCESSFUL  AGE
cron-job-trigger-refund-expiry-1592601900  1         1           3d
cron-job-trigger-refund-retry-1592601960   1         1           3d

• oc logout: keluar dari session
• oc help: menampilkan list command
• oc <command> — help: menampilkan informasi mengenai command tersebut

Selengkapnya dapat dilihat pada: https://docs.okd.io/1.5/cli_reference/basic_cli_operations.html

Referensi

• https://docs.okd.io/1.5/cli_reference/get_started_cli.html
• https://docs.okd.io/1.5/cli_reference/basic_cli_operations.html
• https://docs.okd.io/latest/architecture/architecture.html