25 лет назад Java пошла в широкие программистские массы, чтобы в итоге стать одним из тех стержней, вокруг которых строятся стеки приложений. Однако сегодня многие люди и организации, долгие годы хранившие верность Java, заняты тем, что переходят или думают переходить на платформу Kubernetes или ее производные, такие как Red Hat OpenShift или Amazon EKS.
Увы, Kubernetes отличается крутой кривой обучения и вводит еще один операционный уровень в привычный для Java-программистов процесс разработки. Сегодня мы расскажем, как использовать Eclipse JKube, чтобы упростить эти дополнительные операции, связанные с Kubernetes и контейнерами, а также обеспечить безболезненную миграцию на облачную платформу с сохранением привычной экосистемы Java. Более того, мы покажем, как развертывать Java-приложения на платформе OpenShift с помощью плагина OpenShift Maven.
Традиционный процесс разработки Java (Рис.1) подразумевает, что разработчик пишет код, потом создает единицы развертывания в виде файлов JAR или WAR, а затем развертывает и запускает эти файлы на веб-сервере или сервере приложений. В основном для этого применяют Maven из командной строки или используют IDE, вроде IntelliJ или Eclipse, чтобы кодировать и упаковывать приложения. Разработчики привыкли вносить изменения в код и тщательно все тестировать, прежде чем фиксировать код и отправлять его в систему управления версиями.
Рис. 1. Традиционный процесс Java-разработки.
При переходе к облачным приложениям в описанную выше схему добавляются Kubernetes и контейнеры. Поэтому теперь разработчику надо упаковать Java-приложения в контейнерные образы и создать Kubernetes-манифесты, описывающие эти образы. Затем эти манифесты применяются к продакшн-серверу, на котором работает Kubernetes. В свою очередь, Kubernetes берет эти образы из реестра и развертывает приложения согласно тем конфигурациям, что мы прописали в манифестах, которые обычно представляют собой файлы YAML.
Метаморфоза традиционного процесса Java-разработки при переходе к облаку показана на Рис. 2.
Рис. 2. Процесс Java-разработки для облака.
Переход на Kubernetes добавляет еще один операционный уровень в процесс разработки, и многих разработчиков это нервирует, поскольку они хотят заниматься своей основной работой – логикой приложений, – а не тем, как их развертывать. И здесь в игру вступает Eclipse JKube, который позволяет разработчикам использовать свои библиотеки и плагины (JKube Kit вместе с Kubernetes Maven Plugin или OpenShift Maven Plugin), чтобы без лишних усилий выполнять операции, связанные с контейнерами и Kubernetes, следуя схеме на Рис. 2.
В оставшейся части этой статьи мы покажем, как упростить процесс Java-разработки в среде Kubernetes, используя Eclipse JKube с плагином Kubernetes Maven Plugin.
Рассмотрим слегка модифицированную схему Java-разработки для облака с Рис.2, введя в нее Eclipse JKube и Kubernetes Maven Plugin, как показано на Рис. 3.
Рис. 3. Процесс Java-разработки для облака с использованием Eclipse JKube.
Как мы видим, здесь все операции по взаимодействию с Kubernetes и контейнерами (на схеме выделены красным) заменяются goal-задачами Eclipse JKube по умолчанию, которые перечислены в Табл. 1.
Табл. 1. Задачи Eclipse JKube по умолчанию.
Примечание: Если вы не хотите, чтобы задачи использовали эти жесткие дефолты (opinionated defaults), то можете вручную настроить Eclipse JKube под себя, благо он поддерживает конфигурирование через XML и ресурсы.
Теперь рассмотрим примеры использования Eclipse JKube и Kubernetes Maven Plugin при работе с приложениями.
В этом примере мы развернем простое Java-приложение в кластере Minikube с помощью Eclipse JKube. Используя Kubernetes Maven Plugin, мы можем задать параметры развертывания без того, чтобы прописывать какую бы то ни было конфигурацию.
В качестве примера приложения мы используем простой генератор случайный чисел, который выдает JSON-output на endpoint’е /random:
Шаг 1. Загружаем Kubernetes Maven Plugin
Kubernetes Maven Plugin находится в репозитории Maven Central Repository. Для использования Eclipse JKube надо добавить Kubernetes Maven Plugin в свой pom.xml в качестве зависимости:
Если вместо чистого Kubernetes используется OpenShift, то pom.xml модифицируется следующим образом:
Шаг 2. Собираем docker-образ
JAR-файл приложения можно собрать командой mvn package, а затем можно использовать goal-задачу mvn k8s:build, чтобы собрать docker-образ этого приложения. Обратите внимание, что мы переопределили имя образа по умолчанию с помощью вот этого свойства:
Прежде чем собирать образ, надо убедиться, чтобы docker-демон был корректно экспонирован. Это можно сделать следующей командой:
Затем вводим команду mvn k8s:build, и вот что мы увидим на экране при сборке docker-образа с помощью build-задачи Eclipse JKube:
Шаг 3. Отправляем образ в реестр docker
После того, как мы собрали docker-образ при настроенном push-реестре (в нашем случае это docker.io), можно отправлять этот образ в реестр. Вот что выведется на экран после того, как мы попросим Eclipse JKube выполнить push-задачу mvn k8s:push:
После отправки образа надо проверить, что он попал в реестр. В нашем случае мы просто видим его в Docker Hub, как показано на Рис. 4.
Рис. 4. Отправленный в реестр образ появился в Docker Hub.
Шаг 4. Генерируем манифесты Kubernetes-ресурсов для приложения
Итак, образ приложения мы собрали, теперь надо написать Kubernetes-манифесты. Для этого в Eclipse JKube есть задача, которая генерирует жесткие манифесты ресурсов, отталкиваясь от нижележащего Java-фреймворка (Spring Boot, Quarkus, Vert.x или какой-то другой). Также можно настроить манифест, используя конфигурационный XML-файл и положив raw-фрагменты (фрагменты требуемого манифеста ресурсов) в папку приложения src/main/jkube. В таком случае ваша конфигурация будет заливаться в сгенерированные манифесты.
В нашем примере мы оставляем все как есть, и поэтому Eclipse JKube генерирует манифест для дефолтного развертывания и для сервиса с типом ClusterIP. А уже потом мы модифицируем манифест сервиса, чтобы изменить типа сервиса на NodePort. Переопределить дефолтное поведение можно с помощью следующего свойства:
Вот как выглядит экранный вывод после того, как мы попросим Eclipse JKube выполнить resource-задачу mvn k8s:resource.
Шаг 5. Развертываем приложение в кластере Kubernetes
Итак, у нас все готово, чтобы выполнить развертывание приложения: мы сгенерировали его образ и затем автоматически сгенерировали манифесты ресурсов. Теперь осталось только применить всё это к кластеру Kubernetes. Для развертывания приложения можно, конечно, воспользоваться командой kubectl apply -f, но плагин и это может сделать за нас. Вот что будет на экране после того, как мы попросим Eclipse JKube выполнить apply-задачу mvn k8s:apply:
Шаг 6. Делаем undeploy приложения из кластера Kubernetes
Для этого используется задача undeploy, которая просто удаляет все ресурсы, которые были применены на предыдущем шаге, то есть при выполнении задачи apply. Вот что мы увидим на экране после того, как попросим Eclipse JKube выполнить undeploy-задачу mvn k8s:undeploy:
Итак, мы рассмотрели основные goal-задачи Eclipse JKube и Kubernetes Maven Plugin, которые облегчают разработку Java-приложений для платформы Kubernetes. Если вам не хочется постоянно вводить эти задачи с клавиатуры, их можно пописать в конфигурации плагина, например, вот так:
Надо сказать, что в этой статье мы рассмотрели далеко не все goal-задачи, которые есть в Eclipse JKube и Kubernetes Maven Plugin, поэтому приводим в Табл.2 список дополнительных задач, которые также могут вам пригодиться.
Табл. 2. Дополнительные goal-задачи Eclipse JKube.
Для развертывания приложения из нашего примера на платформе Red Hat OpenShift применим плагин OpenShift Maven. Единственное отличие будет в том, что префикс задач изменится с k8s на oc. По умолчанию плагин Kubernetes Maven делает docker-сборки, а плагин OpenShift Maven – сборки S2I. Мы не вносим в наш проект никаких изменений, за исключением удаления свойства jkube.generator.name, поскольку оно не требуется при отправке в реестр (на этапе сборки OpenShift размещает образ в своем внутреннем реестре). И вот что появится на экране, когда мы запустим наш пример, в котором мы, кстати, выполняем goal-задачи не по одной, а все сразу:
Чтобы узнать больше о том, как упростить Kubernetes-разработку с помощью Eclipse JKube, посмотрите видео-урок по быстрому развертыванию простого приложение Spring Boot на Minikube:
В этой статье мы показали, как Eclipse JKube облегчает жизнь Java-разработчику при работе с Kubernetes. Дополнительную информацию по Eclipse JKube можно найти на сайте проекта и на GitHub.
Увы, Kubernetes отличается крутой кривой обучения и вводит еще один операционный уровень в привычный для Java-программистов процесс разработки. Сегодня мы расскажем, как использовать Eclipse JKube, чтобы упростить эти дополнительные операции, связанные с Kubernetes и контейнерами, а также обеспечить безболезненную миграцию на облачную платформу с сохранением привычной экосистемы Java. Более того, мы покажем, как развертывать Java-приложения на платформе OpenShift с помощью плагина OpenShift Maven.
Традиционный процесс Java-разработки
Традиционный процесс разработки Java (Рис.1) подразумевает, что разработчик пишет код, потом создает единицы развертывания в виде файлов JAR или WAR, а затем развертывает и запускает эти файлы на веб-сервере или сервере приложений. В основном для этого применяют Maven из командной строки или используют IDE, вроде IntelliJ или Eclipse, чтобы кодировать и упаковывать приложения. Разработчики привыкли вносить изменения в код и тщательно все тестировать, прежде чем фиксировать код и отправлять его в систему управления версиями.
Рис. 1. Традиционный процесс Java-разработки.
Процесс Java-разработки для облака
При переходе к облачным приложениям в описанную выше схему добавляются Kubernetes и контейнеры. Поэтому теперь разработчику надо упаковать Java-приложения в контейнерные образы и создать Kubernetes-манифесты, описывающие эти образы. Затем эти манифесты применяются к продакшн-серверу, на котором работает Kubernetes. В свою очередь, Kubernetes берет эти образы из реестра и развертывает приложения согласно тем конфигурациям, что мы прописали в манифестах, которые обычно представляют собой файлы YAML.
Метаморфоза традиционного процесса Java-разработки при переходе к облаку показана на Рис. 2.
Рис. 2. Процесс Java-разработки для облака.
Eclipse JKube
Переход на Kubernetes добавляет еще один операционный уровень в процесс разработки, и многих разработчиков это нервирует, поскольку они хотят заниматься своей основной работой – логикой приложений, – а не тем, как их развертывать. И здесь в игру вступает Eclipse JKube, который позволяет разработчикам использовать свои библиотеки и плагины (JKube Kit вместе с Kubernetes Maven Plugin или OpenShift Maven Plugin), чтобы без лишних усилий выполнять операции, связанные с контейнерами и Kubernetes, следуя схеме на Рис. 2.
В оставшейся части этой статьи мы покажем, как упростить процесс Java-разработки в среде Kubernetes, используя Eclipse JKube с плагином Kubernetes Maven Plugin.
Процесс разработки для облака с использованием Eclipse JKube
Рассмотрим слегка модифицированную схему Java-разработки для облака с Рис.2, введя в нее Eclipse JKube и Kubernetes Maven Plugin, как показано на Рис. 3.
Рис. 3. Процесс Java-разработки для облака с использованием Eclipse JKube.
Как мы видим, здесь все операции по взаимодействию с Kubernetes и контейнерами (на схеме выделены красным) заменяются goal-задачами Eclipse JKube по умолчанию, которые перечислены в Табл. 1.
Табл. 1. Задачи Eclipse JKube по умолчанию.
Задача | Этап | Описание |
---|---|---|
k8s:build | PRE_INTEGRATION_TEST | Сборка docker-образов |
k8s:push | INSTALL | Отправка docker-образов в реестр |
k8s:resource | PROCESS_RESOURCES | Генерация манифестов K8s |
k8s:apply | COMPILE | Применение сгенерированных манифестов к K8s |
k8s:undeploy | UNDEPLOY | Удаление ресурсов K8s, которые были развернуты посредством k8s:apply и k8s:deploy |
Примечание: Если вы не хотите, чтобы задачи использовали эти жесткие дефолты (opinionated defaults), то можете вручную настроить Eclipse JKube под себя, благо он поддерживает конфигурирование через XML и ресурсы.
Теперь рассмотрим примеры использования Eclipse JKube и Kubernetes Maven Plugin при работе с приложениями.
Развертываем Java-приложение в Kubernetes с помощью Eclipse JKube
В этом примере мы развернем простое Java-приложение в кластере Minikube с помощью Eclipse JKube. Используя Kubernetes Maven Plugin, мы можем задать параметры развертывания без того, чтобы прописывать какую бы то ни было конфигурацию.
В качестве примера приложения мы используем простой генератор случайный чисел, который выдает JSON-output на endpoint’е /random:
~/work/repos/eclipse-jkube-demo-project : $ curl localhost:8080/random | jq .
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 45 0 45 0 0 818 0 --:--:-- --:--:-- --:--:-- 818
{
"id": "e80a4d10-c79b-4b9a-aaac-7c286cb37f3c"
}
Шаг 1. Загружаем Kubernetes Maven Plugin
Kubernetes Maven Plugin находится в репозитории Maven Central Repository. Для использования Eclipse JKube надо добавить Kubernetes Maven Plugin в свой pom.xml в качестве зависимости:
<plugin>
<groupId>org.eclipse.jkube</groupId>
<artifactId>kubernetes-maven-plugin</artifactId>
<version>${jkube.version}</version>
</plugin>
Если вместо чистого Kubernetes используется OpenShift, то pom.xml модифицируется следующим образом:
<plugin>
<groupId>org.eclipse.jkube</groupId>
<artifactId>openshift-maven-plugin</artifactId>
<version>${jkube.version}</version>
</plugin>
Шаг 2. Собираем docker-образ
JAR-файл приложения можно собрать командой mvn package, а затем можно использовать goal-задачу mvn k8s:build, чтобы собрать docker-образ этого приложения. Обратите внимание, что мы переопределили имя образа по умолчанию с помощью вот этого свойства:
<jkube.generator.name>docker.io/rohankanojia/random-generator:${project.version}</jkube.generator.name>
Прежде чем собирать образ, надо убедиться, чтобы docker-демон был корректно экспонирован. Это можно сделать следующей командой:
$ eval $(minikube docker-env)
Затем вводим команду mvn k8s:build, и вот что мы увидим на экране при сборке docker-образа с помощью build-задачи Eclipse JKube:
~/work/repos/eclipse-jkube-demo-project : $ mvn k8s:build
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- kubernetes-maven-plugin:1.0.0-rc-1:build (default-cli) @ random-generator ---
[INFO] k8s: Running in Kubernetes mode
[INFO] k8s: Building Docker image in Kubernetes mode
[INFO] k8s: Running generator spring-boot
[INFO] k8s: spring-boot: Using Docker image quay.io/jkube/jkube-java-binary-s2i:0.0.7 as base / builder
[INFO] k8s: [docker.io/rohankanojia/random-generator:0.0.1] "spring-boot": Created docker-build.tar in 251 milliseconds
[INFO] k8s: [docker.io/rohankanojia/random-generator:0.0.1] "spring-boot": Built image sha256:a20e5
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5.053 s
[INFO] Finished at: 2020-08-10T11:28:23+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $
Шаг 3. Отправляем образ в реестр docker
После того, как мы собрали docker-образ при настроенном push-реестре (в нашем случае это docker.io), можно отправлять этот образ в реестр. Вот что выведется на экран после того, как мы попросим Eclipse JKube выполнить push-задачу mvn k8s:push:
~/work/repos/eclipse-jkube-demo-project : $ mvn k8s:push
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- kubernetes-maven-plugin:1.0.0-rc-1:push (default-cli) @ random-generator ---
[INFO] k8s: Running in Kubernetes mode
[INFO] k8s: Building Docker image in Kubernetes mode
[INFO] k8s: Running generator spring-boot
[INFO] k8s: spring-boot: Using Docker image quay.io/jkube/jkube-java-binary-s2i:0.0.7 as base / builder
[INFO] k8s: The push refers to repository [docker.io/rohankanojia/random-generator]
5dcd9556710f: Layer already exists
b7139ad07aa8: Layer already exists
b6f081e4b2b6: Layer already exists
d8e1f35641ac: Layer already exists
[INFO] k8s: 0.0.1: digest: sha256:9f9eda2a13b8cab1d2c9e474248500145fc09e2922fe3735692f9bda4c76002d size: 1162
[INFO] k8s: Pushed docker.io/rohankanojia/random-generator:0.0.1 in 7 seconds
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 11.222 s
[INFO] Finished at: 2020-08-10T11:35:37+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $
После отправки образа надо проверить, что он попал в реестр. В нашем случае мы просто видим его в Docker Hub, как показано на Рис. 4.
Рис. 4. Отправленный в реестр образ появился в Docker Hub.
Шаг 4. Генерируем манифесты Kubernetes-ресурсов для приложения
Итак, образ приложения мы собрали, теперь надо написать Kubernetes-манифесты. Для этого в Eclipse JKube есть задача, которая генерирует жесткие манифесты ресурсов, отталкиваясь от нижележащего Java-фреймворка (Spring Boot, Quarkus, Vert.x или какой-то другой). Также можно настроить манифест, используя конфигурационный XML-файл и положив raw-фрагменты (фрагменты требуемого манифеста ресурсов) в папку приложения src/main/jkube. В таком случае ваша конфигурация будет заливаться в сгенерированные манифесты.
В нашем примере мы оставляем все как есть, и поэтому Eclipse JKube генерирует манифест для дефолтного развертывания и для сервиса с типом ClusterIP. А уже потом мы модифицируем манифест сервиса, чтобы изменить типа сервиса на NodePort. Переопределить дефолтное поведение можно с помощью следующего свойства:
<jkube.enricher.jkube-service.type>NodePort</jkube.enricher.jkube-service.type>
Вот как выглядит экранный вывод после того, как мы попросим Eclipse JKube выполнить resource-задачу mvn k8s:resource.
~/work/repos/eclipse-jkube-demo-project : $ mvn k8s:resource
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- kubernetes-maven-plugin:1.0.0-rc-1:resource (default-cli) @ random-generator ---
[INFO] k8s: Running generator spring-boot
[INFO] k8s: spring-boot: Using Docker image quay.io/jkube/jkube-java-binary-s2i:0.0.7 as base / builder
[INFO] k8s: jkube-controller: Adding a default Deployment
[INFO] k8s: jkube-service: Adding a default service 'random-generator' with ports [8080]
[INFO] k8s: jkube-healthcheck-spring-boot: Adding readiness probe on port 8080, path='/actuator/health', scheme='HTTP', with initial delay 10 seconds
[INFO] k8s: jkube-healthcheck-spring-boot: Adding liveness probe on port 8080, path='/actuator/health', scheme='HTTP', with initial delay 180 seconds
[INFO] k8s: jkube-revision-history: Adding revision history limit to 2
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3.344 s
[INFO] Finished at: 2020-08-10T11:38:11+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $ ls target/classes/META-INF/jkube/kubernetes
random-generator-deployment.yml random-generator-service.yml
~/work/repos/eclipse-jkube-demo-project : $ cat target/classes/META-INF/jkube/kubernetes/random-generator-deployment.yml | head -n10
---
apiVersion: apps/v1
kind: Deployment
metadata:
annotations:
jkube.io/git-url: git@github.com:rohanKanojia/eclipse-jkube-demo-project.git
jkube.io/git-commit: 1ef9ef2ef7a6fcbf8eb64c293f26f9c42d026512
jkube.io/git-branch: master
jkube.io/scm-url: https://github.com/spring-projects/spring-boot/spring-boot-starter-parent/random-generator
jkube.io/scm-tag: HEAD
~/work/repos/eclipse-jkube-demo-project : $
Шаг 5. Развертываем приложение в кластере Kubernetes
Итак, у нас все готово, чтобы выполнить развертывание приложения: мы сгенерировали его образ и затем автоматически сгенерировали манифесты ресурсов. Теперь осталось только применить всё это к кластеру Kubernetes. Для развертывания приложения можно, конечно, воспользоваться командой kubectl apply -f, но плагин и это может сделать за нас. Вот что будет на экране после того, как мы попросим Eclipse JKube выполнить apply-задачу mvn k8s:apply:
~/work/repos/eclipse-jkube-demo-project : $ mvn k8s:apply
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- kubernetes-maven-plugin:1.0.0-rc-1:apply (default-cli) @ random-generator ---
[INFO] k8s: Using Kubernetes at https://192.168.39.145:8443/ in namespace default with manifest /home/rohaan/work/repos/eclipse-jkube-demo-project/target/classes/META-INF/jkube/kubernetes.yml
[INFO] k8s: Using namespace: default
[INFO] k8s: Creating a Service from kubernetes.yml namespace default name random-generator
[INFO] k8s: Created Service: target/jkube/applyJson/default/service-random-generator.json
[INFO] k8s: Creating a Deployment from kubernetes.yml namespace default name random-generator
[INFO] k8s: Created Deployment: target/jkube/applyJson/default/deployment-random-generator.json
[INFO] k8s: HINT: Use the command `kubectl get pods -w` to watch your pods start up
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7.306 s
[INFO] Finished at: 2020-08-10T11:40:57+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $ kubectl get pods -w
NAME READY STATUS RESTARTS AGE
random-generator-58b7847d7f-9m9df 0/1 Running 0 7s
random-generator-58b7847d7f-9m9df 1/1 Running 0 17s
^C~/work/repos/eclipse-jkube-demo-project : $ kubectl get svc
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
io-openliberty-sample-getting-started NodePort 10.110.4.104 <none> 9080:30570/TCP 44h
kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 18d
random-generator NodePort 10.97.172.147 <none> 8080:32186/TCP 22s
~/work/repos/eclipse-jkube-demo-project : $ curl `minikube ip`:32186/random | jq .
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 45 0 45 0 0 1800 0 --:--:-- --:--:-- --:--:-- 1875
{
"id": "42e5571f-a20f-44b3-8184-370356581d10"
}
Шаг 6. Делаем undeploy приложения из кластера Kubernetes
Для этого используется задача undeploy, которая просто удаляет все ресурсы, которые были применены на предыдущем шаге, то есть при выполнении задачи apply. Вот что мы увидим на экране после того, как попросим Eclipse JKube выполнить undeploy-задачу mvn k8s:undeploy:
~/work/repos/eclipse-jkube-demo-project : $ kubectl get all
NAME READY STATUS RESTARTS AGE
pod/random-generator-58b7847d7f-9m9df 1/1 Running 0 5m21s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 18d
service/random-generator NodePort 10.97.172.147 <none> 8080:32186/TCP 5m21s
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/random-generator 1/1 1 1 5m21s
NAME DESIRED CURRENT READY AGE
replicaset.apps/random-generator-58b7847d7f 1 1 1 5m21s
~/work/repos/eclipse-jkube-demo-project : $ mvn k8s:undeploy
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- kubernetes-maven-plugin:1.0.0-rc-1:undeploy (default-cli) @ random-generator ---
[INFO] k8s: Using Kubernetes at https://192.168.39.145:8443/ in namespace default with manifest /home/rohaan/work/repos/eclipse-jkube-demo-project/target/classes/META-INF/jkube/kubernetes.yml
[INFO] k8s: Using namespace: default
[INFO] k8s: Deleting resource Deployment default/random-generator
[INFO] k8s: Deleting resource Service default/random-generator
[INFO] k8s: HINT: Use the command `kubectl get pods -w` to watch your pods start up
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3.412 s
[INFO] Finished at: 2020-08-10T11:46:22+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $ kubectl get pods -w
^C~/work/repos/eclipse-jkube-demo-project : $ kubectl get all
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 18d
~/work/repos/eclipse-jkube-demo-project : $
Что еще можно сделать с Eclipse JKube
Итак, мы рассмотрели основные goal-задачи Eclipse JKube и Kubernetes Maven Plugin, которые облегчают разработку Java-приложений для платформы Kubernetes. Если вам не хочется постоянно вводить эти задачи с клавиатуры, их можно пописать в конфигурации плагина, например, вот так:
<plugin>
<groupId>org.eclipse.jkube</groupId>
<artifactId>kubernetes-maven-plugin</artifactId>
<version>${project.version}</version>
<executions>
<execution>
<goals>
<goal>build</goal>
<goal>resource</goal>
<goal>apply</goal>
</goals>
</execution>
</executions>
</plugin>
Надо сказать, что в этой статье мы рассмотрели далеко не все goal-задачи, которые есть в Eclipse JKube и Kubernetes Maven Plugin, поэтому приводим в Табл.2 список дополнительных задач, которые также могут вам пригодиться.
Табл. 2. Дополнительные goal-задачи Eclipse JKube.
Задача | Этап | Описание |
---|---|---|
k8s:log | VALIDATE | Получение логов от приложения, работающего на Kubernetes. |
k8s:debug | PACKAGE | Открытие отладочного порта, чтобы выполнять отладку приложения, работающего на Kubernetes, непосредственно из IDE. |
k8s:deploy | INSTALL | Создание форка для Install-задачи и применение сгенерированных манифестов к кластеру Kubernetes точно так же, как в случае apply-задачи. |
k8s:watch | PACKAGE | Автоматическое горячее развертывание приложения за счет отслеживания его пространства имен. |
Развертывание Java-приложений на Red Hat OpenShift с помощью OpenShift Maven Plugin
Для развертывания приложения из нашего примера на платформе Red Hat OpenShift применим плагин OpenShift Maven. Единственное отличие будет в том, что префикс задач изменится с k8s на oc. По умолчанию плагин Kubernetes Maven делает docker-сборки, а плагин OpenShift Maven – сборки S2I. Мы не вносим в наш проект никаких изменений, за исключением удаления свойства jkube.generator.name, поскольку оно не требуется при отправке в реестр (на этапе сборки OpenShift размещает образ в своем внутреннем реестре). И вот что появится на экране, когда мы запустим наш пример, в котором мы, кстати, выполняем goal-задачи не по одной, а все сразу:
~/work/repos/eclipse-jkube-demo-project : $ mvn oc:build oc:resource oc:apply
[INFO] Scanning for projects...
[INFO]
[INFO] ----------------------< meetup:random-generator >-----------------------
[INFO] Building random-generator 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- openshift-maven-plugin:1.0.0-rc-1:build (default-cli) @ random-generator ---
[INFO] oc: Using OpenShift build with strategy S2I
[INFO] oc: Running in OpenShift mode
[INFO] oc: Running generator spring-boot
[INFO] oc: spring-boot: Using Docker image quay.io/jkube/jkube-java-binary-s2i:0.0.7 as base / builder
[INFO] oc: [random-generator:0.0.1] "spring-boot": Created docker source tar /home/rohaan/work/repos/eclipse-jkube-demo-project/target/docker/random-generator/0.0.1/tmp/docker-build.tar
[INFO] oc: Adding to Secret pullsecret-jkube
[INFO] oc: Using Secret pullsecret-jkube
[INFO] oc: Creating BuildServiceConfig random-generator-s2i for Source build
[INFO] oc: Creating ImageStream random-generator
[INFO] oc: Starting Build random-generator-s2i
[INFO] oc: Waiting for build random-generator-s2i-1 to complete...
[INFO] oc: Caching blobs under "/var/cache/blobs".
[INFO] oc: Getting image source signatures
[INFO] oc: Copying blob sha256:cf0f3ebe9f536c782ab3835049cfbd9a663761ded9370791ef6ea3965c823aad
[INFO] oc: Copying blob sha256:57de4da701b511cba33bbdc424757f7f3b408bea741ca714ace265da9b59191a
[INFO] oc: Copying blob sha256:f320f94d91a064281f5127d5f49954b481062c7d56cce3b09910e471cf849050
[INFO] oc: Copying config sha256:52d6788fcfdd39595264d34a3959464a5dabc1d4ef0ae188802b20fc2d6a857b
[INFO] oc: Writing manifest to image destination
[INFO] oc: Storing signatures
[INFO] oc: Generating dockerfile with builder image quay.io/jkube/jkube-java-binary-s2i:0.0.7
[INFO] oc: STEP 1: FROM quay.io/jkube/jkube-java-binary-s2i:0.0.7
[INFO] oc: STEP 2: LABEL "io.openshift.build.source-location"="/tmp/build/inputs" "io.openshift.build.image"="quay.io/jkube/jkube-java-binary-s2i:0.0.7"
[INFO] oc: STEP 3: ENV JAVA_APP_DIR="/deployments" OPENSHIFT_BUILD_NAME="random-generator-s2i-1" OPENSHIFT_BUILD_NAMESPACE="default"
[INFO] oc: STEP 4: USER root
[INFO] oc: STEP 5: COPY upload/src /tmp/src
[INFO] oc: STEP 6: RUN chown -R 1000:0 /tmp/src
[INFO] oc: STEP 7: USER 1000
[INFO] oc: STEP 8: RUN /usr/local/s2i/assemble
[INFO] oc: INFO S2I source build with plain binaries detected
[INFO] oc: INFO S2I binary build from fabric8-maven-plugin detected
[INFO] oc: INFO Copying binaries from /tmp/src/deployments to /deployments ...
[INFO] oc: random-generator-0.0.1.jar
[INFO] oc: INFO Copying deployments from deployments to /deployments...
[INFO] oc: '/tmp/src/deployments/random-generator-0.0.1.jar' -> '/deployments/random-generator-0.0.1.jar'
[INFO] oc: STEP 9: CMD /usr/local/s2i/run
[INFO] oc: STEP 10: COMMIT temp.builder.openshift.io/default/random-generator-s2i-1:48795e41
[INFO] oc: time="2020-08-10T06:37:49Z" level=info msg="Image operating system mismatch: image uses \"\", expecting \"linux\""
[INFO] oc: time="2020-08-10T06:37:49Z" level=info msg="Image architecture mismatch: image uses \"\", expecting \"amd64\""
[INFO] oc: Getting image source signatures
[INFO] oc: Copying blob sha256:d8e1f35641acb80b562f70cf49911341dfbe8c86f4d522b18efbf3732aa74223
[INFO] oc: Copying blob sha256:b6f081e4b2b6de8be4b1dec132043d14c121e968384dd624fb69c2c07b482edb
[INFO] oc: Copying blob sha256:b7139ad07aa8ce4ed5a132f7c5cc9f1de0f5099b5e155027a23d57f7fbe78b16
[INFO] oc: Copying blob sha256:98972fc90a1108315cc5b05b2c691a0849a149727a7b81e76bc847ac2c6d9714
[INFO] oc: Copying config sha256:27aaadaf28e24856a66db962b88118b8222b61d79163dceeeed869f7289bc230
[INFO] oc: Writing manifest to image destination
[INFO] oc: Storing signatures
[INFO] oc: --> 27aaadaf28e
[INFO] oc: 27aaadaf28e24856a66db962b88118b8222b61d79163dceeeed869f7289bc230
[INFO] oc: Getting image source signatures
[INFO] oc:
[INFO] oc: Pushing image image-registry.openshift-image-registry.svc:5000/default/random-generator:0.0.1 ...
[INFO] oc: Copying blob sha256:f320f94d91a064281f5127d5f49954b481062c7d56cce3b09910e471cf849050
[INFO] oc: Copying blob sha256:cf0f3ebe9f536c782ab3835049cfbd9a663761ded9370791ef6ea3965c823aad
[INFO] oc: Copying blob sha256:57de4da701b511cba33bbdc424757f7f3b408bea741ca714ace265da9b59191a
[INFO] oc: Copying blob sha256:98972fc90a1108315cc5b05b2c691a0849a149727a7b81e76bc847ac2c6d9714
[INFO] oc: Copying config sha256:27aaadaf28e24856a66db962b88118b8222b61d79163dceeeed869f7289bc230
[INFO] oc: Writing manifest to image destination
[INFO] oc: Storing signatures
[INFO] oc: Successfully pushed image-registry.openshift-image-registry.svc:5000/default/random-generator@sha256:aa9e1a380c04ef9174ba56459c13d44420ebe653ebf32884d60fe4306b17306d
[INFO] oc: Push successful
[INFO] oc: Build random-generator-s2i-1 in status Complete
[INFO] oc: Found tag on ImageStream random-generator tag: sha256:aa9e1a380c04ef9174ba56459c13d44420ebe653ebf32884d60fe4306b17306d
[INFO] oc: ImageStream random-generator written to /home/rohaan/work/repos/eclipse-jkube-demo-project/target/random-generator-is.yml
[INFO]
[INFO] --- openshift-maven-plugin:1.0.0-rc-1:resource (default-cli) @ random-generator ---
[INFO] oc: Using docker image name of namespace: default
[INFO] oc: Running generator spring-boot
[INFO] oc: spring-boot: Using Docker image quay.io/jkube/jkube-java-binary-s2i:0.0.7 as base / builder
[INFO] oc: jkube-controller: Adding a default DeploymentConfig
[INFO] oc: jkube-service: Adding a default service 'random-generator' with ports [8080]
[INFO] oc: jkube-healthcheck-spring-boot: Adding readiness probe on port 8080, path='/actuator/health', scheme='HTTP', with initial delay 10 seconds
[INFO] oc: jkube-healthcheck-spring-boot: Adding liveness probe on port 8080, path='/actuator/health', scheme='HTTP', with initial delay 180 seconds
[INFO] oc: jkube-revision-history: Adding revision history limit to 2
[INFO]
[INFO] --- openshift-maven-plugin:1.0.0-rc-1:apply (default-cli) @ random-generator ---
[INFO] oc: Using OpenShift at https://api.crc.testing:6443/ in namespace default with manifest /home/rohaan/work/repos/eclipse-jkube-demo-project/target/classes/META-INF/jkube/openshift.yml
[INFO] oc: OpenShift platform detected
[INFO] oc: Using project: default
[INFO] oc: Creating a Service from openshift.yml namespace default name random-generator
[INFO] oc: Created Service: target/jkube/applyJson/default/service-random-generator.json
[INFO] oc: Creating a DeploymentConfig from openshift.yml namespace default name random-generator
[INFO] oc: Created DeploymentConfig: target/jkube/applyJson/default/deploymentconfig-random-generator.json
[INFO] oc: Creating Route default:random-generator host: null
[INFO] oc: HINT: Use the command `oc get pods -w` to watch your pods start up
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:07 min
[INFO] Finished at: 2020-08-10T12:08:00+05:30
[INFO] ------------------------------------------------------------------------
~/work/repos/eclipse-jkube-demo-project : $ oc get pods -w
NAME READY STATUS RESTARTS AGE
random-generator-1-deploy 1/1 Running 0 14s
random-generator-1-vnrm9 0/1 Running 0 11s
random-generator-s2i-1-build 0/1 Completed 0 1m
random-generator-1-vnrm9 1/1 Running 0 24s
random-generator-1-deploy 0/1 Completed 0 28s
~/work/repos/eclipse-jkube-demo-project : $ oc get routes
NAME HOST/PORT PATH SERVICES PORT TERMINATION WILDCARD
random-generator random-generator-default.apps-crc.testing random-generator 8080 None
~/work/repos/eclipse-jkube-demo-project : $ curl random-generator-default.apps-crc.testing/random
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 45 0 45 0 0 1666 0 --:--:-- --:--:-- --:--:-- 1730
{
"id": "d80052d9-2f92-43cb-b9eb-d7cffb879798"
}
~/work/repos/eclipse-jkube-demo-project : $
Видео-урок
Чтобы узнать больше о том, как упростить Kubernetes-разработку с помощью Eclipse JKube, посмотрите видео-урок по быстрому развертыванию простого приложение Spring Boot на Minikube:
Заключение
В этой статье мы показали, как Eclipse JKube облегчает жизнь Java-разработчику при работе с Kubernetes. Дополнительную информацию по Eclipse JKube можно найти на сайте проекта и на GitHub.
mystdeim
Кто собирает джаву в докер, подскажите какой минимальный размер контейнера с hello world получается?
redhatrussia Автор
Все зависит от базового образа и технологий. Используйте, например, quarkus native mode — там размер будет минимальный.
darkit
а какая разница на размер контейнера?
Если вы правильно сделаете слои то меняться будет слой только с вашим кодом. И значит хосты будут вытягивать только его, а не весь образ.
mystdeim
деплою pet-проекты через `docker save/load` bash скриптом, чтобы не связываться с приватным репозиторием, на vps. Удобно когда образ небольшой, быстро деплоется. Quarkus с graalvm тут должен действительно помочь, но когда последний раз смотрел он не дружил с gradle
darkit
С Кваркусом и нативным образом у меня засада, что локальная машина под МакОС, а образ надо делать для Линукса. И значит надо собирать проект в докере, а докер у меня висит с ограниченными ресурсами, чтобы не выжирал всю память и цпу. В результате все собирается очень долго :(