欢迎使用微信云托管,将带领你通过微信云托管创建一个服务,并在小程序和WEB端调用此服务。
我们将以python为例,如果你擅长其他语言和框架,可以前往对应的「上手指引」:
- java版本
- node.js版本
- golang版本
- php版本
或者可以前往微信云托管官方仓库查看更多模版示例。
你可以用任何您认为趁手的代码编辑器来完成下述代码编辑操作,官方推荐「Visual Studio Code」
你可以用CLI命令,或者可视化方式新建
访问微信云托管控制台,用微信扫描网页上的登录二维码,进入控制台
进入控制台之前,会提示要求你选择「小程序/公众号」,如果你选择的「小程序/公众号」没有微信云托管环境,则会提示新建
如何选择「小程序/公众号」?
微信云托管环境是建立在腾讯云账号上的,基于选择的「小程序/公众号」,复用其主体信息,建立腾讯云账号。如果你选择的「小程序/公众号」是企业主体,则腾讯云账号就是对应的企业主体,个人主体同理。
如果你之前在某个「小程序/公众号」中开通过云开发,则会与其共用一个腾讯云账号。
新建环境时,需要填写环境名称,微信云托管会在你的名称后面追加一串字符组成环境ID
如果你已经有微信云托管环境,则可以直接进入控制台主平台
点击服务列表中,右上角【新建服务】按钮,在微信云托管环境中创建一个服务
弹出框中填写「服务名称」,在这里名称填写,并开启「允许公网访问」
如何判断是否「允许公网访问」?
微信云托管的服务在运行过程中,可以接收公网和内网的访问。如果你是单一服务类型,则建议开启公网访问。
微服务类型时,如果你的业务是面向用户的,比如登录注册服务,则开启公网访问。
如果你的微服务模块用于支撑其他服务模块,比如令牌维护服务,则不要开启。
在不开启公网访问时,服务只能被同一环境下的其他服务调用,或同一VPC网络(或内网互联)下的其他资源调用。公网其他资源将无法访问
不开启公网访问只是限制外向内访问,不会限制服务内向外发送网络请求
新建服务后,点击服务列表中新建的 服务,进入服务详情
进入服务详情默认在「部署发布」栏中,在「选择方式」中指定「手动上传代码包」
你可以选择 , , 中的任意一个建立仓库,上传代码后得到仓库地址,保证根目录中有上述的3个文件
如果你暂时没有git网站账户或者git相关知识,可以先略过这一部分,直接看第四步。
新建一个发布单,此时选择方式为「绑定代码仓库」,具体什么形式根据上一步自己仓库所在指定。
如果第一次使用需要先进行授权,授权完毕后就可以在下面的「代码仓库」中加载账号下的仓库了。
接下来,就进入了部署构建环节,和之前效果一致。
此时你配置的代码仓库信息已经保存在「服务设置-流水线」中,你可以前往修改,此后发布时,可以直接选择「执行流水线」,不需要每次配置仓库信息。详细文档
部署完毕后自动进入测试和灰度发布环节
在整个灰度环节,你可以指定哪些用户一定打到最新版本。
当灰度流量比例设置100%后,就可以点击「结单」按钮,完成发布,此时所有流量都在新的版本中,一轮发布结束。
在第二步中,访问服务获取的默认域名地址,就是服务对外提供服务的入口,你可以将其按照正常的服务来调用访问,比如上述PHP例子中,就可以用以下来调用:
你的项目在正式上线时,需要自己的域名,可以在按照自定义域名指引中的步骤完成域名的绑定。
如果你的项目中有其他路径,比如:
- / GET形式,上述PHP例子就只有这个
- /do POST形式
- /upload PUT形式
按照如上的情况,对应的curl访问应该是:
浏览器中,对应的访问应该是:
各种语言和框架的网络请求,请参阅各语言的文档和其他教学资料。
首先,确认当前调试基础库版本为 以上,可以在开发者工具-详情-本地设置中查看当前的基础库版本。
在小程序中使用如下的代码:
其他参数,直接参考 wx.request API
以上PHP例子访问的代码如下(在小程序项目 中覆盖写入如下代码)
首先,在网页中引入如下JS文件
使用如下代码:
其他参数,直接参考 wx.request API
以上PHP例子在浏览器中访问的代码如下(请将以下代码放置在html文件中,并在浏览器里运行控制台看结果)
如果你是普通网页开发,则可以直接按照以上方式使用,或者直接对公网域名发起request请求。
如果你开发微信公众号网页,则前往对应的开发指引