Déploiement d'une application Kotlin sur Kubernetes : guide étape par étape

Déploiement de Kotlin sur Kubernetes : guide pratique de base

Le développement moderne exige de plus en plus non seulement l'écriture d'un code de qualité, mais aussi son déploiement judicieux. Kubernetes est devenu le standard de facto pour l'orchestration de conteneurs. Dans ce guide, nous allons voir comment empaqueter une application Kotlin dans un conteneur Docker et la déployer dans un cluster Kubernetes. Vous obtiendrez des manifestes prêts à l'emploi et des exemples pratiques en Kotlin (avec le framework Ktor).

1. Préparation de l'application Kotlin

Pour la démonstration, prenons une simple API REST avec Ktor. Assurez-vous d'avoir configuré Gradle (ou Maven) avec le plugin application.

Exemple de 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}

Le point d'accès le plus simple (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}

Construisez le fat JAR avec la commande :

./gradlew shadowJar

Le JAR prêt apparaîtra dans build/libs/.

2. Création de l'image Docker

Créez un fichier Dockerfile à la racine du projet :

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"]

Construisez l'image et envoyez-la dans un registre (par exemple, Docker Hub) :

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

Remplacez impérativement votrenomutilisateur par votre identifiant Docker Hub ou indiquez l'adresse de votre registre privé.

3. Manifestes Kubernetes

Pour le déploiement, nous aurons besoin de deux fichiers YAML : Deployment (gère les pods) et Service (ouvre l'accès).

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: votrenomutilisateur/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

Appliquez les manifestes :

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

Vérifiez le statut :

kubectl get pods\nkubectl