先日、Ansible2.0がリリースされました。アップデートの詳細はこちらのリリース記事訳を参照していただくとして、ここではその中でも大幅に強化されたOpenStack API操作モジュールについて、その概要や簡単な使い方を紹介します。
OpenStack上でシステムを構成する一通りのモジュールが揃った
これまでのバージョン1.X系でも、OpenStack上でのインスタンス作成・削除やネットワーク作成・削除といった簡単な機能を提供するモジュールはあったようですが、操作できるAPIは限られていました。しかし、今回のアップデートでは、OpenStackのIaaSとしての機能ほとんどをカバーしているようです。
これにより、 Ansibleだけでインフラのプロビジョニングからアプリケーションのデプロイまで 可能になったことになります。これまでは、インフラのプロビジョニングはHeatやVagrantで行い、アプリケーションのデプロイはAnsibleで行うなど、複数の技術を組み合わせる必要がありましたが、全てをAnsibleだけでできるというのは非常に魅力的なのではないでしょうか。
OpenStack関連モジュールの一覧は公式ドキュメントで確認できます。
OpenStackモジュールの使い方
それでは早速OpenStackモジュールを使ってみましょう。今回はOpenStackのテナント上に何のリソースも無い状態から、以下の環境を構成します。
- ネットワーク: demo-net
- サブネット: demo-subnet(10.0.0.0/24)
- ルータ: demo-router
- セキュリティグループ: demo-sg
- セキュリティグループルール: tcp/22許可
- キーペア: demo-key
- インスタンス: demo-instance
ネットワークトポロジー
動作環境
- CentOS6.6
- python 2.7.10（virtualenv環境を使用しました）
- OpenStack Juno
Ansibleのインストール
pipでもインストールできますが、まだOpenStackモジュールにバグがあったりするので（すでにいくつかハマった）Githubの開発ブランチを使用するようにします。公式ドキュメントでも多くのユーザが開発ブランチを利用していると書いてあります。
リポジトリをクローンして、セットアップスクリプトを読み込みます。
$ git clone https://github.com/ansible/ansible.git --recursive
$ cd ansible
$ source hacking/env-setup
$ ansible --version
ansible 2.1.0 (devel e3a6accc1d) last updated 2016/01/20 23:06:19 (GMT +900)
lib/ansible/modules/core: (detached HEAD ffea58ee86) last updated 2016/01/20 23:06:30 (GMT +900)
lib/ansible/modules/extras: (detached HEAD e9450df878) last updated 2016/01/20 23:06:33 (GMT +900)
config file =
configured module search path = Default w/o overrides
Ansibleが依存するPythonライブラリと、OpenStackモジュールが依存するshadeというライブラリをインストールしておきます。
$ pip install paramiko PyYAML Jinja2 httplib2 six
$ pip install shade
OpenStack認証ファイル
OpenStack APIのクライアントライブラリであるshadeは、OpenStackの認証情報をclouds.ymlという名前のファイルから読み込みます。これをカレントディレクトリに作成します。
clouds:
demo:
auth:
auth_url: http://keystone:5000/v2.0
username: demo
password: secret
project_name: demo
authの部分は適宜ご自身の環境に合わせて修正してください。2行目のdemoは、操作対象となるOpenStackテナントを識別する任意の名前です。このファイルには複数のOpenStackテナントを定義できて、例えばstagingとproductionを定義して、Playbook内で使い分けるということができます。
Playbook
Playbookを以下の通り作成します。
ディレクトリ構成
.
├── clouds.yml
├── roles
│ └── openstack
│ └── tasks
│ └── main.yml
└── site.yml
---
- name: create openstack resources
hosts: 127.0.0.1
connection: local
roles:
- openstack
---
- name: create network
os_network:
cloud: demo
state: present
name: demo-net
- name: create subnet
os_subnet:
cloud: demo
name: demo-subnet
network_name: demo-net
cidr: 10.0.0.0/24
dns_nameservers: 8.8.8.8
state: present
- name: create router
os_router:
cloud: demo
name: demo-router
state: present
network: publicNW
interfaces:
- demo-subnet
- name: create security group
os_security_group:
cloud: demo
state: present
name: demo-sg
- name: add security group rule
os_security_group_rule:
cloud: demo
state: present
security_group: demo-sg
protocol: tcp
port_range_min: 22
port_range_max: 22
remote_ip_prefix: 0.0.0.0/0
- name: create keypair
os_keypair:
cloud: demo
state: present
name: demo-key
register: keypair_info
- name: create private key
copy:
content: "{{ keypair_info['key']['private_key'] }}"
dest: ./demo-key-private.pem
mode: 0600
- name: create instance
os_server:
cloud: demo
state: present
name: demo-instance
image: centos7.0
flavor: 1
key_name: demo-key
security_groups: demo-sg
network: demo-net
floating_ip_pools: publicNW
以下のコマンドでPlaybookを実行します。
$ ansible-playbook site.yml
Playbookについて簡単に解説します。
まず、起点となるsite.ymlでは、hosts: 127.0.0.1を指定し、connection: localとしています。今回はリモートサーバにSSHログインして何か設定を行うというのではなく、Playbookを実行するホストからOpenStack APIを操作するという処理なので、このような書き方になっています。
main.ymlでは、os_*というモジュールを使用しており、これがOpenStackモジュールになります。os_*モジュールにはcloudというパラメータがあり、この値のdemoとclouds.ymlで記述したdemoが対応します。demoというOpenStackテナントに対してリソースを作成するということです。
各タスクの意味は公式ドキュメントを見ていただければすぐわかると思いますので、解説は割愛します。一点だけ、create private keyタスクでは、その上のcreate keypairタスクのレスポンスからSSH秘密鍵を取り出して、ローカルに鍵ファイルを作成するという処理を行っています。
まとめ
Ansible2.0でアップデートされたOpenStackモジュールについて、その概要と簡単な使い方をご紹介しました。Ansibleの適用範囲がインフラにまで広がったことで、Ansible一つでテスト・プロダクション環境構築、オートスケーリング、リリース等のシステムライフサイクル全般を賄うことができそうです。