图文精华

About云-梭伦科技»专题 › 技术学习(版主发帖区) › 云技术学习 › OpenStack API介绍及使用快速入门
分享

OpenStack API介绍及使用快速入门

howtodown 发表于 2015-3-17 00:16:42 [显示全部楼层] 回帖奖励 阅读模式 关闭右栏 0 47859
About云VIP帮助找工作和提升
本帖最后由 howtodown 于 2015-3-17 00:19 编辑

问题导读

1.什么是 OpenStack API？
2.证书包含哪些信息？
3.令牌发送API请求，请求头中包含什么字段？
4.如何通过curl使用令牌？
5.得到401请求时，是什么原因造成的？
6. 向API发送请求的方式有几种？







OpenStack系统包含几个核心项目，他们是分开安装的，但能共同工作，取决于你的云的需求：OpenStack计算服务，OpenStack对象存储，OpenStack身份服务，和OpenStack镜像存储。借助TryStack中OpenStack安装， OpenStack计算服务，OpenStack标识服务，和OpenStack镜像存储几个项目共同工作在一起。
OpenStack API介绍
本页包含使用计算API与OpenStack云之间交互的基础知识，这是在通过身份服务API完成认证之后。你可以启动镜像，赋予实例元数据，构建一个云，这些全部可以采用API完成。在docs.openstack.org/api里发布有一份API参考，包含所有有效的命令，OpenStack Compute API 1.1 规范 和 Identity Service 2.0 规范。


获取证书
证书是个组合信息，包括你的用户名、密码，以及云运行在哪个租户（或者说，项目）之下。当你与云直接通过API服务端口交互的时候，你只需要生成一个附加令牌。你的云管理员会提供你的用户名，密码，以及你的租户标识符，你可以根据这些信息生授权令牌。你还可以从dasboard URL那里得到租户标识符，例如，https://trystack.org/dash/296/images/里面表明了租户标识符为296。
通常来说，这些令牌24小时之内是有效的，当令牌过期后，你会得到401（未授权）错误，那时你可以通过程序请求另外一张令牌。一般的工作流程如下所示：
1.开始API请求之前，首先要从云管理员提供的服务端口那里请求授权令牌，服务端口通常是http://hostname:port/v2.0/tokens。发送你的用户名，密码，和你所属的组或者帐户（也就是auth-speak中的”租户“）
  1. curl -k -X 'POST' -v https://nova-api.trystack.org:5443/v2.0/tokens -d '{"auth":{"passwordCredentials":{"username": "joecool", "password":"coolword"}, "tenantId":"5"}}' -H 'Content-type: application/json'
复制代码


2.服务器返回响应消息，其中含有一个24小时有效的令牌。可以使用这个令牌发送API请求，请求头中包含X-Auth-Token字段。
  1. curl -k -D - -H "X-Auth-Token: 7d2f63fd-4dcc-4752-8e9b-1d08f989cc00" -X 'GET' -v https://nova-api.trystack.org:9774/v1.1/296/extensions  -H 'Content-type: application/json' 
复制代码


3.将这个令牌置于信息头x-auth-token中，反复发送API请求，直到任一种情况发生：1)任务完成，或者2)你得到401（未授权）响应


4.当你得到401的响应时，再次请求令牌，直到脚本任务完成。

对一个使用身份服务的典型的OpenStack部署来说，你可以通过cURL的这个命令来请求令牌：

  1. $ curl -X 'POST' -v https://nova-api.trystack.org:5443/v2.0/tokens -d '{"auth":{"passwordCredentials":{"username": "joecool", "password":"coolword"}, "tenantId":"5"}}' -H 'Content-type: application/json'
复制代码


