制作应用容器Docker镜像 - Serverless应用引擎

使用规范

通过Dockerfile制作自定义镜像时，SAE在运行时会自动注入以下环境变量信息。

注意

为保证应用正常运行，请勿覆盖以下配置。
请勿使用/home/admin/.spas_key/default文件，该文件在POD运行时将会被覆盖。


环境变量Key	描述
POD_IP	POD的IP地址。
EDAS_APP_ID	部署在SAE上应用的ID。
EDAS_ECC_ID	导入集群的ECS在应用中部署后的ID。
EDAS_PROJECT_NAME	与EDAS_ECC_ID类似，用于调用链解析。
EDAS_JM_CONTAINER_ID	与EDAS_ECC_ID类似，用于调用链解析。
EDAS_CATALINA_OPTS	中间件运行时所需的CATALINA_OPTS参数。
CATALINA_OPTS	与EDAS_CATALINA_OPTS类似，默认Tomcat启动参数。
CATALINA_HOME	安装的Tomcat路径。
PANDORA_LOCATION	安装的Pandora路径，仅HSF应用中可见。

创建标准Dockerfile

Dockerfile是以文本格式来快速创建自定义镜像的配置文件，Dockerfile的详细说明请参见Dockerfile。

标准的Dockerfile描述了SAE创建应用运行环境所需的所有指令，包括下载、安装和启动OpenJDK、Tomcat、WAR包和JAR包等。您还可以通过修改Dockerfile内容，完成如OpenJDK版本替换、Tomcat配置修改、改变运行时环境等操作，详情请参见Dockerfile。

您可以通过Dockerfile分别制作HSF、Spring Cloud或Dubbo应用镜像，创建不同框架应用的Dockerfile示例如下：

HSF应用的Dockerfile示例（基于WAR包）
HSF应用的Dockerfile示例（基于JAR包）
Spring Cloud或Dubbo应用的Dockerfile示例（基于WAR包）
Spring Cloud或Dubbo应用的Dockerfile示例（基于JAR包）

注意制作应用镜像时请勿使用VOLUMES或USER root字段，否则应用运行时可能会导致文件丢失。

HSF应用的Dockerfile示例（基于WAR包）

FROM centos:7
MAINTAINER：SAE研发团队

#安装打包必备软件。
RUN yum install -y wget unzip telnet lsof net-tools bind-utils

#准备JDK以及Tomcat系统变量与路径。
ENV JAVA_HOME /usr/java/latest
ENV CATALINA_HOME /home/admin/taobao-tomcat
ENV PATH ${JAVA_HOME}/bin:${CATALINA_HOME}/bin:${PATH}

#设置EDAS-Container以及Pandora应用容器版本。
ENV EDAS_CONTAINER_VERSION V3.5.4
LABEL pandora V3.5.4

#下载安装OpenJDK。
RUN yum -y install java-1.8.0-openjdk-devel

#创建JAVA_HOME软链接。
RUN if [ ! -L "${JAVA_HOME}" ]; then mkdir -p `dirname ${JAVA_HOME}` && ln -s `readlink -f /usr/lib/jvm/java` ${JAVA_HOME}; fi

