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:
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.
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
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
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