fabric8io/docker-maven-plugin 0.9.x 到 0.10.x 迁移指南

fabric8io/docker-maven-plugin 0.9.x 到 0.10.x 迁移指南

【免费下载链接】docker-maven-plugin Maven plugin for running and creating Docker images 项目地址: https://gitcode.com/gh_mirrors/doc/docker-maven-plugin

迁移背景

fabric8io/docker-maven-plugin 是一个用于构建和管理 Docker 镜像的 Maven 插件。在 0.10.x 版本中，插件进行了重大架构调整，主要变化包括：

1. 支持多镜像配置
2. 明确区分构建配置和运行时配置
3. 简化生命周期绑定
4. 改进等待机制配置

这些变化使得插件配置更加清晰和灵活，但也带来了配置格式的变化。本文将详细介绍如何从 0.9.x 版本迁移到 0.10.x 及更高版本。

核心变化解析

1. 多镜像支持

旧版本中，插件只能处理一个或两个镜像（取决于 mergeData 属性）。新版本完全重构了这一机制，允许在一个配置中定义多个镜像。

2. 配置结构调整

新版本将配置明确分为两部分：

• <build> 部分：包含所有构建相关的配置
• <run> 部分：包含所有运行时相关的配置

这种分离使得配置更加清晰，便于理解和维护。

详细迁移步骤

等待机制配置迁移

旧版本中，等待配置是平铺的：

<waitHttp>http://localhost:${port}/jolokia</waitHttp>
<wait>10000</wait>

新版本中，所有等待配置都集中在 <wait> 元素内：

<wait>
  <http>
    <url>http://localhost:${port}/jolokia</url>
  </http>
  <time>10000</time>
</wait>

新版本还新增了对日志输出的等待检查 (<log>)，提供了更丰富的等待条件。

生命周期绑定变化

旧版本中，某些操作会隐式触发其他操作。例如，docker:start 或 docker:pull 会隐式执行 docker:build。

新版本中，所有操作都必须显式声明：

<executions>
  <execution>
    <id>start</id>
    <phase>pre-integration-test</phase>
    <goals>
      <goal>build</goal>
      <goal>start</goal>
    </goals>
  </execution>
</executions>

这种变化使得构建过程更加透明和可控。

迁移示例

迁移方式取决于是否使用了 mergeData 属性。

情况一：非合并镜像 (mergeData=false)

旧配置：

<configuration>
  <mergeData>false</mergeData>
  <image>consol/tomcat-7.0</image>
  <dataImage>jolokia/data</dataImage>
  <assemblyDescriptor>src/main/docker-assembly.xml</assemblyDescriptor>
  <env>
    <CATALINA_OPTS>-Xmx32m</CATALINA_OPTS>
  </env>
  <ports>
    <port>jolokia.port:8080</port>
  </ports>
  <waitHttp>http://localhost:${jolokia.port}/jolokia</waitHttp>
  <wait>10000</wait>
</configuration>

新配置：

<configuration>
  <images>
    <image>
      <alias>server</alias>
      <name>consol/tomcat-7.0</name>
      <run>
        <volumes>
          <from>data</from>
        </volumes>
        <env>
          <CATALINA_OPTS>-Xmx32m</CATALINA_OPTS>
        </env>
        <ports>
          <port>jolokia.port:8080</port>
        </ports>
        <wait>
          <http>
            <url>http://localhost:${jolokia.port}/jolokia</url>
          </http>
          <time>10000</time>
        </wait>
      </run>
    </image>
    <image>
      <alias>data</alias>
      <name>jolokia/data</name>
      <build>
        <assemblyDescriptor>src/main/docker-assembly.xml</assemblyDescriptor>
      </build>
    </image>
  </images>
</configuration>

关键点：

1. 创建了两个镜像配置
2. 服务器镜像只有 <run> 配置
3. 数据镜像只有 <build> 配置
4. 通过 <volumes> 和 <from> 关联两个容器

情况二：合并镜像 (mergeData=true)

旧配置：

<configuration>
  <mergeData>true</mergeData>
  <image>consol/tomcat-7.0</image>
  <dataImage>jolokia/data</dataImage>
  <assemblyDescriptor>src/main/docker-assembly.xml</assemblyDescriptor>
  <env>
    <CATALINA_OPTS>-Xmx32m</CATALINA_OPTS>
  </env>
  <ports>
    <port>jolokia.port:8080</port>
  </ports>
  <waitHttp>http://localhost:${jolokia.port}/jolokia</waitHttp>
  <wait>10000</wait>
</configuration>

新配置：

<configuration>
  <images>
    <image>
      <name>jolokia/data</name>
      <build>
        <from>consol/tomcat-7.0</from>
        <assemblyDescriptor>src/main/docker-assembly.xml</assemblyDescriptor>
      </build>
      <run>
        <env>
          <CATALINA_OPTS>-Xmx32m</CATALINA_OPTS>
        </env>
        <ports>
          <port>jolokia.port:8080</port>
        </ports>
        <wait>
          <http>
            <url>http://localhost:${jolokia.port}/jolokia</url>
          </http>
          <time>10000</time>
        </wait>
      </run>
    </image>
  </images>
</configuration>

关键点：

1. 只创建一个镜像
2. 基础镜像在 <build> 的 <from> 中指定
3. 同时包含 <build> 和 <run> 配置

属性重命名

为了保持一致性，以下属性被重命名：

旧属性	新属性
url	dockerHost
docker.url (系统属性)	docker.host
color	useColor

迁移建议

1. 逐步迁移：先迁移简单的配置，再处理复杂场景
2. 测试验证：迁移后务必进行充分测试
3. 版本控制：建议使用版本控制系统管理配置变更
4. 文档参考：保留新旧配置文档以便对照

通过遵循本指南，您应该能够顺利将项目从 0.9.x 版本迁移到 0.10.x 及更高版本。新版本的配置结构更加清晰合理，虽然需要一些迁移工作，但长期来看会提高项目的可维护性。

【免费下载链接】docker-maven-plugin Maven plugin for running and creating Docker images 项目地址: https://gitcode.com/gh_mirrors/doc/docker-maven-plugin