نشر تطبيق Kotlin على Kubernetes: دليل خطوة بخطوة

نشر Kotlin على Kubernetes: دليل أساسي عملي

التطوير الحديث يتطلب بشكل متزايد ليس فقط كتابة كود عالي الجودة، ولكن أيضًا نشره بشكل صحيح. أصبح Kubernetes المعيار الفعلي لتنسيق الحاويات. في هذا الدليل، سنشرح كيفية حزم تطبيق Kotlin في حاوية Docker ونشره في كتلة Kubernetes. ستحصل على مانيفستات جاهزة وأمثلة عملية بلغة Kotlin (باستخدام إطار العمل Ktor).

1. تحضير تطبيق Kotlin

للتجربة، سنأخذ واجهة REST API بسيطة على Ktor. تأكد من إعداد Gradle (أو Maven) مع إضافة application.

مثال build.gradle.kts:

plugins {\n    kotlin("jvm") version "1.9.22"\n    application\n    id("com.github.johnrengelman.shadow") version "8.1.1"\n}\n\napplication {\n    mainClass.set("com.example.ApplicationKt")\n}\n\ndependencies {\n    implementation("io.ktor:ktor-server-netty:2.3.7")\n    implementation("io.ktor:ktor-server-content-negotiation:2.3.7")\n    implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.7")\n}

أبسط نقطة نهاية (src/main/kotlin/com/example/Application.kt):

package com.example\n\nimport io.ktor.server.engine.*\nimport io.ktor.server.netty.*\nimport io.ktor.server.routing.*\nimport io.ktor.server.response.*\nimport io.ktor.serialization.kotlinx.json.*\nimport io.ktor.server.plugins.contentnegotiation.*\n\nfun main() {\n    embeddedServer(Netty, port = 8080) {\n        install(ContentNegotiation) {\n            json()\n        }\n        routing {\n            get("/") {\n                call.respond(mapOf("message" to "Hello from Kotlin on K8s!"))\n            }\n            get("/health") {\n                call.respond(mapOf("status" to "UP"))\n            }\n        }\n    }.start(wait = true)\n}

قم ببناء ملف JAR الضخم باستخدام الأمر:

./gradlew shadowJar

سيظهر ملف JAR الجاهز في build/libs/.

2. إنشاء صورة Docker

أنشئ ملف Dockerfile في جذر المشروع:

FROM openjdk:17-jdk-slim\n\nWORKDIR /app\n\nCOPY build/libs/*-all.jar app.jar\n\nEXPOSE 8080\n\nENTRYPOINT ["java", "-jar", "app.jar"]

قم ببناء الصورة وإرسالها إلى السجل (مثل Docker Hub):

docker build -t yourusername/kotlin-k8s-demo:v1 .\ndocker push yourusername/kotlin-k8s-demo:v1

تأكد من استبدال yourusername باسم المستخدم الخاص بك في Docker Hub أو حدد عنوان السجل الخاص.

3. مانيفستات Kubernetes

للنشر، سنحتاج إلى ملفين YAML: Deployment (يدير البودات) و Service (يفتح الوصول).

3.1. Deployment (deployment.yaml)

apiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: kotlin-app\nspec:\n  replicas: 2\n  selector:\n    matchLabels:\n      app: kotlin-app\n  template:\n    metadata:\n      labels:\n        app: kotlin-app\n    spec:\n      containers:\n      - name: kotlin-app\n        image: yourusername/kotlin-k8s-demo:v1\n        ports:\n        - containerPort: 8080\n        livenessProbe:\n          httpGet:\n            path: /health\n            port: 8080\n          initialDelaySeconds: 5\n          periodSeconds: 10\n        readinessProbe:\n          httpGet:\n            path: /health\n            port: 8080\n          initialDelaySeconds: 3\n          periodSeconds: 5

3.2. Service (service.yaml)

apiVersion: v1\nkind: Service\nmetadata:\n  name: kotlin-app-service\nspec:\n  selector:\n    app: kotlin-app\n  ports:\n  - port: 80\n    targetPort: 8080\n  type: LoadBalancer

قم بتطبيق المانيفستات:

kubectl apply -f deployment.yaml\nkubectl apply -f service.yaml

تحقق من الحالة:

kubectl get pods\nkubectl