Ansible Collections for using with OTC (addition to the native OpenStack modules)
cloud
- collection containing additional ansible modules for managing
OTC specific resources (or modified OpenStack modules in case of behavioral
differencies)Run the following command to install the collection.
$ ansible-galaxy collection install opentelekomcloud.cloud
If you need further information to get started, please see section:
Installation on a blank system in a Python virtual environment
Installation was tested on Ubuntu 20.04
Install python3-venv
for Python virtual environment:
$ sudo apt-get install python3-venv
Create virtual environment ansiblevenv
:
$ python3 -m venv ansiblevenv
Install dependencies for python package otcextensions which are described in its documentation:
$ sudo apt-get install gcc libssl-dev python3-dev
Enable virtual environment ansiblevenv
:
$ source ansiblevenv/bin/activate
Install wheel
, ansible
and otcextensions
:
(ansiblevenv) $ pip install wheel ansible otcextensions
Install opentelekomcloud.cloud collection from Ansible-Galaxy:
(ansiblevenv) $ ansible-galaxy collection install opentelekomcloud.cloud
Prepare credential file clouds.yaml
and necessary folders to connect to
your cloud:
(ansiblevenv) $ mkdir -p ~/.config/openstack/
(ansiblevenv) $ touch ~/.config/openstack/clouds.yaml
(ansiblevenv) $ chmod 700 -R ~/.config/
Paste in the following content with your credentials:
# clouds.yaml
clouds:
otc:
profile: otc
auth:
username: '<USER_NAME>'
password: '<PASSWORD>'
project_name: '<eu-de_project>'
# or project_id: '<123456_PROJECT_ID>'
user_domain_name: 'OTC00000000001000000xxx'
# or user_domain_id: '<123456_DOMAIN_ID>'
auth_url: 'https://iam.eu-de.otc.t-systems.com:443/v3'
interface: 'public'
identity_api_version: 3 # !Important
ak: '<AK_VALUE>' # AK/SK pair for access to OBS
sk: '<SK_VALUE>'
Verify the installation process by creating a sample playbook which invokes all dependencies:
(ansiblevenv) $ vim opentelekomcloud.yaml
# opentelekomcloud.yaml
- hosts: localhost
tasks:
- name: Get NAT gateway info
opentelekomcloud.cloud.nat_gateway_info:
cloud: otc
register: gw
- name: debug configs
debug:
var: gw.nat_gateways
Here you can find some examples of using OTC collection. All the examples are based on real usecases, and contains some tips and tricks.
Run the playbook to verify the functionality:
(ansiblevenv) $ ansible-playbook opentelekomcloud.yaml
# output without NAT gateways enabled
PLAY [localhost] ***************************************************************
TASK [Gathering Facts] *********************************************************
ok: [localhost]
TASK [Get NAT gateway info] ****************************************************
ok: [localhost]
TASK [debug configs] ***********************************************************
ok: [localhost] => {
"gw.nat_gateways": []
}