作为回复，你会得到一个200 OK的响应，同时以“id”的形式，带回一个令牌："cd427a33-bb4a-4079-a6d7-0ae148bdeda9"和一个有效期：从现在开始的24小时。响应消息看起来如下所示:
  1. {

  2.     "access": {

  3.         "serviceCatalog": [

  4.             {

  5.                 "endpoints": [

  6.                     {

  7.                         "adminURL": "https://nova-api.trystack.org:9774/v1.1/1", 

  8.                         "internalURL": "https://nova-api.trystack.org:9774/v1.1/1", 

  9.                         "publicURL": "https://nova-api.trystack.org:9774/v1.1/1", 

  10.                         "region": "RegionOne"

  11.                     }

  12.                 ], 

  13.                 "name": "nova", 

  14.                 "type": "compute"

  15.             }, 

  16.             {

  17.                 "endpoints": [

  18.                     {

  19.                         "adminURL": "https://GLANCE_API_IS_NOT_DISCLOSED/v1.1/1", 

  20.                         "internalURL": "https://GLANCE_API_IS_NOT_DISCLOSED/v1.1/1", 

  21.                         "publicURL": "https://GLANCE_API_IS_NOT_DISCLOSED/v1.1/1", 

  22.                         "region": "RegionOne"

  23.                     }

  24.                 ], 

  25.                 "name": "glance", 

  26.                 "type": "image"

  27.             }, 

  28.             {

  29.                 "endpoints": [

  30.                     {

  31.                         "adminURL": "https://nova-api.trystack.org:5443/v2.0", 

  32.                         "internalURL": "https://keystone.trystack.org:5000/v2.0", 

  33.                         "publicURL": "https://keystone.trystack.org:5000/v2.0", 

  34.                         "region": "RegionOne"

  35.                     }

  36.                 ], 

  37.                 "name": "keystone", 

  38.                 "type": "identity"

  39.             }

  40.         ], 

  41.         "token": {

  42.             "expires": "2012-02-15T19:32:21", 

  43.             "id": "5df9d45d-d198-4222-9b4c-7a280aa35666", 

  44.             "tenant": {

  45.                 "id": "1", 

  46.                 "name": "admin"

  47.             }

  48.         }, 

  49.         "user": {

  50.             "id": "14", 

  51.             "name": "annegentle", 

  52.             "roles": [

  53.                 {

  54.                     "id": "2", 

  55.                     "name": "Member", 

  56.                     "tenantId": "1"

  57.                 }

  58.             ]

  59.         }

  60.     }

  61. }

复制代码


向API发送请求
要通过API向OpenStack发送请求，你有很多选择。开发人员和测试人员可能喜欢使用cURL，一个命令行工具，下载地址为http://curl.haxx.se/。使用cURL，你可以通过命令行发送HTTP请求和接收响应。
如果你希望采用一个更图形化的界面，Firefox的REST客户端也可以用于测试和尝试命令。参见https://addons.mozilla.org/en-US/firefox/addon/restclient/。你也可以下载和安装rest-client，一个Java应用，来测试RESTful web服务，下载地址为http://code.google.com/p/rest-client/。
如果你使用cURL或者REST客户端，你需要生成一个令牌，如上面所示。



安装python-novaclient


你可以通过使用客户端，比如python-novalcient或者python-comput客户端，做更多的复杂工作。Python-novaclient实现了Compute 1.1 的 API。openstack-compute客户端工作在Rackspace Cloud Servers公有云之上，实现的是OpenStack Compute 1.0 API. 使用Python-novaclient工具时，你只需要提供用户名和密码。
安装python-novaclient后，就会生成一个nova shell命令行，它可以通过命令行形式调用Compute API。你安装客户端，提供你的用户名和密码，为方便起见，可以把他们设为环境变量，之后，你就可以在命令行窗口向你的云发送命令了。
安装 python-novaclient，如下所示，获取稳定的nova版本



  1.  pip install -e git+https://github.com/openstack/python-novaclient.git#egg=python-novaclient
复制代码


现在你已经完成python-novaclient的安装，确认安是否装成功，请输入：
  1.  nova help

  2. 

  3. usage: nova [--debug] [--os_username OS_USERNAME] [--os_password OS_PASSWORD]

  4.             [--os_tenant_name OS_TENANT_NAME] [--os_auth_url OS_AUTH_URL]

  5.             [--os_region_name OS_REGION_NAME] [--service_type SERVICE_TYPE]

  6.             [--service_name SERVICE_NAME] [--endpoint_type ENDPOINT_TYPE]

  7.             [--version VERSION]

  8.             <subcommand> ...
