构建镜像
- 接口说明:构建镜像
- 接口地址:a=build&c=image&m=admin
- 请求方式:POST
请求参数
参数名称 | 类型 | 描述 | 必填 | 示例值 |
---|---|---|---|---|
name | number | 镜像名称,不需要包含域名 | 是 | urlos/urlos:1.0.0 |
url | string | 构建镜像后的镜像保存地址,即执行docker push命令 时的地址参数 | 是 | hub.my-domain.com/username/nginx:1.0 |
username | string | 如果镜像需要登录才能下载,请输入登录镜像服务器的 用户名 | 否 | username |
password | string | 如果镜像需要登录才能下载,请输入登录镜像服务器的 密码,留空则不需要保存到镜像服务器 | 否 | |
developer | string | 开发者 | 否 | |
developerWebsite | string | 开发者网址 | 否 | https://www.urlos.com |
size | string | 镜像大小,单位为MB或者GB | 否 | 10MB |
status | number | 状态:开启:1、关闭:0 | 是 | 1 |
description | string | 不超过128个字符 | 否 | |
nodeId | number | 执行构建的主机ID | 是 | 1 |
dockerFileContents | string | DockerFile内容 | 是 | |
bootScript | string | 启动脚本,用于启动容器内部的应用,如留空则根据源 镜像中的ENTRYPOINT和CMD自动填写启动脚本 | 否 | service nginx start |
序列化请求参数为键值对格式的字符串(注意:如果键值对的值是JSON格式数据,可能需要urlencode
):
"name={镜像名称}&url={镜像地址}&status={状态}&size={镜像大小}&dockerFileContents={DockerFile内容}&bootScript={启动脚本}"
请求示例:
发起请求
curl -d "name={镜像名称}&url={镜像地址}&status={状态}&size={镜像大小}&dockerFileContents={DockerFile内容}&bootScript={启动脚本}" "https://{你网站的ip或者域名}:9966/?a=build&c=image&m=admin&v=99999&globalApiNonceStr={随机字符串}&getJson=1&globalApiTimestamp={时间戳}&globalApiSign={签名字符串}"
返回结果
{
"msg": {
"message": "", // 提交请求执行结果的信息
"msgType": "success", // 提交请求执行结果的状态,有success、error、info、warning、fail
"msgMark": null,
"msgCode": null,
"jumpUrl": null,
"waitTime": 2
},
"currentInfo": {},
"softwareInfo": {}
}