python-tutum 0.21.2

安装库

为了安装tutum python库，可以使用pip install：

pip install python-tutum

它将安装一个名为tutum的python模块，您可以使用它与api接口。

授权

为了能够向api发出请求，您应该首先为您的帐户获取一个apikey。 为此，请登录tutum，单击屏幕右上角的菜单，然后选择get api key

您可以使用apikey和python库，方法如下（将按此顺序使用）：

• 在python初始化代码中手动设置它：

importtutumtutum.user="username"tutum.apikey="apikey"

• 将其存储在~/.tutum：
中的配置文件中

[auth]user="username"apikey="apikey"

• 设置环境变量TUTUM_USER和TUTUM_APIKEY：

exportTUTUM_USER=username
exportTUTUM_APIKEY=apikey

错误

http api中的错误将返回4xx和5xx范围内的状态代码。

python库将检测此状态代码并引发TutumApiError异常，并显示错误消息， 应该由调用应用程序相应地处理。

快速示例

>>>importtutum>>>tutum.Service.list()[<tutum.api.service.Serviceobjectat0x10701ca90>,<tutum.api.service.Serviceobjectat0x10701ca91>]>>>service=tutum.Service.fetch("fee900c6-97da-46b3-a21c-e2b50ed07015")<tutum.api.service.Serviceobjectat0x106c45c10>>>>service.name"my-python-app">>>service=tutum.Service.create(image="tutum/hello-world",name="my-new-app",target_num_containers=2)>>>service.save()True>>>service.target_num_containers=3>>>service.save()True>>>service.stop()True>>>service.start()True>>>service.delete()True

>>>importtutum>>>tutum.Container.list()[<tutum.api.container.Containerobjectat0x10701ca90>,<tutum.api.container.Containerobjectat0x10701ca91>]>>>container=tutum.Container.fetch("7d6696b7-fbaf-471d-8e6b-ce7052586c24")<tutum.api.container.Containerobjectat0x10701ca90>>>>container.public_dns="my-web-app.example.com">>>container.save()True>>>container.stop()True>>>container.start()True>>>container.logs"2014-03-24 23:58:08,973 CRIT Supervisor running as root (no user in config file) [...]">>>container.delete()True