このエントリーをはてなブックマークに追加

6.2.3. Identity Service(Keystone)のインストール

OpenStack Identity Serviceのコード名はKeystoneです。
Keystoneはユーザ、テナント(プロジェクト)などOpenStackのコンポーネント全ての共通認証・認可を一括管理するコンポーネントです。
Keystoneをインストールすることによって各々のコンポーネントで認証・認可を行う必要がなくなります。

6.2.3.1. Keystoneのダウンロード

Keystoneのソースをダウンロードします。
またKeystoneAPIを利用するためのクライアントもダウンロードしておきます。
ダウンロードしたバージョンはMasterになっているためバージョンはどちらもFolsomにします。

6.2.3.1.1. Keystoneのソースをダウンロード

$ sudo git clone git://github.com/openstack/keystone /opt/keystone
$ sudo git clone git://github.com/openstack/python-keystoneclient /opt/python-keystoneclient

6.2.3.1.2. KeystoneのバージョンをFolsomに固定

$ cd /opt/keystone ; sudo git checkout -b folsom origin/stable/folsom

6.2.3.2. Keystoneのインストール

ダウンロードしたKeystoneとクライアントをインストールします。
pipでパッケージの依存関係を解決します。
$ sudo pip install -r /opt/keystone/tools/pip-requires
$ cd /opt/keystone && sudo python setup.py install
$ sudo pip install -r /opt/python-keystoneclient/tools/pip-requires
$ cd /opt/python-keystoneclient && sudo python setup.py install

6.2.3.3. Keystoneが利用するユーザ、ディレクトリなどの作成

ソースからインストールする場合はユーザやディレクトリを作成する必要がありますので作成します。
$ sudo useradd keystone -m -d /var/lib/keystone -s /bin/false
$ sudo mkdir /etc/keystone
$ sudo mkdir /var/log/keystone
$ sudo chown keystone:keystone /var/log/keystone

6.2.3.4. Keystoneのコンフィグ

