如何使用OpenStack CLI

发布时间：2021-11-10 17:47:24 作者：柒染
来源：亿速云阅读：185

# 如何使用OpenStack CLI

## 1. 简介

OpenStack是一个开源的云计算管理平台项目，提供了一系列组件用于构建和管理公有云和私有云环境。虽然OpenStack提供了直观的Web界面（Horizon），但命令行接口（CLI）仍然是管理员和开发人员执行自动化任务、批量操作和高级配置的首选工具。

本文将详细介绍如何安装、配置和使用OpenStack CLI工具，包括常见命令示例和最佳实践。

## 2. 安装OpenStack CLI

### 2.1 前提条件

在开始之前，请确保：
- 已安装Python 3.6或更高版本
- 有可用的pip包管理器
- 拥有OpenStack环境的访问凭证

### 2.2 安装OpenStack客户端

```bash
# 安装OpenStack客户端核心包
pip install python-openstackclient

# 可选：安装特定服务客户端
pip install python-novaclient python-glanceclient python-neutronclient

2.3 验证安装

openstack --version

3. 配置认证信息

3.1 获取认证凭证

从OpenStack管理员处获取以下信息： - 认证URL (OS_AUTH_URL) - 项目名称/ID (OS_PROJECT_NAME/OS_PROJECT_ID) - 用户名 (OS_USERNAME) - 密码 (OS_PASSWORD) - 用户域和项目域 (OS_USER_DOMN_NAME/OS_PROJECT_DOMN_NAME)

3.2 创建clouds.yaml文件（推荐）

在~/.config/openstack/clouds.yaml中创建配置文件：

clouds:
  mycloud:
    auth:
      auth_url: https://your-openstack-api:5000/v3
      username: "your-username"
      password: "your-password"
      project_name: "your-project"
      user_domain_name: "Default"
      project_domain_name: "Default"
    region_name: "RegionOne"
    interface: "public"
    identity_api_version: 3

3.3 环境变量方式（备选）

export OS_AUTH_URL=https://your-openstack-api:5000/v3
export OS_USERNAME="your-username"
export OS_PASSWORD="your-password"
export OS_PROJECT_NAME="your-project"
export OS_USER_DOMN_NAME="Default"
export OS_PROJECT_DOMN_NAME="Default"

4. 常用命令参考

4.1 身份认证

# 获取token
openstack token issue

# 验证凭证
openstack catalog list

4.2 计算服务（Nova）

# 列出所有实例
openstack server list

# 创建新实例
openstack server create --flavor m1.small --image cirros --network private-net my-instance

# 查看实例详情
openstack server show my-instance

# 删除实例
openstack server delete my-instance

4.3 镜像服务（Glance）

# 列出所有镜像
openstack image list

# 上传新镜像
openstack image create --file ubuntu-20.04.qcow2 --disk-format qcow2 --container-format bare "Ubuntu 20.04"

# 删除镜像
openstack image delete "Ubuntu 20.04"

4.4 网络服务（Neutron）

# 列出所有网络
openstack network list

# 创建新网络
openstack network create private-net

# 创建子网
openstack subnet create --network private-net --subnet-range 192.168.1.0/24 private-subnet

# 查看网络详情
openstack network show private-net

4.5 块存储服务（Cinder）

# 列出所有卷
openstack volume list

# 创建新卷
openstack volume create --size 10 my-volume

# 将卷附加到实例
openstack server add volume my-instance my-volume

5. 高级用法

5.1 使用JSON输出

openstack server list -f json

5.2 筛选结果

# 按名称筛选
openstack server list --name web-server

# 按状态筛选
openstack server list --status ACTIVE

5.3 批量操作

# 批量停止所有运行中的实例
for server in $(openstack server list --status ACTIVE -f value -c ID); do
    openstack server stop $server
done

5.4 自动化脚本示例

#!/usr/bin/env python3
from openstack import connection

conn = connection.Connection(
    auth_url="https://your-openstack-api:5000/v3",
    username="your-username",
    password="your-password",
    project_name="your-project",
    user_domain_name="Default",
    project_domain_name="Default"
)

# 创建新实例
instance = conn.compute.create_server(
    name="auto-created-instance",
    flavor_id="m1.small",
    image_id="cirros",
    networks=[{"uuid": "network-id"}]
)
print(f"Created instance: {instance.id}")

6. 常见问题排查

6.1 认证失败

检查clouds.yaml文件权限（应为600）
验证凭证是否过期
确认API端点可访问

6.2 命令执行超时

检查网络连接
增加超时设置：openstack --os-compute-api-timeout=60 server list

6.3 资源不足

检查配额：openstack quota show
查看资源使用情况：openstack limits show

7. 最佳实践

使用配置文件：优先使用clouds.yaml而非环境变量
权限管理：遵循最小权限原则
脚本化操作：将重复任务编写为脚本
版本控制：记录CLI工具版本
日志记录：重要操作前启用调试模式：openstack --debug server list

8. 结论

OpenStack CLI提供了强大而灵活的方式来管理云资源。通过掌握命令行工具，您可以：

更高效地执行批量操作
实现自动化运维
深入理解OpenStack架构
解决Web界面无法处理的复杂场景

建议定期查阅OpenStack官方文档以获取最新命令参考和功能更新。

注意：本文基于OpenStack Yoga版本编写，不同版本间命令可能存在差异。 “`

这篇文章共计约1950字，采用Markdown格式编写，包含了从安装配置到高级用法的完整内容，并按照技术文档的规范进行了结构化组织。您可以根据实际OpenStack版本和环境需求调整具体参数和命令示例。