OpenShift - Başlarken
OpenShift, GUI veya CLI ile uygulamalar oluşturmak ve dağıtmak için iki tür medyadan oluşur. Bu bölümde, yeni bir uygulama oluşturmak için CLI kullanacağız. OpenShift ortamı ile iletişim kurmak için OC istemcisini kullanıyor olacaktık.
Yeni Bir Uygulama Oluşturmak
OpenShift'te, yeni bir uygulama oluşturmanın üç yöntemi vardır.
- Bir kaynak koddan
- Bir görüntüden
- Bir şablondan
Kaynak Koddan
Kaynak koddan bir uygulama oluşturmaya çalıştığımızda, OpenShift, uygulama derleme akışını tanımlayan depo içinde bulunması gereken bir Docker dosyası arar. Bir uygulama oluşturmak için oc new-app kullanacağız.
Depo kullanırken akılda tutulması gereken ilk şey, OpenShift'in kodu çekip oluşturacağı depodaki bir kaynağa işaret etmesidir.
Depo, OC istemcisinin kurulu olduğu Docker makinesinde klonlanmışsa ve kullanıcı aynı dizindeyse, aşağıdaki komut kullanılarak oluşturulabilir.
$ oc new-app . <Hear. Denotes current working directory>Aşağıda, belirli bir şube için uzak depodan derlemeye çalışma örneği verilmiştir.
$ oc new-app https://github.com/openshift/Testing-deployment.git#test1Burada test1, OpenShift'te yeni bir uygulama oluşturmaya çalıştığımız daldır.
Depoda bir Docker dosyası belirtirken, aşağıda gösterildiği gibi build stratejisini tanımlamamız gerekir.
$ oc new-app OpenShift/OpenShift-test~https://github.com/openshift/Testingdeployment.gitBir Görüntüden
Görüntüleri kullanarak bir uygulama oluştururken, görüntüler yerel Docker sunucusunda, şirket içinde barındırılan Docker deposunda veya Docker hub'ında bulunur. Bir kullanıcının emin olması gereken tek şey, görüntüleri herhangi bir sorun olmadan hub'dan çekebilme erişimine sahip olmasıdır.
OpenShift, ister Docker görüntüsü ister kaynak akışı olsun, kullanılan kaynağı belirleme yeteneğine sahiptir. Ancak, kullanıcı isterse, bunun bir görüntü akışı mı yoksa bir Docker görüntüsü mü olduğunu açıkça tanımlayabilir.
$ oc new-app - - docker-image tomcatBir görüntü akışı kullanmak -
$ oc new-app tomcat:v1Bir Şablondan
Şablonlar, yeni bir uygulama oluşturmak için kullanılabilir. Zaten var olan bir şablon olabilir veya yeni bir şablon oluşturabilir.
Aşağıdaki yaml dosyası, temelde dağıtım için kullanılabilecek bir şablondur.
apiVersion: v1
kind: Template
metadata:
name: <Name of template>
annotations:
description: <Description of Tag>
iconClass: "icon-redis"
tags: <Tages of image>
objects:
- apiVersion: v1
kind: Pod
metadata:
name: <Object Specification>
spec:
containers:
image: <Image Name>
name: master
ports:
- containerPort: <Container port number>
protocol: <Protocol>
labels:
redis: <Communication Type>Bir Web Uygulaması Geliştirin ve Dağıtın
OpenShift'te Yeni Bir Uygulama Geliştirme
OpenShift'te yeni bir uygulama oluşturmak için, yeni bir uygulama kodu yazmalı ve OpenShift OC build komutlarını kullanarak onu oluşturmalıyız. Bahsettiğimiz gibi, yeni bir imaj yaratmanın birçok yolu var. Burada, uygulamayı oluşturmak için bir şablon kullanacağız. Bu şablon, oc new-app komutuyla çalıştırıldığında yeni bir uygulama oluşturacaktır.
Aşağıdaki şablon oluşturacaktır - İki ön uç uygulaması ve bir veritabanı. Bununla birlikte, iki yeni hizmet oluşturacak ve bu uygulamalar OpenShift kümesine konuşlandırılacaktır. Bir uygulama oluştururken ve dağıtırken, başlangıçta OpenShift'te bir ad alanı oluşturmamız ve uygulamayı bu ad alanı altında konuşlandırmamız gerekir.
Create a new namespace
$ oc new-project openshift-test --display-name = "OpenShift 3 Sample" --
description = "This is an example project to demonstrate OpenShift v3"Şablon
{
"kind": "Template",
"apiVersion": "v1",
"metadata": {
"name": "openshift-helloworld-sample",
"creationTimestamp": null,
"annotations": {
"description": "This example shows how to create a simple openshift
application in openshift origin v3",
"iconClass": "icon-openshift",
"tags": "instant-app,openshift,mysql"
}
}
},Nesne Tanımları
Secret definition in a template
"objects": [
{
"kind": "Secret",
"apiVersion": "v1",
"metadata": {"name": "dbsecret"},
"stringData" : {
"mysql-user" : "${MYSQL_USER}",
"mysql-password" : "${MYSQL_PASSWORD}"
}
},Service definition in a template
{
"kind": "Service",
"apiVersion": "v1",
"metadata": {
"name": "frontend",
"creationTimestamp": null
},
"spec": {
"ports": [
{
"name": "web",
"protocol": "TCP",
"port": 5432,
"targetPort": 8080,
"nodePort": 0
}
],
"selector": {"name": "frontend"},
"type": "ClusterIP",
"sessionAffinity": "None"
},
"status": {
"loadBalancer": {}
}
},Route definition in a template
{
"kind": "Route",
"apiVersion": "v1",
"metadata": {
"name": "route-edge",
"creationTimestamp": null,
"annotations": {
"template.openshift.io/expose-uri": "http://{.spec.host}{.spec.path}"
}
},
"spec": {
"host": "www.example.com",
"to": {
"kind": "Service",
"name": "frontend"
},
"tls": {
"termination": "edge"
}
},
"status": {}
},
{
"kind": "ImageStream",
"apiVersion": "v1",
"metadata": {
"name": "origin-openshift-sample",
"creationTimestamp": null
},
"spec": {},
"status": {
"dockerImageRepository": ""
}
},
{
"kind": "ImageStream",
"apiVersion": "v1",
"metadata": {
"name": "openshift-22-ubuntu7",
"creationTimestamp": null
},
"spec": {
"dockerImageRepository": "ubuntu/openshift-22-ubuntu7"
},
"status": {
"dockerImageRepository": ""
}
},Build config definition in a template
{
"kind": "BuildConfig",
"apiVersion": "v1",
"metadata": {
"name": "openshift-sample-build",
"creationTimestamp": null,
"labels": {name": "openshift-sample-build"}
},
"spec": {
"triggers": [
{ "type": "GitHub",
"github": {
"secret": "secret101" }
},
{
"type": "Generic",
"generic": {
"secret": "secret101",
"allowEnv": true }
},
{
"type": "ImageChange",
"imageChange": {}
},
{ "type": "ConfigChange”}
],
"source": {
"type": "Git",
"git": {
"uri": https://github.com/openshift/openshift-hello-world.git }
},
"strategy": {
"type": "Docker",
"dockerStrategy": {
"from": {
"kind": "ImageStreamTag",
"name": "openshift-22-ubuntu7:latest”
},
"env": [
{
"name": "EXAMPLE",
"value": "sample-app"
}
]
}
},
"output": {
"to": {
"kind": "ImageStreamTag",
"name": "origin-openshift-sample:latest"
}
},
"postCommit": {
"args": ["bundle", "exec", "rake", "test"]
},
"status": {
"lastVersion": 0
}
}
},Deployment config in a template
"status": {
"lastVersion": 0
}
{
"kind": "DeploymentConfig",
"apiVersion": "v1",
"metadata": {
"name": "frontend",
"creationTimestamp": null
}
},
"spec": {
"strategy": {
"type": "Rolling",
"rollingParams": {
"updatePeriodSeconds": 1,
"intervalSeconds": 1,
"timeoutSeconds": 120,
"pre": {
"failurePolicy": "Abort",
"execNewPod": {
"command": [
"/bin/true"
],
"env": [
{
"name": "CUSTOM_VAR1",
"value": "custom_value1"
}
]
}
}
}
}
}
"triggers": [
{
"type": "ImageChange",
"imageChangeParams": {
"automatic": true,
"containerNames": [
"openshift-helloworld"
],
"from": {
"kind": "ImageStreamTag",
"name": "origin-openshift-sample:latest"
}
}
},
{
"type": "ConfigChange"
}
],
"replicas": 2,
"selector": {
"name": "frontend"
},
"template": {
"metadata": {
"creationTimestamp": null,
"labels": {
"name": "frontend"
}
},
"spec": {
"containers": [
{
"name": "openshift-helloworld",
"image": "origin-openshift-sample",
"ports": [
{
"containerPort": 8080,
"protocol": "TCP”
}
],
"env": [
{
"name": "MYSQL_USER",
"valueFrom": {
"secretKeyRef" : {
"name" : "dbsecret",
"key" : "mysql-user"
}
}
},
{
"name": "MYSQL_PASSWORD",
"valueFrom": {
"secretKeyRef" : {
"name" : "dbsecret",
"key" : "mysql-password"
}
}
},
{
"name": "MYSQL_DATABASE",
"value": "${MYSQL_DATABASE}"
}
],
"resources": {},
"terminationMessagePath": "/dev/termination-log",
"imagePullPolicy": "IfNotPresent",
"securityContext": {
"capabilities": {},
"privileged": false
}
}
],
"restartPolicy": "Always",
"dnsPolicy": "ClusterFirst"
},
"status": {}
},Service definition in a template
{
"kind": "Service",
"apiVersion": "v1",
"metadata": {
"name": "database",
"creationTimestamp": null
},
"spec": {
"ports": [
{
"name": "db",
"protocol": "TCP",
"port": 5434,
"targetPort": 3306,
"nodePort": 0
}
],
"selector": {
"name": "database
},
"type": "ClusterIP",
"sessionAffinity": "None" },
"status": {
"loadBalancer": {}
}
},Deployment config definition in a template
{
"kind": "DeploymentConfig",
"apiVersion": "v1",
"metadata": {
"name": "database",
"creationTimestamp": null
},
"spec": {
"strategy": {
"type": "Recreate",
"resources": {}
},
"triggers": [
{
"type": "ConfigChange"
}
],
"replicas": 1,
"selector": {"name": "database"},
"template": {
"metadata": {
"creationTimestamp": null,
"labels": {"name": "database"}
},
"template": {
"metadata": {
"creationTimestamp": null,
"labels": {
"name": "database"
}
},
"spec": {
"containers": [
{
"name": "openshift-helloworld-database",
"image": "ubuntu/mysql-57-ubuntu7:latest",
"ports": [
{
"containerPort": 3306,
"protocol": "TCP"
}
],
"env": [
{
"name": "MYSQL_USER",
"valueFrom": {
"secretKeyRef" : {
"name" : "dbsecret",
"key" : "mysql-user"
}
}
},
{
"name": "MYSQL_PASSWORD",
"valueFrom": {
"secretKeyRef" : {
"name" : "dbsecret",
"key" : "mysql-password"
}
}
},
{
"name": "MYSQL_DATABASE",
"value": "${MYSQL_DATABASE}"
}
],
"resources": {},
"volumeMounts": [
{
"name": "openshift-helloworld-data",
"mountPath": "/var/lib/mysql/data"
}
],
"terminationMessagePath": "/dev/termination-log",
"imagePullPolicy": "Always",
"securityContext": {
"capabilities": {},
"privileged": false
}
}
],
"volumes": [
{
"name": "openshift-helloworld-data",
"emptyDir": {"medium": ""}
}
],
"restartPolicy": "Always",
"dnsPolicy": "ClusterFirst”
}
}
},
"status": {}
},
"parameters": [
{
"name": "MYSQL_USER",
"description": "database username",
"generate": "expression",
"from": "user[A-Z0-9]{3}",
"required": true
},
{
"name": "MYSQL_PASSWORD",
"description": "database password",
"generate": "expression",
"from": "[a-zA-Z0-9]{8}",
"required": true
},
{
"name": "MYSQL_DATABASE",
"description": "database name",
"value": "root",
"required": true
}
],
"labels": {
"template": "application-template-dockerbuild"
}
}Yukarıdaki şablon dosyasının bir defada derlenmesi gerekir. Önce tüm içeriği tek bir dosyaya kopyalayıp, bittiğinde bunu bir yaml dosyası olarak adlandırmamız gerekiyor.
Uygulamayı oluşturmak için aşağıdaki komutu çalıştırmamız gerekiyor.
$ oc new-app application-template-stibuild.json
--> Deploying template openshift-helloworld-sample for "application-template-stibuild.json"
openshift-helloworld-sample
---------
This example shows how to create a simple ruby application in openshift origin v3
* With parameters:
* MYSQL_USER = userPJJ # generated
* MYSQL_PASSWORD = cJHNK3se # generated
* MYSQL_DATABASE = root
--> Creating resources with label app = ruby-helloworld-sample ...
service "frontend" created
route "route-edge" created
imagestream "origin-ruby-sample" created
imagestream "ruby-22-centos7" created
buildconfig "ruby-sample-build" created
deploymentconfig "frontend" created
service "database" created
deploymentconfig "database" created
--> Success
Build scheduled, use 'oc logs -f bc/ruby-sample-build' to track its progress.
Run 'oc status' to view your app.Yapıyı izlemek istersek, bunu kullanarak yapılabilir -
$ oc get builds
NAME TYPE FROM STATUS STARTED DURATION
openshift-sample-build-1 Source Git@bd94cbb Running 7 seconds ago 7sOpenShift'te konuşlandırılmış uygulamaları şu şekilde kontrol edebiliriz -
$ oc get pods
NAME READY STATUS RESTARTS AGE
database-1-le4wx 1/1 Running 0 1m
frontend-1-e572n 1/1 Running 0 27s
frontend-1-votq4 1/1 Running 0 31s
opeshift-sample-build-1-build 0/1 Completed 0 1mUygulama hizmetlerinin hizmet tanımına göre oluşturulup oluşturulmadığını kontrol edebiliriz.
$ oc get services
NAME CLUSTER-IP EXTERNAL-IP PORT(S) SELECTOR AGE
database 172.30.80.39 <none> 5434/TCP name=database 1m
frontend 172.30.17.4 <none> 5432/TCP name=frontend 1m