«1. Обзор
В этом руководстве мы рассмотрим Jib и то, как он упрощает контейнеризацию Java-приложений.
Мы возьмем простое приложение Spring Boot и создадим его образ Docker с помощью Jib. Затем мы также опубликуем образ в удаленном реестре.
И не забудьте также обратиться к нашему руководству по докеризации приложений Spring Boot с помощью dockerfile и инструмента docker.
2. Введение в Jib
Jib — это инструмент Java с открытым исходным кодом, поддерживаемый Google для создания образов Docker приложений Java. Это упрощает контейнеризацию, поскольку с ним нам не нужно писать файл докеров.
И на самом деле нам даже не нужно устанавливать докер, чтобы самим создавать и публиковать образы докеров.
Google публикует Jib как плагин для Maven и Gradle. Это хорошо, потому что это означает, что Jib будет ловить любые изменения, которые мы вносим в наше приложение при каждой сборке. Это избавляет нас от отдельных команд docker build/push и упрощает добавление этого в конвейер CI.
Существует также несколько других инструментов, таких как плагины Spotify docker-maven-plugin и dockerfile-maven, хотя первый сейчас устарел, а для второго требуется файл dockerfile.
3. Простое приветственное приложение
Давайте возьмем простое приложение с весенней загрузкой и докеризуем его с помощью Jib. Он предоставит простую конечную точку GET:
http://localhost:8080/greeting
Что мы можем сделать очень просто с контроллером Spring MVC:
@RestController
public class GreetingController {
private static final String template = "Hello Docker, %s!";
private final AtomicLong counter = new AtomicLong();
@GetMapping("/greeting")
public Greeting greeting(@RequestParam(value="name",
defaultValue="World") String name) {
return new Greeting(counter.incrementAndGet(),
String.format(template, name));
}
}
4. Подготовка к развертыванию
Нам также нужно настроить себя локально для аутентификации в репозитории Docker, в который мы хотим выполнить развертывание.
В этом примере мы предоставим наши учетные данные DockerHub в .m2/settings.xml:
<servers>
<server>
<id>registry.hub.docker.com</id>
<username><DockerHub Username></username>
<password><DockerHub Password></password>
</server>
</servers>
Существуют и другие способы предоставления учетных данных. Google рекомендует использовать вспомогательные инструменты, которые могут хранить учетные данные в зашифрованном формате в файловой системе. В этом примере мы могли бы использовать docker-credential-helpers вместо хранения учетных данных в виде простого текста в settings.xml, что намного безопаснее, хотя просто не рассматривается в этом руководстве.
5. Развертывание в Docker Hub с помощью Jib
Теперь мы можем использовать jib-maven-plugin или эквивалент Gradle для контейнеризации нашего приложения с помощью простой команды:
mvn compile com.google.cloud.tools:jib-maven-plugin:2.5.0:build -Dimage=$IMAGE_PATH
где IMAGE_PATH является целью путь в реестре контейнеров.
Например, чтобы загрузить образ baeldungjib/spring-jib-app в DockerHub, мы должны сделать:
export IMAGE_PATH=registry.hub.docker.com/baeldungjib/spring-jib-app
Вот и все! Это создаст Docker-образ нашего приложения и отправит его в DockerHub.
Мы можем, конечно, аналогичным образом загрузить образ в Google Container Registry или Amazon Elastic Container Registry.
6. Упрощение команды Maven
Кроме того, мы можем сократить нашу начальную команду, вместо этого настроив плагин в нашем pom, как и любой другой плагин maven.
<project>
...
<build>
<plugins>
...
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>jib-maven-plugin</artifactId>
<version>2.5.0</version>
<configuration>
<to>
<image>${image.path}</image>
</to>
</configuration>
</plugin>
...
</plugins>
</build>
...
</project>
С этим изменением мы можем упростить нашу команду maven:
mvn compile jib:build
7. Настройка аспектов Docker
По умолчанию Jib делает ряд разумных предположений о том, что мы хотим, например FROM и ВХОД.
Давайте внесем в наше приложение пару изменений, более подходящих для наших нужд.
Во-первых, Spring Boot по умолчанию предоставляет порт 8080.
Но, скажем, мы хотим, чтобы наше приложение работало на порту 8082 и сделало его доступным через контейнер.
Разумеется, мы внесем соответствующие изменения в Boot. И после этого мы можем использовать Jib, чтобы сделать его видимым на изображении:
<configuration>
...
<container>
<ports>
<port>8082</port>
</ports>
</container>
</configuration>
Или, скажем, нам нужен другой FROM. По умолчанию Jib использует образ Java без дистрибутива.
Если мы хотим запустить наше приложение на другом базовом образе, таком как alpine-java, мы можем настроить его аналогичным образом:
<configuration>
...
<from>
<image>openjdk:alpine</image>
</from>
...
</configuration>
Мы настраиваем теги, тома и несколько других директив Docker в том же способ.
8. Настройка аспектов Java
Кроме того, Jib также поддерживает множество конфигураций времени выполнения Java:
-
jvmFlags указывает, какие флаги запуска передавать JVM. mainClass предназначен для указания основного класса, который Jib попытается вывести автоматически по умолчанию. args — это место, где мы указываем аргументы программы, передаваемые основному методу.
«Конечно, обязательно ознакомьтесь с документацией Jib, чтобы увидеть все доступные свойства конфигурации.
9. Заключение
В этом руководстве мы увидели, как создавать и публиковать образы докеров с помощью Google Jib, в том числе как получить доступ к директивам докеров и конфигурациям среды выполнения Java через Maven.
Как всегда, исходный код этого примера доступен на Github.