2023-11-18 update: 三年后 IBM Cloud 砍了云函数业务,本文可以不用看了

网上的教程都是教白嫖 Cloud Foundary 建站开梯子的,弄得 IBM 都开始封 IP 了,哼。 (*  ̄︿ ̄)

来玩点正经的吧!今天用 Serverless 来做 Telegram Bot。

0. 注册

IBM Cloud 的免费 tier 有一个好,不用绑信用卡(这也是被薅太多的原因之一)。

https://www.ibm.com/cloud/free 能看到免费项目,这里首先要用 IBM Cloud Functions。

Cloud Functions 是 IBM 提供的 Serverless 服务,类似阿里云的函数计算腾讯云的云函数。与 App Engine 服务不同的是,函数计算只在被触发时才会运行,在限定执行时间返回结果,不能持久运行。

IBM Cloud 给了 500 万次/月的免费额度,阿里云和腾讯云也有一定的免费额度。不过这次是来做 Telegram Bot,这里就来嫖 IBM 的。

注册的时候,如果在最后一步遇到错误,那么可能是被 ban IP 了,可以试试挂梯子注册...

1. 安装 CLI 及配置

注册以后来到网页控制台里的 Cloud Functions。控制台里有这些选项卡:

  • 操作:这里是函数列表。

  • 触发器:这里可以添加从 IBM Cloud 其他服务或第三方消息源收到信息后触发某个函数,这里还用不到。

  • API:把函数整理成 API,目前还用不到。

  • 监视:能看到最近请求的日志

  • 名称空间设置:namespace,顾名思义。默认分配的位于达拉斯,名称是邮箱。也可以添加其他地方,但这里有坑,后面再说。

如果在网页控制台里新建操作,会发现它只给了个单文件代码输入,而且还没办法添加 packages,这就很鸡肋了。

所以要安装 CLI 来在本地写代码:(下面是 Linux 安装,其他安装方法见这

1
$ curl -fsSL https://clis.cloud.ibm.com/install/linux | sh

登录,注意这时要选区域,如果是达拉斯那就是 us-south

1
$ ibmcloud login

需要额外设置「组织」和「空间名」两个设置,在网页版右上角「管理-账户-Cloud Foundry 组织」可以找到组织名(一般是账号邮件地址),点进去有空间名(一般是 dev)。

前面提到的坑在于,在 Cloud Functions 里建立的命名空间不是基于 Cloud Foundary 的,无法用 CLI 来进行操作(aka 只能用网页操作)。而 Cloud Foundary 在免费 tier 只提供了 us-south,所以东京等等节点基本上没法用...

2021.1.25 update
(基于 IAM 而不是 Cloud Foundary 的命名空间) 其实可以用 CLI,区域选新命名空间所在的区域,然后用 ibmcloud fn property set --namespace '命名空间' 为 Function 单独指定即可,不需要设置 Cloud Foundary 相关参数.

2021.9.14 update
如果需要设置上述命名空间,现在需要先设置资源组。在「管理-账户-资源组」找到标识(一串十六进制),用 ibmcloud target -g 标识 命令设置.

1
$ ibmcloud target -o 组织名 -s 空间名

设置好以后查看下账号信息,应该是这样的:

1
2
3
4
5
6
7
8
9
10
$ ibmcloud target

API endpoint: https://cloud.ibm.com
Region: us-south
User: ******@****.com
Account: ***** 's Account (****************)
Resource group: No resource group targeted, use 'ibmcloud target -g RESOURCE_GROUP'
CF API endpoint: https://api.us-south.cf.cloud.ibm.com (API version: 2.153.0)
Org: ******@****.com
Space: dev

(资源组可以不设置)

然后安装 Functions 插件:

1
$ ibmcloud plugin install cloud-functions

这样 CLI 就配置好了。

2. 注册 Telegram Bot

首先要有 Telegram 账号

搜索 @BotFather 按照提示建立就好。

记录一下 HTTP API 的 token **********:******************************

3. 开始写

这里选择是用 Python 3.7 的环境,使用 python-telegram-bot 这个库。

首先建立一个名叫 virtualenv 的 virtualenv...(好像其他名字不认)

1
2
$ virtualenv virtualenv
$ source virtualenv/bin/activate

安装依赖:

1
$ pip install python-telegram-bot

主入口是 __main__.py,代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
from telegram import Bot, Update
from telegram.ext import Dispatcher, CommandHandler, MessageHandler, CallbackQueryHandler, Filters, CallbackContext

global TOKEN
global bot

def fn_hi(update: Update, context: CallbackContext) -> None:
update.message.reply_text('ヾ(•ω•`)o')

def response(update: Update, context: CallbackContext) -> None:
update.message.reply_text(update.message.text)

def main(args):
# initialize bot object
TOKEN = args['BOT_API_KEY']
bot = Bot(token=TOKEN)
# set dispatcher
dispatcher = Dispatcher(bot=bot, update_queue=Queue(), use_context=True)
dispatcher.add_handler(CommandHandler('hi', fn_hi))
dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, response))
dispatcher.add_handler(CallbackQueryHandler(handle_callback))
# get webhook callback
update = Update.de_json(args, bot)
# push to dispatcher
dispatcher.process_update(update)

return { 'code': '200' }

代码里不设置 token,在部署的时候会作为参数传入。

这就完成了一个无情的复读机 (o=^•ェ•)o ┏━┓

如何部署,见下回分晓...


本文参考了:

[1] https://medium.com/@aliabdelaal/telegram-bot-tutorial-using-python-and-flask-1fc634da9522