本文将引导如何创建云托管服务，部署发布，并在小程序和 Web 端调用云托管服务。

准备：需要下载最新 Nightly 版本 的开发者工具进行开通。

第一步：开通云托管

开通云托管要求使用后付费，因此如果环境不是后付费，请先切换至后付费、或新创建一个后付费的环境。本功能需要云开发管理员或小程序管理员才可以开通。

云托管的开通入口首页更多-云托管中，也可以在 “设置 -> 拓展功能” 中开通。

第二步：创建服务

云托管是以服务为维度进行管理的。

在云托管中，点击「创建服务」，可以创建一个新的云托管服务。点击「版本管理」可以进入到该服务中。

第三步：准备代码包

1、你可以点击下载 示例 Node.JS 代码包，或跟着如下的步骤手动创建一个示例容器。

创建一个空目录，本示例中为 helloworld

mkdir helloworld

cd helloworld

2、安装所需依赖

npm init -y

npm install express --save

3、创建 index.js 并写入示例内容

示例代码返回接收到 headers，并且提供了获取用户 openid 和 unionid 的示例，可在此文档查看所有微信特殊 header。

const express = require("express");

const app = express();

app.get("/", (req, res) => {

res.send(`Hello World!`);

});

const port = 8080;

app.listen(port, () => {

console.log(`helloworld: listening on port ${port}`);

});

创建 Dockerfile 并写入内容

# https://hub.docker.com/_/node

FROM node:12-slim

# Create and change to the app directory.

WORKDIR /usr/src/app

# Copy application dependency manifests to the container image.

# A wildcard is used to ensure both package.json AND package-lock.json are copied.

# Copying this separately prevents re-running npm install on every code change.

COPY package*.json ./

# Install production dependencies.

RUN npm install --only=production

# Copy local code to the container image.

COPY . ./

# Run the web service on container startup.

CMD [ "node", "index.js" ]

添加一个 .dockerignore 文件，以从容器映像中排除文件：

Dockerfile

.dockerignore

node_modules

npm-debug.log

到此，即可完成代码包的创建。除 Node.JS 外，云容器还支持其他的后端语言，具体可以参照 Docker 的官方文档进行镜像包的构建。

第四步：创建版本

进入服务后，可以点击「新建版本」创建一个版本。

云托管支持本地上传和代码库拉取两种方式：

• 本地上传可以选择文件夹或 ZIP 压缩包进行上传。需要上传包含正确 Dockerfile 的代码目录，否则，将提示 Dockerfile 不合法。
• 代码库拉取支持 GitHub，GitLab 和 Gitee 的代码库拉取，需要点击授权后，才可以看到自己的代码仓库。在弹出的界面完成代码授权后，关闭即可看到自己的代码仓库。

需要注意，文件夹或 ZIP 压缩包上传的代码中不能超过  2 MiB

在创建版本时，可以选择「稍后配置」或「开启 100% 流量」两种流量配置，若选择「稍后配置」，该版本将不会被分配流量。

第五步：查看构建是否成功

点击版本右侧的「详情」，可以查看版本的详细信息，包括版本的构建日志，版本详情以及实例信息：

• 构建日志：提供版本构建日志信息。若版本构建失败，可以在下方建议处点击「重新构建」
• 版本详情：可以针对版本的备注和扩缩容实例数量进行调整
• 实例信息：可以看到当前容器的实例，对应的实例 ID 以及创建时间。点击「Web Shell」，可以在弹出的窗口中对实例进行操作。

第六步：调用云托管服务

首先，确认当前调试基础库版本为 2.13.1 以上。可以在开发者工具-详情-本地设置中查看当前的基础库版本。

在小程序中，使用如下的代码就可以调用云托管容器：

// 确认已经在 onLaunch 中调用过 wx.cloud.init 初始化环境

const res = await wx.cloud.callContainer({

path: '/container-helloworld', // 填入容器的访问路径（云托管-服务列表-路径）

method: 'GET',

})

console.log(res)

在 Web 端，可以使用如下代码进行调用：

// 初始化 Cloud 实例

// 容器调用必填环境id，不能为空

var c1 = new wx.cloud.Cloud({

resourceEnv: '环境id'

})

await c1.init()

// 返回值同 wx.request

const res = await c1.callContainer({

path: '/container-helloworld', // 填入容器的访问路径（云托管-服务列表-路径）

// 其余参数同 wx.request

method: 'POST',

})

console.log(res)

重新编译后，在控制台看到如下的输出，说明调用已经成功：