keystoneのコンフィグを行います。
$ mkdir /etc/keystone
$ sudo cp -a /opt/keystone/etc/* /etc/keystone
$ sudo mv /etc/keystone/keystone.conf.sample /etc/keystone/keystone.conf
$ sudo mv /etc/keystone/logging.conf.sample /etc/keystone/logging.conf
コンフィグはほとんどがコメントを外すだけです。
変更する箇所としては admin_token 、 SQLの接続設定( connection ) 、TokenとEC2の箇所をkvsからsqlに変更しています。
$ sudo vi /etc/keystone/keystone.conf

[DEFAULT]
# A "shared secret" between keystone and other openstack services
admin_token = ADMIN

# The IP address of the network interface to listen on
bind_host = 0.0.0.0

# The port number which the public service listens on
public_port = 5000

# The port number which the public admin listens on
admin_port = 35357

# The port number which the OpenStack Compute service listens on
compute_port = 8774

# === Logging Options ===
# Print debugging output
verbose = True

# Print more verbose output
# (includes plaintext request logging, potentially including passwords)
debug = True

# Name of log file to output to. If not set, logging will go to stdout.
log_file = keystone.log

# The directory to keep log files in (will be prepended to --logfile)
log_dir = /var/log/keystone

# Use syslog for logging.
# use_syslog = False

# syslog facility to receive log lines
# syslog_log_facility = LOG_USER

# If this option is specified, the logging configuration file specified is
# used and overrides any other logging options specified. Please see the
# Python logging module documentation for details on logging configuration
# files.
# log_config = logging.conf

# A logging.Formatter log message format string which may use any of the
# available logging.LogRecord attributes.
# log_format = %(asctime)s %(levelname)8s [%(name)s] %(message)s

# Format string for %(asctime)s in log records.
# log_date_format = %Y-%m-%d %H:%M:%S

# onready allows you to send a notification when the process is ready to serve
# For example, to have it notify using systemd, one could set shell command:
# onready = systemd-notify --ready
# or a module with notify() method:
# onready = keystone.common.systemd

[sql]
# The SQLAlchemy connection string used to connect to the database
connection = mysql://keystone:password@stack01/keystone?charset=utf8

# the timeout before idle sql connections are reaped
idle_timeout = 200

[identity]
driver = keystone.identity.backends.sql.Identity

[catalog]
# dynamic, sql-based backend (supports API/CLI-based management commands)
driver = keystone.catalog.backends.sql.Catalog

# static, file-based backend (does *NOT* support any management commands)
# driver = keystone.catalog.backends.templated.TemplatedCatalog

# template_file = default_catalog.templates

[token]
# driver = keystone.token.backends.kvs.Token
driver = keystone.token.backends.sql.Token

# Amount of time a token should remain valid (in seconds)
# expiration = 86400

[policy]
driver = keystone.policy.backends.rules.Policy

[ec2]
# driver = keystone.contrib.ec2.backends.kvs.Ec2
driver = keystone.contrib.ec2.backends.sql.Ec2

[ssl]
#enable = True
#certfile = /etc/keystone/ssl/certs/keystone.pem
#keyfile = /etc/keystone/ssl/private/keystonekey.pem
#ca_certs = /etc/keystone/ssl/certs/ca.pem
#cert_required = True

[signing]
#token_format = UUID
#certfile = /etc/keystone/ssl/certs/signing_cert.pem
#keyfile = /etc/keystone/ssl/private/signing_key.pem
#ca_certs = /etc/keystone/ssl/certs/ca.pem
#key_size = 1024
#valid_days = 3650
#ca_password = None
#token_format = PKI

[ldap]
# url = ldap://localhost
# user = dc=Manager,dc=example,dc=com
# password = None
# suffix = cn=example,cn=com
# use_dumb_member = False

# user_tree_dn = ou=Users,dc=example,dc=com
# user_objectclass = inetOrgPerson
# user_id_attribute = cn
# user_name_attribute = sn

# tenant_tree_dn = ou=Groups,dc=example,dc=com
# tenant_objectclass = groupOfNames
# tenant_id_attribute = cn
# tenant_member_attribute = member
# tenant_name_attribute = ou

# role_tree_dn = ou=Roles,dc=example,dc=com
# role_objectclass = organizationalRole
# role_id_attribute = cn
# role_member_attribute = roleOccupant

[filter:debug]
paste.filter_factory = keystone.common.wsgi:Debug.factory

[filter:token_auth]
paste.filter_factory = keystone.middleware:TokenAuthMiddleware.factory

[filter:admin_token_auth]
paste.filter_factory = keystone.middleware:AdminTokenAuthMiddleware.factory

[filter:xml_body]
paste.filter_factory = keystone.middleware:XmlBodyMiddleware.factory

[filter:json_body]
paste.filter_factory = keystone.middleware:JsonBodyMiddleware.factory

[filter:user_crud_extension]
paste.filter_factory = keystone.contrib.user_crud:CrudExtension.factory

[filter:crud_extension]
paste.filter_factory = keystone.contrib.admin_crud:CrudExtension.factory

[filter:ec2_extension]
paste.filter_factory = keystone.contrib.ec2:Ec2Extension.factory

[filter:s3_extension]
paste.filter_factory = keystone.contrib.s3:S3Extension.factory

[filter:url_normalize]
paste.filter_factory = keystone.middleware:NormalizingFilter.factory

[filter:stats_monitoring]
paste.filter_factory = keystone.contrib.stats:StatsMiddleware.factory

[filter:stats_reporting]
paste.filter_factory = keystone.contrib.stats:StatsExtension.factory

[app:public_service]
paste.app_factory = keystone.service:public_app_factory

[app:admin_service]
paste.app_factory = keystone.service:admin_app_factory

[pipeline:public_api]
pipeline = stats_monitoring url_normalize token_auth admin_token_auth xml_body json_body debug ec2_extension user_crud_extension public_service

[pipeline:admin_api]
pipeline = stats_monitoring url_normalize token_auth admin_token_auth xml_body json_body debug stats_reporting ec2_extension s3_extension crud_extension admin_service

[app:public_version_service]
paste.app_factory = keystone.service:public_version_app_factory

[app:admin_version_service]
paste.app_factory = keystone.service:admin_version_app_factory

[pipeline:public_version_api]
pipeline = stats_monitoring url_normalize xml_body public_version_service

[pipeline:admin_version_api]
pipeline = stats_monitoring url_normalize xml_body admin_version_service

[composite:main]
use = egg:Paste#urlmap
/v2.0 = public_api
/ = public_version_api

[composite:admin]
use = egg:Paste#urlmap
/v2.0 = admin_api
/ = admin_version_api

6.2.3.5. データベースの作成

Keystoneが利用するデータベースを作成します。
Keystoneのデータベースを設定するためのユーザ、パスワードはMySQLをインストールした時のものですので注意して下さい。
データベース名keystone、ユーザ名keystone、パスワードはpasswordとしているため適切なものへ変更してください。
ホスト名も同様にstack01としていますので変更が必要であればおこなって下さい。
$ MYSQL_PASS_KEYSTONE=password
$ NOVA_CONTOLLER_HOSTNAME=stack01
$ mysql -uroot -pnova -e "drop database if exists keystone;"
$ mysql -uroot -pnova -e "create database keystone character set utf8;"
$ mysql -uroot -pnova -e "grant all privileges on keystone.* to 'keystone'@'%' identified by '$MYSQL_PASS_KEYSTONE';"
$ mysql -uroot -pnova -e "grant all privileges on keystone.* to 'keystone'@'localhost' identified by '$MYSQL_PASS_KEYSTONE';"
$ mysql -uroot -pnova -e "grant all privileges on keystone.* to 'keystone'@'$NOVA_CONTOLLER_HOSTNAME' identified by '$MYSQL_PASS_KEYSTONE';"
$ sudo keystone-manage db_sync

6.2.3.6. プロセスの起動

Keystoneを起動します。がソースからのインストールの場合は起動スクリプトがありませんので用意します。

6.2.3.6.1. 起動スクリプトの用意

$ cat << 'KEYSTONE_INIT' | sudo tee /etc/init/keystone.conf > /dev/null
description "Keystone API server"
author "Soren Hansen <soren@linux2go.dk>"

start on (local-filesystems and net-device-up IFACE!=lo)
stop on runlevel [016]

respawn

exec su -s /bin/sh -c "exec keystone-all" keystone
KEYSTONE_INIT

6.2.3.6.2. プロセスの起動

作成した起動スクリプトを利用してKeystoneを起動します。

$ sudo stop keystone ; sudo start keystone
$ status keystone

6.2.3.7. データの作成

KeystoneにOpenStackで利用するサービス、サービスに対するユーザ、ロールの設定を行います。
ここではサンプルのシェルを利用して作成します。
実際には環境にあった設定を利用したシェルの作成などが必要かも知れません。
Swift、Quantum、Cinder、Heatを利用する際にはコマンドで追加する手順を記述しますので参考にして下さい。
サンプルを利用はしますがサンプルへ最低限の設定を行います。
サンプルシェルを利用するための環境変数を先に設定しています。

データ投入スクリプトのコピー

$ cd /usr/local/src ; sudo cp -a /opt/keystone/tools/sample_data.sh .

環境変数の設定

$ export CONTROLLER_HOST=stack01
$ export SERVICE_ENDPOINT=http://$CONTROLLER_HOST:35357/v2.0/
$ export ADMIN_PASSWORD=password
$ sudo sed -i "s/127.0.0.1/$CONTROLLER_HOST/" /usr/local/src/sample_data.sh
$ sudo sed -i "s/localhost/$CONTROLLER_HOST/" /usr/local/src/sample_data.sh
$ export ENABLE_ENDPOINTS=yes
$ sudo -E bash /usr/local/src/sample_data.sh

6.2.3.8. 設定確認

実際にデータが作成されていることを確認しましょう。
ユーザがkeystoneを操作するにはオプションを付与する必要があります。
操作するテナント名、テナントに対するユーザ名、パスワード、エンドポイントを設定する必要があります。
エンドポイントとは、APIを利用するための接続先であるURLのことです。
OpenStackの各コンポーネントはそれぞれエンドポイントを持つことになります。
ここではKeystoneのためのエンドポイントを環境変数に設定します。
エンドポイントにはパブリックURL、インターナルURL、管理用URLの3種類があります。
:header-rows: 1
エンドポイントの種類 概要
パブリックURL エンドユーザがアクセスするためのURL
インターナルURL LAN経由でアクセス可能なユーザのためのURL
管理用URL 管理者用がアクセスするためのURL
作成されたものをlistコマンドでそれぞれ確認してみます。
確認するには環境変数の設定が必要ですのでログインしなおしたりしている場合は再度設定しておいて下さい。
エンドポイント、サービスにもlistコマンドが用意されていますが実行すると501エラーが帰ってきます。
これは、データベースでなくファイルを利用する設定を行ったためですので問題ありません。
テナント、テナントに対するユーザとロール、AmazonAPIを利用するユーザ一覧を確認してみましょう。
一度ログアウトしてログインしなおしてみてから確認しましょう。
環境変数の読み込みを行ってから確認します。
$ export OS_USERNAME=admin
$ export OS_PASSWORD=password
$ export OS_TENANT_NAME=admin
$ export OS_AUTH_URL=http://stack01:35357/v2.0/
$ keystone tenant-list
+----------------------------------+--------------------+---------+
|                id                |        name        | enabled |
+----------------------------------+--------------------+---------+
| 26a8323191074571ac1fbc77b79f6e70 | invisible_to_admin | True    |
| 2bd056359b124bedb2eb3be9a07551ab | service            | True    |
| 9242ed0fd4d34bd98337389ca4eb1624 | admin              | True    |
| c2bedd4f992d402d96a103c962942921 | demo               | True    |
+----------------------------------+--------------------+---------+

$ keystone user-list
+----------------------------------+--------+---------+--------------------+
|                id                |  name  | enabled |       email        |
+----------------------------------+--------+---------+--------------------+
| 853f9fc38b154e25aa9f6351a84d428d | nova   | True    | nova@example.com   |
| 8df08ddece48459d8c7620a7173fcac8 | glance | True    | glance@example.com |
| c958352f4a4347019d203e649f5add73 | admin  | True    | admin@example.com  |
| f110a84d1b9f48408b61a06d6d8d0ef6 | demo   | True    | admin@example.com  |
+----------------------------------+--------+---------+--------------------+

$ keystone role-list
+----------------------------------+----------------------+
|                id                |         name         |
+----------------------------------+----------------------+
| 2f9699721ecc46f89850e44d30e6c1f6 | netadmin             |
| 3ddd4fe754de42838558a418f49a626e | KeystoneAdmin        |
| 44081e5483834bf4b722105b211aef92 | Member               |
| 48d1781037714a0f8e733946045334b3 | sysadmin             |
| 8ddd8fee806b48d0a302ddbce577cd02 | KeystoneServiceAdmin |
| f0b9eb05372a4d1bb602a332b1d63a67 | admin                |
+----------------------------------+----------------------+

$ keystone service-list
+----------------------------------+-------------+-----------+---------------------------+
|                id                |     name    |    type   |        description        |
+----------------------------------+-------------+-----------+---------------------------+
| 2de413d9283e456ebe6c0ed32641fca7 | nova        | compute   | Nova Compute Service      |
| 47234e35cd3741779ae0cbacd5ff3bae | ec2         | ec2       | EC2 Compatibility Layer   |
| 57cbfa53a4814990b7ff74d8ee7c20cb | keystone    | identity  | Keystone Identity Service |
| 6f32c545558144b5a4a5157ece4db46f | nova-volume | volume    | Nova Volume Service       |
| 7a18e9cc77ad4b8388836a9846af6f75 | horizon     | dashboard | OpenStack Dashboard       |
| bfec3eeec13249a5bc927b95d2e9c2b0 | glance      | image     | Glance Image Service      |
+----------------------------------+-------------+-----------+---------------------------+

$ keystone endpoint-list
+----------------------------------+-----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+----------------------------------+
|                id                |   region  |                     publicurl                      |                    internalurl                     |                      adminurl                      |            service_id            |
+----------------------------------+-----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+----------------------------------+
| 0f1dfad9d8234875bab10a2d7d505ae9 | RegionOne | http://stack01:9292/v1                             | http://stack01:9292/v1                             | http://stack01:9292/v1                             | bfec3eeec13249a5bc927b95d2e9c2b0 |
| 6de673377d8a48749067423abd68b813 | RegionOne | http://stack01:8773/services/Cloud                 | http://stack01:8773/services/Cloud                 | http://stack01:8773/services/Admin                 | 47234e35cd3741779ae0cbacd5ff3bae |
| a01aef4372cc4ed28cddc8fa410ac652 | RegionOne | http://stack01:8776/v1/$(tenant_id)s               | http://stack01:8776/v1/$(tenant_id)s               | http://stack01:8776/v1/$(tenant_id)s               | 6f32c545558144b5a4a5157ece4db46f |
| d4c51a574e8649df842df4812a87cec4 | RegionOne | http://stack01:$(public_port)s/v2.0                | http://stack01:$(admin_port)s/v2.0                 | http://stack01:$(admin_port)s/v2.0                 | 57cbfa53a4814990b7ff74d8ee7c20cb |
| ea293fa0023a42d9be22e975f8535f69 | RegionOne | http://stack01:$(compute_port)s/v1.1/$(tenant_id)s | http://stack01:$(compute_port)s/v1.1/$(tenant_id)s | http://stack01:$(compute_port)s/v1.1/$(tenant_id)s | 2de413d9283e456ebe6c0ed32641fca7 |
+----------------------------------+-----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+----------------------------------+

$ keystone catalog
Service: volume
+-------------+---------------------------------------------------------+
|   Property  |                          Value                          |
+-------------+---------------------------------------------------------+
| adminURL    | http://stack01:8776/v1/9242ed0fd4d34bd98337389ca4eb1624 |
| id          | a01aef4372cc4ed28cddc8fa410ac652                        |
| internalURL | http://stack01:8776/v1/9242ed0fd4d34bd98337389ca4eb1624 |
| publicURL   | http://stack01:8776/v1/9242ed0fd4d34bd98337389ca4eb1624 |
| region      | RegionOne                                               |
+-------------+---------------------------------------------------------+
Service: image
+-------------+----------------------------------+
|   Property  |              Value               |
+-------------+----------------------------------+
| adminURL    | http://stack01:9292/v1           |
| id          | 0f1dfad9d8234875bab10a2d7d505ae9 |
| internalURL | http://stack01:9292/v1           |
| publicURL   | http://stack01:9292/v1           |
| region      | RegionOne                        |
+-------------+----------------------------------+
Service: compute
+-------------+-----------------------------------------------------------+
|   Property  |                           Value                           |
+-------------+-----------------------------------------------------------+
| adminURL    | http://stack01:8774/v1.1/9242ed0fd4d34bd98337389ca4eb1624 |
| id          | ea293fa0023a42d9be22e975f8535f69                          |
| internalURL | http://stack01:8774/v1.1/9242ed0fd4d34bd98337389ca4eb1624 |
| publicURL   | http://stack01:8774/v1.1/9242ed0fd4d34bd98337389ca4eb1624 |
| region      | RegionOne                                                 |
+-------------+-----------------------------------------------------------+
Service: ec2
+-------------+------------------------------------+
|   Property  |               Value                |
+-------------+------------------------------------+
| adminURL    | http://stack01:8773/services/Admin |
| id          | 6de673377d8a48749067423abd68b813   |
| internalURL | http://stack01:8773/services/Cloud |
| publicURL   | http://stack01:8773/services/Cloud |
| region      | RegionOne                          |
+-------------+------------------------------------+
Service: identity
+-------------+----------------------------------+
|   Property  |              Value               |
+-------------+----------------------------------+
| adminURL    | http://stack01:35357/v2.0        |
| id          | d4c51a574e8649df842df4812a87cec4 |
| internalURL | http://stack01:35357/v2.0        |
| publicURL   | http://stack01:5000/v2.0         |
| region      | RegionOne                        |
+-------------+----------------------------------+
Keystoneのインストール、設定はここで終了です。