digitalocean.com管理水滴和图像的api
python-digitalocean的Python项目详细描述
这个库提供了对要部署的数字海洋api的简单访问 水滴,图像等等。
如何安装
您可以使用pip安装python digitalocean
或通过来源:pip install -U python-digitalocean
python setup.py install
功能
python digitalocean支持通过 digitalocean.com API,如:
- 获取用户的液滴
- 获取用户的图像(快照和备份)
- 获取公共图像
- 获取液滴的事件状态
- 创建并移除液滴
- 调整液滴大小
- 关闭、重新启动并引导液滴
- 关闭电源、打开电源并“重启”液滴
- 执行快照
- 启用/禁用自动备份
- 还原液滴的根密码
示例
列出水滴
此示例显示如何列出所有活动液滴:
importdigitaloceanmanager=digitalocean.Manager(token="secretspecialuniquesnowflake")print(manager.get_all_droplets())
关闭所有液滴
此示例显示如何关闭所有活动液滴:
importdigitaloceanmanager=digitalocean.Manager(token="secretspecialuniquesnowflake")my_droplets=manager.get_all_droplets()fordropletinmy_droplets:droplet.shutdown()
创建液滴并检查其状态
此示例演示如何创建液滴以及如何检查其状态
importdigitaloceandroplet=digitalocean.Droplet(token="secretspecialuniquesnowflake",name='Example',region='nyc2',# New York 2image='ubuntu-14-04-x64',# Ubuntu 14.04 x64size_slug='512mb',# 512MBbackups=True)droplet.create()
检查液滴的状态
actions=droplet.get_actions()foractioninactions:action.load()# Once it shows complete, droplet is up and runningprintaction.status
将sshkey添加到DigitalOcean帐户
fromdigitaloceanimportSSHKeyuser_ssh_key=open('/home/<$USER>/.ssh/id_rsa.pub').read()key=SSHKey(token='secretspecialuniquesnowflake',name='uniquehostname',public_key=user_ssh_key)key.create()
使用所有ssh密钥创建一个新的水滴
manager=digitalocean.Manager(token="secretspecialuniquesnowflake")keys=manager.get_all_sshkeys()droplet=digitalocean.Droplet(token="secretspecialuniquesnowflake",name='DropletWithSSHKeys',region='ams3',# Amsterimage='ubuntu-14-04-x64',# Ubuntu 14.04 x64size_slug='512mb',# 512MBssh_keys=keys,#Automatic conversionbackups=False)droplet.create()
测试
使用Docker进行测试
要测试这个python digitalocean,您可以使用 docker要有一个干净的环境 自动。首先,您必须通过运行 存储库目录中的shell:
docker build -t "pdo-tests" .
然后,您可以运行所有测试(针对python 2和python 3)
docker run pdo-tests
note:这将使用ubuntu 14.04作为基础,并使用存储库 运行测试。所以每次编辑文件时,请运行以下命令 对更改执行测试。
使用pytest手动测试
使用pytest执行测试。它是 建议使用专用的virtualenv执行测试,使用这些 命令:
$ virtualenv /tmp/digitalocean_env $ source /tmp/digitalocean_env/bin/activate $ pip install -r requirements.txt
要手动运行所有测试,请使用py.test命令:
$ python -m pytest