#下载安装Ali-Tomcat 7.0.92到/home/admin/taobao-tomcat目录。
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/edas-container/7.0.92/taobao-tomcat-production-7.0.92.tar.gz -O /tmp/taobao-tomcat.tar.gz && \
    mkdir -p ${CATALINA_HOME} && \
    tar -xvf /tmp/taobao-tomcat.tar.gz -C ${CATALINA_HOME} && \
    mv ${CATALINA_HOME}/taobao-tomcat-production-7.0.59.3/* ${CATALINA_HOME}/ && \
    rm -rf /tmp/taobao-tomcat.tar.gz ${CATALINA_HOME}/taobao-tomcat-production-7.0.59.3 && \
    chmod +x ${CATALINA_HOME}/bin/*sh

#根据环境变量，下载安装EDAS-Container以及Pandora应用容器版本。
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/edas-plugins/edas.sar.${EDAS_CONTAINER_VERSION}/taobao-hsf.tgz -O /tmp/taobao-hsf.tgz && \
    tar -xvf /tmp/taobao-hsf.tgz -C ${CATALINA_HOME}/deploy && \
    rm -rf /tmp/taobao-hsf.tgz

#下载部署SAE演示WAR包。
RUN wget http://edas.oss-cn-hangzhou.aliyuncs.com/demo/hello-edas.war -O /tmp/ROOT.war && \
    unzip /tmp/ROOT.war -d ${CATALINA_HOME}/deploy/ROOT && \
    rm -rf /tmp/ROOT.war

#设定Tomcat安装目录为容器启动目录，并采用run方式启动Tomcat，在标准命令行输出catalina日志。
WORKDIR ${CATALINA_HOME}
CMD ["catalina.sh", "run"]

HSF应用的Dockerfile示例（基于JAR包）

FROM centos:7
MAINTAINER：SAE研发团队

#安装打包必备软件。
RUN yum install -y wget unzip telnet lsof net-tools bind-utils

#准备JDK及Tomcat系统变量与路径。
ENV JAVA_HOME /usr/java/latest
ENV CATALINA_HOME /home/admin/taobao-tomcat
ENV PATH ${JAVA_HOME}/bin:${PATH}
ENV ADMIN_HOME /home/admin

#设置EDAS-Container以及Pandora应用容器版本。
ENV EDAS_CONTAINER_VERSION V3.5.4
LABEL pandora V3.5.4

#下载安装OpenJDK。
RUN yum -y install java-1.8.0-openjdk-devel

#创建JAVA_HOME软链接。
RUN if [ ! -L "${JAVA_HOME}" ]; then mkdir -p `dirname ${JAVA_HOME}` && ln -s `readlink -f /usr/lib/jvm/java` ${JAVA_HOME}; fi

#根据环境变量，下载安装EDAS-Container以及Pandora应用容器版本。
RUN mkdir -p ${CATALINA_HOME}/deploy
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/edas-plugins/edas.sar.${EDAS_CONTAINER_VERSION}/taobao-hsf.tgz -O /tmp/taobao-hsf.tgz && \
    tar -xvf /tmp/taobao-hsf.tgz -C ${CATALINA_HOME}/deploy/ && \
    rm -rf /tmp/taobao-hsf.tgz

#下载部署SAE演示JAR包。
RUN mkdir -p ${ADMIN_HOME}/app && wget http://edas.oss-cn-hangzhou.aliyuncs.com/demoapp/fatjar-test-case-provider-0.0.1-SNAPSHOT.jar -O ${ADMIN_HOME}/app/provider.jar

#将启动命令写入启动脚本start.sh。
RUN echo 'eval exec java -jar $CATALINA_OPTS /home/admin/app/hello-edas-0.0.1-SNAPSHOT.jar'> /home/admin/start.sh && chmod +x /home/admin/start.sh
WORKDIR $CATALINA_HOME
CMD ["/bin/bash", "/home/admin/start.sh"]

Spring Cloud或Dubbo应用的Dockerfile示例（基于WAR包）

FROM centos:7
MAINTAINER：SAE研发团队

#安装打包必备软件。
RUN yum -y install wget unzip telnet

#准备JDK以及Tomcat系统变量。
ENV JAVA_HOME /usr/java/latest
ENV CATALINA_HOME /home/admin/apache-tomcat-7.0.91
ENV ADMIN_HOME /home/admin
ENV PATH $PATH:$JAVA_HOME/bin:$CATALINA_HOME/bin
RUN mkdir -p /home/admin

#下载安装OpenJDK。
RUN yum -y install java-1.8.0-openjdk-devel

#下载安装Tomcat。
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/apache-tomcat-7.0.91.tar.gz -O /tmp/apache-tomcat-7.0.91.tar.gz && \
    tar -xvf /tmp/apache-tomcat-7.0.91.tar.gz -C /home/admin && \
    rm /tmp/apache-tomcat-7.0.91.tar.gz && \
    chmod +x ${CATALINA_HOME}/bin/*sh

RUN mkdir -p ${CATALINA_HOME}/deploy/

#增加容器内中文支持。
ENV LANG="en_US.UTF-8"

#增强Webshell使?体验。
ENV TERM=xterm

#下载部署SAE演示WAR包。
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/demo/1.0/hello-edas.war -O /tmp/ROOT.war && \
    rm -rf ${CATALINA_HOME}/webapps/ROOT &&\
    unzip /tmp/ROOT.war -d ${CATALINA_HOME}/deploy/ROOT/ && \
    rm -rf /tmp/ROOT.war

# 设定Tomcat安装目录为容器启动目录，并采用run方式启动Tomcat，在标准命令行输出catalina日志。
WORKDIR $ADMIN_HOME
CMD ["catalina.sh", "run"]

Spring Cloud或Dubbo应用的Dockerfile示例（基于JAR包）

FROM centos:7
MAINTAINER：SAE研发团队 

#安装打包必备软件。
RUN yum -y install wget unzip telnet

#准备JDK以及Tomcat系统变量。
ENV JAVA_HOME /usr/java/latest
ENV PATH $PATH:$JAVA_HOME/bin
ENV ADMIN_HOME /home/admin

#下载安装OpenJDK。
RUN yum -y install java-1.8.0-openjdk-devel

#下载部署SAE演示JAR包。
RUN mkdir -p /home/admin/app/ && \
         wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/demo/1.0/hello-edas-0.0.1-SNAPSHOT.jar -O /home/admin/app/hello-edas-0.0.1-SNAPSHOT.jar

#增加容器内中?支持。
ENV LANG="en_US.UTF-8"

#增强Webshell使?体验。
ENV TERM=xterm

#将启动命令写入启动脚本start.sh。
RUN mkdir -p /home/admin
RUN echo 'eval exec java -jar $CATALINA_OPTS /home/admin/app/hello-edas-0.0.1-SNAPSHOT.jar'> /home/admin/start.sh && chmod +x /home/admin/start.sh
WORKDIR $ADMIN_HOME
CMD ["/bin/bash", "/home/admin/start.sh"]

自定义设置Dockerfile

通过编辑Dockerfile文件修改运行环境配置，如替换JDK版本、Tomcat修改配置、更改运行时环境等操作。

更换JDK版本

在标准Dockerfile中，请参见以下示例更换其他版本的JDK。

# 下载安装JDK 8。
RUN wget http://edas-hz.oss-cn-hangzhou.aliyuncs.com/agent/prod/files/jdk-8u65-linux-x64.rpm -O /tmp/jdk-8u65-linux-x64.rpm && \
    yum -y install /tmp/jdk-8u65-linux-x64.rpm && \
    rm -rf /tmp/jdk-8u65-linux-x64.rpm

在Tomcat启动参数中添加SAE运行环境
SAE提供了JVM环境变量EDAS_CATALINA_OPTS，包含了运行所需的基本参数。此外Ali-Tomcat提供了自定义JVM参数配置选项JAVA_OPTS，可以设置Xmx、Xms等参数。
```
#设置SAE应用JVM参数。
ENV CATALINA_OPTS ${EDAS_CATALINA_OPTS}
#设置JVM参数。
ENV JAVA_OPTS="\
     -Xmx3550m \
     -Xms3550m \
     -Xmn2g \
     -Xss128k"                            
```

在本地制作镜像

从本地命令行进入Dockerfile文件所在的目录，执行docker build命令制作镜像。

docker build -t [标签名称，最好取应用名]:[版本号] .
或
docker build -t [标签名称，最好取应用名]:[版本号] -f /path/to/custom_dockerfile_name.#适用于您创建好的Dockerfile在其他位置或名称不为Dockerfile的场景。

例如：

docker build -t hsf-provider:1.0.0 .

制作完成后，执行docker images | grep <镜像标签名称>命令查看本地编译完成的镜像。

上传镜像到镜像仓库

您可以将本地生成制作好的应用镜像上传到阿里云提供的容器镜像仓库，详细步骤请参见创建镜像。

执行指定镜像仓库基本信息页面提供的将镜像推送到Registry相关命令，将本地镜像上传到该镜像仓库。

docker login --username=[当前登录的账号名] registry.[region_id].aliyuncs.com     #输入的密码为阿里云容器镜像服务默认实例访问凭证页面设置的固定或者临时密码，并非阿里云账号密码。
docker tag [本地应用镜像ID] registry.[region_id].aliyuncs.com/[命令空间名称]/[镜像仓库名称]:[镜像版本号]
docker push registry.[region_id].aliyuncs.com/[命令空间名称]/[镜像仓库名称]:[镜像版本号]

例如：

docker login --username=aaa111@gmail.com registry.cn-hangzhou.aliyuncs.com
docker tag [ImageId] registry.cn-hangzhou.aliyuncs.com/webapps/hsf-provider:1.0.0
docker push registry.cn-hangzhou.aliyuncs.com/webapps/hsf-provider:1.0.0

问题反馈

如果您在使用SAE过程中有任何疑问，欢迎您扫描下面的二维码加入钉钉群进行反馈。 SAE钉钉群2

制作应用容器Docker镜像 - Serverless应用引擎

使用规范

创建标准Dockerfile

HSF应用的Dockerfile示例（基于WAR包）

HSF应用的Dockerfile示例（基于JAR包）

Spring Cloud或Dubbo应用的Dockerfile示例（基于WAR包）

Spring Cloud或Dubbo应用的Dockerfile示例（基于JAR包）

自定义设置Dockerfile

在本地制作镜像

上传镜像到镜像仓库

更多信息

问题反馈

推荐图文

容器服务创建简单的 Nginx 服务 - 快速入门

使用快照创建云盘 - 云服务器 ECS

DeleteTemplates - 运维编排服务

拥抱人力资源数字化，iTalentU 2020第五届北森用户

实例生命周期介绍 - 弹性加速计算实例EAIS

创建模板 - 运维编排服务

随机推荐

成为JS专家之前必须掌握这10件事

国内免备案的服务器哪里有呢

怎么注册免费com域名

全站加速如何计费？_内容分发网络 CDN_常

面试官：JavaScript的数据类型你了解多少

弹性伸缩管理告警触发策略 - 扩缩容

UnassignIpv6Addresses - 云服务器 ECS

私有网络连接公网 - 常见问题

VPN 连接操作总览 - 操作指南

创建终端节点服务_VPC终端节点 VPCEP_用

关于我们