openstacksdk快速上手

hello，大家好，这里是费冰，今天是大年初六，唉，这么早就被迫营业了。

那么今天来解读一波openstacksdk。

Openstacksdk是什么

其实我很难说明一个是什么的问题。如果你使用过python，了解过sdk的概念，那么openstack sdk对你应该很容易理解。这是一个封装好的工具包，里面有众多可以帮助我们操作 openstack的方法，有了sdk，一方面我们可以直接使用已封装的功能，这将节省大量的时间，另一方面我们可以基于sdk开发更高级的功能。

下面我将演示如何使用openstacksdk。

如何使用openstacksdk

概述

openstack对外提供几种不同的接口：

RESTful API
openstackclient
openstack SDKS

RESTful API已经介绍过，openstackclient就是openstack命令行，日常使用我们已经很熟悉了。

:::info

:::

安装

在使用之前，需要使用pip安装openstack

pip install openstacksdk

配置

openstacksdk在使用的时候，首先得完成和openstack进行认证的过程。openstacksdk提供了几种简便的认证方法。可以直接在连接时传入认证数据，也可以使用配置文件来提供认证数据，我将演示这两种方法。

clouds.yaml文件

如果使用配置文件的形式，那么你需要准备一个clouds.yaml文件，将这个文件放置在python文件同目录下，这个文件的内容如下：

clouds:

  zed:

    region_name: RegionOne

    auth:

      project_domain_name: Default

      user_domain_name: Default

      username: admin

      password: passwordadmin

      project_name: admin

      auth_url: http://192.168.10.25:5000

clouds.yaml文件的查找顺序是：

本目录(python运行文件的目录)
~/.config/openstack/目录
/etc/openstack/目录

直接传入认证数据

使用connect方法来创建一个连接，如下所示：

def create_connection(auth_url, region, project_name, username, password,

                      user_domain, project_domain):

    return openstack.connect(

        auth_url=auth_url,

        project_name=project_name,

        username=username,

        password=password,

        region_name=region,

        user_domain_name=user_domain,

        project_domain_name=project_domain,

    )

使用

完成openstack的配置之后，我们就可以很容易的使用openstacksdk来和openstack进行交互，这里我将演示如何编写python文件来创建一个云主机。

当然，在使用之前，还得有一个正常运行的openstack集群。

为了将代码完整展示，我在这里使用的是直接传入参数来定义的连接。

列出所有用户

示例如下：

import openstack

#定义连接函数，从参数中直接传入信息

def create_connection(auth_url, region, project_name, username, password, user_domain, project_domain):

  	return openstack.connect(

      	auth_url=auth_url,

      	roject_name=project_name,

        username=username,

        password=password,

        region_name=region,

        user_domain_name=user_domain,

        project_domain_name=project_domain,

    )

# 创建连接

conn = create_connection("http://192.168.10.25:5000","RegionOne","admin","admin","passwordadmin","Default","Default")

if __name__ == '__main__':

  	#列出所有用户

    for user in conn.list_users():

        print(user.to_dict())

观察这个示例我们发现，openstacksdk的使用比RESTful API简便了许多，这是因为sdk已经将api的操作封装好，我们只需要方便的拿出使用就可以了。

以上是一个列出所有用户的小例子。如果我们想要在openstack中创建一台云主机，那么可用的镜像，可用的网络，合适的云主机类型都是必须的。接下来我来演示如何创建这些资源。

镜像操作

注意，python文件中的定义连接函数和创建连接已省略，以下只列出主要代码段落。

列出镜像

for image in conn.list_images():

  	print(image)

创建镜像

def create_image(conn):

		# 镜像文件

    filename = 'G:\\cirros-0.5.1-x86_64-disk.img'

    # 创建镜像并上传镜像文件

    image_attrs = {

        'name': EXAMPLE_IMAGE_NAME,

        'filename': filename,

        'disk_format': 'raw',

        'container_format': 'bare',

        'visibility': 'public',

    }

    conn.create_image(**image_attrs)

网络操作

列出网络

def list_network(conn):

  	for network in conn.list_networks():

      	print(network)

列出子网

def list_subnet(conn):

  	for subnet in conn.list_subnets():

      	print(subnet)

列出路由器

def list_routers(conn):

  	for router in conn.list_routers():

      	print(router)

创建网络

def create_network(conn):

  	network = conn.create_network(name="example_network")

  	subnet = conn.create_subnet(

      	name='example-subnet',

        network_id=network.id,

        ip_version='4',

        cidr='10.0.2.0/24',

        gateway_ip='10.0.2.1')

  	print(network)

问题来了，如果我想要创建一个外部网络怎么办呢？

这里其实就比普通的网络创建多两个参数，示例如下:

def create_network(conn):

  	# 外部网络参数，必须和实际环境对应

		privoder = {'physical_network':'External','network_type':flat}

  	# 所属project_id

  	project_id=admin

		network = conn.create_network(name="example_network",provider=provider,project_id=project_id)

  	subnet = conn.create_subnet(

      	name='example-subnet',

        network_id=network.id,

        ip_version='4',

        cidr='10.0.2.0/24',

        gateway_ip='10.0.2.1')

  	print(network)

云主机操作

创建云主机类型

def create_flavor(conn)

  	flavor = conn.create_flavor(

      	name='example-flavor',

      	ram='1024',

      	vcpus='1',

      	disk='10',

      	flavorid="auto",

  	)

  	print(flavor)

列出云主机类型

def list_flavors(conn):

  	for flavor in conn.list_flavors():

      	print(flavor)

至此，我们已经拿到了创建云主机的所有必须资源，现在让我们试着创建云主机：

创建云主机

def create_server(conn):

    image = conn.get_image_id("cirros")

    flavor = conn.get_flavor("m1.tiny").id

    network = conn.get_network("network").id

    server = conn.compute.create_server(

        name=SERVER_NAME, image=image, flavor_id=flavor,

        network=network)

    server = conn.wait_for_server(server)

  	print(server)

总结

以上就是openstacksdk的一些常用操作了，openstack里有太多常用的操作，只有掌握其中规律，多做练习才能掌握。

巴特西