microej/sdk

MicroEJ BuildKit SDK Docker镜像

概述

本文档对应用于构建各种MicroEJ SDK版本的MicroEJ BuildKit Docker镜像的Git仓库。

文档

本文档中引用的所有镜像均可在https://hub.docker.com/u/microej/%E8%8E%B7%E5%8F%96%E3%80%82%E6%82%A8%E4%B9%9F%E5%8F%AF%E4%BB%A5%E6%8C%89%E7%85%A7%E4%BB%A5%E4%B8%8B%E6%9E%84%E5%BB%BA%E8%AF%B4%E6%98%8E%E5%92%8C%E6%88%91%E4%BB%AC%E7%9A%84https://github.com/MicroEJ/Tool-SDK-Docker%E8%87%AA%E8%A1%8C%E6%9E%84%E5%BB%BA%E3%80%82

版本说明

自SDK版本5.6.2起，SDK提供两个版本：JDK 8和JDK 11。JDK11版本的镜像后缀为-jdk11。标记为latest的镜像版本为5.9.0-jdk11。

MicroEJ SDK 5.4.1及以上版本

对于MicroEJ SDK 5.4.1及以上版本，请参考<[***]>。

使用SDK Docker镜像需同意最终用户许可协议（EULA）。您可以通过将ACCEPT_MICROEJ_SDK_EULA_XXX环境变量设置为YES来接受EULA，其中XXX是EULA版本，例如ACCEPT_MICROEJ_SDK_EULA_V3_1B=YES。

交互式使用

启动镜像进行交互式操作：

console
$ docker run --rm -it -e ACCEPT_MICROEJ_SDK_EULA_V3_1B=YES microej/sdk:5.8.1 bash

构建本地项目

从本地文件夹构建项目：

console
$ docker run --rm -v PATH/TO/PROJECT:/project -w /project -e ACCEPT_MICROEJ_SDK_EULA_V3_1B=YES microej/sdk:5.8.1 mmm build

自行构建镜像

您也可以从Dockerfile自行构建镜像。需执行以下步骤：

• 获取SDK的便携版
• 将其上传到可访问的远程位置，并存放在以SDK版本命名的文件夹中。例如，若基础URL为https://my.server/microej-sdk，SDK版本为23.07，则SDK发行版应上传至https://my.server/microej-sdk/23.07/microej-sdk-23.07-linux_x86_64.zip
• 使用SDK_DISTRIBUTION_BASE_URL参数启动镜像构建：

console
$ docker build --build-arg="SDK_DISTRIBUTION_BASE_URL=https://my.server/microej-sdk" -t microej/sdk:5.8.1 5.8.1

MicroEJ SDK 4.1.5至5.3.1版本

对于MicroEJ SDK 4.1.5至5.3.1版本，请参考https://github.com/MicroEJ/Tool-CommandLineBuild。

交互式使用

启动镜像进行交互式操作：

console
$ docker run --rm -it microej/sdk:4.1.5 bash

构建本地项目

从本地文件夹构建项目：

console
$ docker run --rm -v PATH/TO/PROJECT:/project -w /project microej/sdk:4.1.5 build_module_local.sh ./

自行构建镜像

您也可以从Dockerfile自行构建镜像：

console
$ docker build -t microej/sdk:4.1.5 4.1.5

自动化测试

项目根目录下有一个Jenkinsfile，用于自动测试项目Dockerfile。您可以使用Jenkins CI启动测试。
我们遵循Jenkins建议编写此Jenkinsfile：Using Docker with Pipeline。
若要运行测试，至少需要一个标记为docker的节点。

常见问题（FAQ）

如何添加自定义证书以使用mmm获取公司依赖？

您可以通过以下任一方式：

更新现有密钥库

通过向要构建的Dockerfile添加以下行，将自定义CA证书添加到Docker镜像：

console
USER root
COPY company.cer $JAVA_HOME/jre/lib/security
RUN \
    cd $JAVA_HOME/jre/lib/security \
    && keytool -keystore cacerts -storepass changeit -noprompt -trustcacerts -importcert -alias companycert -file company.cer

使用自定义密钥库

通过-v将密钥库挂载到Docker容器中，并通过向构建添加-Djavax.net.ssl.trustStore=容器内密钥库路径参数，将其与mmm一起使用。

如何使用自定义ivysettings以使用公司Maven仓库？

推荐方式是将ivysettings挂载到Docker容器中，并使用MMM-CLI的-r参数指定模块仓库设置文件位置。

有关更多信息，请参考MicroEJ模块管理器文档。

获取帮助

• MicroEJ论坛
• MicroEJ文档中心
• MicroEJ技术热线

Markdown
Copyright 2021-2024 MicroEJ Corp. All rights reserved.
Use of this source code is governed by a BSD-style license that can be found with this software.