Merge branch 'python'

.gitignore

@@ -1,3 +1,3 @@
 .idea
-config.js
-node_modules
+config.py
+*.pyc

README.md

@@ -16,12 +16,36 @@ git clone https://github.com/FELDSAM-INC/ansible-one-inv.git
 
 ```bash
 cd ansible-one-inv
-npm install
-cp config.sample.js config.js
-nano config.js # configure
+pip install pyone
+cp config.sample.py config.py
+nano config.py # configure
 cd -
 ```
 
+**Sample config:**
+```
+# OpenNebula XML-RPC API connection details
+ONE = {
+    'address': 'https://opennebula:2633/RPC2',
+    'username': 'user',
+    'password': 'pass'
+}
+
+# Whether to use VM name or IP (first one found) as hostname
+USE_VM_NAME = False
+
+# VM USER_TEMPLATE var to use as hostname
+# Fallback:
+# 1. check USE_VM_NAME and if True return use VM name
+# 2. use VM IP (first one found)
+HOSTNAME_USER_TEMPLATE_VAR = ''
+
+# Skip VMs by labels
+SKIP_LABELS = [
+    'SomeLabel'
+]
+```
+
 ### Test
 
 ```
@@ -40,9 +64,18 @@ inventory = ./ansible-one-inv/one-inv
 
 Now you can use dynamic inventory in your playbooks. Hosts will be grouped by OpenNebula Labels to Ansible Host Groups.
 
+## Notes
+
+### Host groups
+
+This script defines host groups by labels assigned to VMs in OpenNebula.  
+There is one special group `All`, which contains all VMs.  
+One VM can be in more groups if have more labels.
+
 ### Custom SSH ports
 
-I added support for define custom ssh port in vm user template. Just add variable `SSH_PORT` and ansible use it.
+There is support to define custom ssh port in VM USER_TEMPLATE.  
+Just add variable `SSH_PORT` and Ansible use it.
 
 ## Ansible
 

config.sample.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# -------------------------------------------------------------------------- #
+# Copyright 2020, FeldHost™ (feldhost.net)                                   #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+# -------------------------------------------------------------------------- #
+
+# OpenNebula XML-RPC API connection details
+ONE = {
+    'address': 'https://opennebula:2633/RPC2',
+    'username': 'user',
+    'password': 'pass'
+}
+
+# Whether to use VM name or IP (first one found) as hostname
+USE_VM_NAME = False
+
+# VM USER_TEMPLATE var to use as hostname
+# Fallback:
+# 1. check USE_VM_NAME and if True return use VM name
+# 2. use VM IP (first one found)
+HOSTNAME_USER_TEMPLATE_VAR = ''
+
+# Skip VMs by labels
+SKIP_LABELS = [
+    'SomeLabel'
+]

functions.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+# -------------------------------------------------------------------------- #
+# Copyright 2020, FeldHost™ (feldhost.net)                                   #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+# -------------------------------------------------------------------------- #
+
+import config
+
+
+def get_hostname(vm):
+    if not config.USE_VM_NAME and config.HOSTNAME_USER_TEMPLATE_VAR != '' and vm.USER_TEMPLATE.get(config.HOSTNAME_USER_TEMPLATE_VAR):
+        return vm.USER_TEMPLATE.get(config.HOSTNAME_USER_TEMPLATE_VAR)
+
+    if not config.USE_VM_NAME:
+        return get_vm_ip(vm)
+
+    return vm.NAME
+
+
+def get_vm_ip(vm):
+    nic = vm.TEMPLATE.get('NIC')
+
+    if isinstance(nic, dict):
+        nic = [nic]
+
+    for net in nic:
+        return net['IP']
+
+    return False
+
+
+def get_ssh_port(vm):
+    if vm.USER_TEMPLATE.get('SSH_PORT'):
+        return vm.USER_TEMPLATE.get('SSH_PORT')
+
+    return False