Menggunakan OpenStack-Ansible dalam proyek Anda¶

Termasuk OpenStack-Ansible dalam proyek Anda¶

Termasuk repositori openstack-ansible dalam proyek lain dapat dilakukan dengan beberapa cara:

Git submodule menunjuk ke tag yang dirilis.
Sebuah skrip untuk secara otomatis melakukan checkout git dari OpenStack-Ansible.

Ketika memasukkan OpenStack-Ansible dalam proyek, pertimbangkan untuk menggunakan struktur direktori paralel seperti yang ditunjukkan pada bagian file ansible.cfg.

Juga perhatikan bahwa menyalin file ke direktori seperti env.d atau conf.d harus ditangani melalui semacam skrip dalam proyek ekstensi.

Termasuk OpenStack-Ansible dengan struktur Ansible Anda¶

Anda dapat membuat playbook, variabel, dan struktur peran Anda sendiri sambil tetap menyertakan peran dan pustaka yang dimungkinkan OpenStack dengan mengatur variabel lingkungan atau dengan menyesuaikan /usr/local/bin/openstack-ansible.rc.

Variabel lingkungan yang relevan untuk OpenStack-Ansible adalah sebagai berikut:

ANSIBLE_LIBRARY: Variabel ini harus mengarah ke /etc/ansible/plugins/library. Melakukan hal itu memungkinkan peran dan playbook untuk mengakses modul Ansible yang disertakan OpenStack-Ansible.
ANSIBLE_ROLES_PATH: Variabel ini harus menunjuk ke /etc/ansible/roles secara default. Hal ini memungkinkan Ansible untuk mencari peran OpenStack-Ansible yang dapat direferensikan oleh peran ekstensi.
ANSIBLE_INVENTORY: Variabel ini harus mengarah ke openstack-ansible/inventory/dynamic_inventory.py. Dengan pengaturan ini, ekstensi memiliki akses ke inventaris dinamis yang sama yang menggunakan OpenStack-Ansible.

Path ke direktori level atas openstack-ansible dapat bersifat relatif dalam file ini.

Pertimbangkan struktur direktori ini

my_project
|
|- custom_stuff
|  |
|  |- playbooks
|- openstack-ansible
|  |
|  |- playbooks

Variabel lingkungan yang ditetapkan akan digunakan ../openstack-ansible/playbooks/<directory>.

Menambahkan peran baru atau utama dalam instalasi OpenStack-Ansible Anda¶

Secara default, OpenStack-Ansible menggunakan file ansible-role-requirement untuk mengambil peran yang diperlukan untuk proses instalasi.

Peran akan diambil ke standar ANSIBLE_ROLES_PATH, yang standarnya adalah /etc/ansible/roles.

ANSIBLE_ROLE_FILE adalah variabel lingkungan yang menunjuk ke lokasi file YAML dimana ansible-galaxy dapat mengkonsumsi, menentukan dimana peran mengunduh dan menginstal. Nilai default untuk ini adalah ansible-role-requirements.yml.

Anda dapat mengganti file ansible-role-requirement yang digunakan dengan mendefinisikan variabel lingkungan ANSIBLE_ROLE_FILE sebelum menjalankan skrip bootstrap-ansible.sh.