复制代码


作为返回，你将得到nova命令行客户端中的所有的命令和参数的列表。通过将所需参数设为环境变量，你可以在命令行中快速使用这些命令。你可以在nova命令中添加--os_username，或者设定为环境变量。当使用TryStack时，你将得到一个端点（endpoint），这个端点就是nova客户端认定的NOVA_URL。在TryStack中，登录后你可以从https://trystack.org/dash/api_info/看到这些环境变量。
  1. export NOVA_USERNAME=facebook12345679       

  2. export NOVA_API_KEY=coolword

  3. export NOVA_PROJECT_ID=facebook12345679       

  4. export NOVA_URL=https://nova-api.trystack.org:5443/v2.0       

  5. export NOVA_VERSION=1.1
复制代码


列出所有的镜像
在你开始搭建你的云之前，你应该知道有哪些镜像是可用的。这可以通过询问镜像服务”有哪几种可用的配置类型“来实现。镜像服务类似于云计算中的iTunes - 在使用你喜爱的镜像创建新的实例之前，你可以查看镜像的播放类表。要得到镜像列表、他们的名字、状态和ID，使用如下命令：


  1. nova image-list

  2. 

  3. +----+--------------------------------------+--------+--------+

  4. | ID |                 Name                 | Status | Server |

  5. +----+--------------------------------------+--------+--------+

  6. | 12 | natty-server-cloudimg-amd64-kernel   | ACTIVE |        |

  7. | 13 | natty-server-cloudimg-amd64          | ACTIVE |        |

  8. | 14 | oneiric-server-cloudimg-amd64-kernel | ACTIVE |        |

  9. | 15 | oneiric-server-cloudimg-amd64        | ACTIVE |        |

  10. +----+--------------------------------------+--------+--------+
复制代码


下一步，你需要知道他们中每一个的相对大小。
  1. $ nova flavor-list

  2.         

  3. +----+-----------+-----------+------+-----------+------+-------+-------------+

  4. | ID |    Name   | Memory_MB | Disk | Ephemeral | Swap | VCPUs | RXTX_Factor |

  5. +----+-----------+-----------+------+-----------+------+-------+-------------+

  6. | 1  | m1.tiny   | 512       | 0    | N/A       | 0    | 1     |             |

  7. | 2  | m1.small  | 2048      | 20   | N/A       | 0    | 1     |             |

  8. | 3  | m1.medium | 4096      | 40   | N/A       | 0    | 2     |             |

  9. | 4  | m1.large  | 8192      | 80   | N/A       | 0    | 4     |             |

  10. | 5  | m1.xlarge | 16384     | 160  | N/A       | 0    | 8     |             |

  11. +----+-----------+-----------+------+-----------+------+-------+-------------+        

  12.     
复制代码
你还可以缩小列表范围，通过用grep来只查找Ubuntu 11.04的镜像，命令如下所示：

  1. $ nova image-list | grep 'natty'

  2. 

  3. | 12 | natty-server-cloudimg-amd64-kernel   | ACTIVE |        |

  4. | 13 | natty-server-cloudimg-amd64          | ACTIVE |        |
复制代码
使用这些对你来说有用的信息，你可以选择镜像和类型的组合来创建你的虚拟服务器，启动实例。























关注公众号，获取大数据、人工智能20套、区块链资源5阶段等资源，随时更新，获取最新技术资源
回复

使用道具 举报

自定义广告语

没找到任何评论，期待你打破沉寂

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

发表新帖
howtodown

版主

关注

  • 666

    主题

  • 1249

    帖子

  • 321

    粉丝

TA的主题
关闭

推荐上一条 /2 下一条

关于我们· 联系我们· 加入我们· 小黑屋· 合作伙伴   

Copyright © 2001-2024 About云-梭伦科技 Powered by Discuz! X3.4 Licensed Discuz Team.

简书 / Smrz 京ICP备2020039040号 Wxb 简书网举报电话：021-34700000