Cloudkeeper-OS

Cloudkeeper-OS is a project that provides an OpenStack Glance backend for Cloudkeeper. It interacts with the OpenStack Image Service to manage images representing EGI AppDB Appliances. Cloudkeeper-OS runs as a server listening for gRPC communication from Cloudkeeper.

Use the following resources to learn more:

Developers

For information on how to contribute to Glance, please see the contents of the CONTRIBUTING.rst file in this repository.

Any new code must follow the development guidelines detailed in the HACKING.rst file, and pass all unit tests.

Installation

From source

The cloudkeeper-os program has several dependencies listed in the requirements.txt file.

Cloudkeeper-OS can be downloaded from the following GitHub repository:

$ git clone https://github.com/FranceGrilles/cloudkeeper-os.git

In the created directory, run the setup.py script:

$ git clone https://github.com/FranceGrilles/cloudkeeper-os.git
$ cd cloudkeeper-os
$ python setup.py install
$ mkdir /etc/cloudkeeper-os
$ cp etc/cloudkeeper-os.conf.sample /etc/cloudkeeper-os/cloudkeeper-os.conf
$ cp etc/cloudkeeper-os/mapping.json /etc/cloudkeeper-os/mapping.json

Create the /usr/lib/systemd/system/cloudkeeper-os.service systemd service file with the following content to manage the cloudkeeper-os daemon:

[Unit]
Description=OpenStack Cloudkeeper Backend
After=syslog.target network.target

[Service]
Type=simple
User=root
ExecStart=/usr/bin/cloudkeeper-os
PrivateTmp=true

[Install]
WantedBy=multi-user.target

Using RPMs

First, download the repo file from the cloudkeeper-os repository place it in the /etc/yum.repos.d directory. Then execute the following commands:

$ yum update
$ yum install cloudkeeper-os

Configuration

The cloudkeeper-os.conf configuration file has several sections and has a descritpion for each option. Most of the options have default values. You should check at least the following parameters in the keystone_authtoken section:

• username
• password
• auth_url

For example:

[keystone_authtoken]
username = cloudkeeper
password = cloudkeeper
auth_url = http://controller:5000/v3

In addition, you have to edit the mapping.json JSON file to map correctly the VO and the OpenStack project's name . The path to this file is defined with the mapping_file parameter in the cloudkeeper-os.conf file.

Note that the user defined by the username parameter should have the right to manage the images for all the project defined in the mapping.json file.

To take into account the modifications, do not forget to restart the cloudkeeper-os service.

If you want to use a specific glance endpoint (i.e. not the endpoint returned by the catalog), you can define it with the glance_url parameter:

glance_url = http://controller:9292