Skip to content

Latest commit

 

History

History
116 lines (97 loc) · 3.58 KB

README.md

File metadata and controls

116 lines (97 loc) · 3.58 KB

README.linstor_kolla

kemopq.linstor_kolla collection

Collection for creating Linstor cluster and integrate it to kolla Openstack.
https://www.linbit.com/linstor/

Installing collection

Install this collection locally:

ansible-galaxy collection install kemopq.linstor_kolla -p ./collections

./collections folder should be included to collections_path parameter in ansible configuration file. See: https://docs.ansible.com/ansible/latest/reference_appendices/config.html#ansible-configuration-settings-locations

Using collection

Roles and module can be used on your ansible playbook. It can be referenced by its fully qualified collection name (FQCN):

- name: Prepare linstor nodes
  hosts: linstor_all
  gather_facts: 'yes'

  collections:
    - kemopq.linstor_kolla
  tasks:
    - name: "Include linstor_nodes role"
      import_role:
        name: "linstor_nodes"
      tags:
        - lnodes

- name: Setup linstor cluster
  hosts: linstor_controller[0]
  gather_facts: 'no'

  collections:
    - kemopq.linstor_kolla

  tasks:
    - name: "Include linstor_cluster role"
      import_role:
        name: "linstor_cluster"
      tags:
        - lcluster

- name: Prepare Cinder configuration on Openstack deployment server
  hosts: deployment_srv
  gather_facts: 'no'

  collections:
    - kemopq.linstor_kolla

  tasks:
    - name: "Include openstack_config role"
      import_role:
        name: "openstack_config"
      tags:
        - osconfig

- name: Prepare Openstack Cinder nodes
  hosts: cinder_storage
  gather_facts: 'no'

  collections:
    - kemopq.linstor_kolla

  tasks:
    - name: "Include openstack_nodes role"
      import_role:
        name: "openstack_nodes"
      tags:
        - osnodes

Configuration parameters

Template of configuration file is in config folder. It's well commented. The configuration file has three parts:

  • drbd configuration (most parameters can have default values, check only drbd_volumes)
  • linstor cluster configuration
  • kolla openstack configuration

Inventory

Template of inventory file is in config folder. There are three types of server:

  • deployment_srv => the server where kolla ansible playbooks run
  • linstor_controller => linstor controller nodes
  • linstor_satellite => linstor satellite nodes
  • cinder_storage => nodes, which will play the role of cinder storage on Linstor cluster; usually on these nodes Linstor controller runs
    A node can be in controller and satellite group, if it has both roles.

Running your playbook

When running your playbook a path to configuration file should be provided. Additionaly a parameter linstor_kolla_action parameter should be set. Possible values are:

  • 'deploy': linstor cluster is deployed and integrated to kolla Openstack
  • 'destroy': linstor cluster is destroyed
ansible-playbook  -i localhost, -e linstor_kolla_action=[deploy/destroy] -e "@<your_config_file>.json" <your_playbook>.yml

Integration with kolla Openstack

  • deploy Openstack cloud with kolla-ansible playbooks
  • prepare Linstor cluster with this ansible collection (Caveat: ensure passwordless ssh to cloud nodes)
  • run kolla-ansible playbook with reconfigure option

Basic test

On openstack client host:

source admin-openrc.sh
openstack volume type create linstor
openstack volume type set linstor --property volume_backend_name=linstor
openstack volume create --type linstor --size 1 --availability-zone nova linstor-testvol
openstack volume list

On cinder controller:

docker run -it --rm -e LS_CONTROLLERS="192.168.100.11" drbd.io/linstor-client resource list

Testing with molecule

Not prepaired yet