How Many Ohs? (An Integration Guide to Apex & Triple-o)
1 like•492 views
The document provides an integration guide for Apex, a frontend UI for a forked version of TripleO, which is a deployment tool for OpenStack. It outlines the components involved in the deployment process, the build process, and the configuration of services like Tacker using Heat orchestration and Puppet. Additionally, it addresses the integration workflow and the migration of projects from GitHub to the OPFNV.org site to host their forked projects.
How Many Ohs? (An Integration Guide to Apex & Triple-o)
- 2. How many Ohs? Apex Integration Guide Dan Radez (Red Hat) Tim Rozet (Red Hat)
- 3. The Basics • Apex – Frontend UI for a forked version of TripleO. • TripleO (OOO) – Deployment tool comprised of multiple sub repos/projects. • Undercloud – The TripleO installer VM • Overcloud – Target deployment (OPNFV Control/Compute nodes)
- 4. Forked TripleO? ● Forked TripleO used to incubate new NFV features before merged upstream ● Forks include three main subprojects for TripleO: – Tripleo-heat-templates - Drives deployments via Heat orchestration – Puppet-tripleo - Called by heat tools to configure OPNFV on each overcloud node – os-net-config - Called by heat tools to configure NICs and bridges on the overcloud node
- 11. Call Flow
- 12. Call Flow
- 13. Call Flow
- 14. Call Flow
- 15. Call Flow Repeats for Steps 1-5
- 16. Deployment Command ● Derived from Apex deploy settings (example “tacker: true”) ● Example: resource_registry: OS::TripleO::Services::Tacker: ../puppet/services/tacker.yaml ● Which includes enable_tacker.yaml env heat template: openstack overcloud deploy -e opnfv-environment.yaml -e network-environment.yaml -e /usr/share/openstack-tripleo-heat-templates/environments/enable_tacker.yaml ● Resource registry used to register services
- 17. Tacker Heat Template heat_template_version: 2016-04-08 description: > OpenStack Tacker service configured with Puppet parameters: TackerPassword: description: The password for the tacker service account. type: string hidden: true outputs: role_data: description: Role data for the Tacker role. value: service_name: tacker config_settings: tacker_password: {get_param: TackerPassword} step_config: | include ::tripleo::profile::base::tacker Sets hieradata Runs puppet-tripleo manifest Parameters which can be overridden in environment files
- 18. Tacker Puppet TripleO class tripleo::profile::base::tacker ( $bootstrap_node = hiera('bootstrap_nodeid', undef), $step = hiera('step'), ) { if $::hostname == downcase($bootstrap_node) { $sync_db = true } else { $sync_db = false } if $step >= 4 or ($step >= 3 and $sync_db){ include ::tacker::server include ::tacker::db } } Triggers openstack puppet tacker module: https://github.com/openstack/puppet-tacker “step” controls stage when puppet is applied
- 19. Deployment Network Settings â—Ź Apex parses network settings file â—Ź Writes NIC configuration to /home/stack/nics/ â—Ź Writes network configuration to /home/stack/network- environment.yaml â—Ź Included by environment file in deploy command: openstack overcloud deploy -e opnfv-environment.yaml -e network-environment.yaml -e /usr/share/openstack-tripleo-heat-templates/environments/enable_tacker.yaml
- 20. Apex Key Integration Files â—Ź Adding deploy settings: apex/lib/python/apex/deploy_settings.py â—Ź Adding or modifying scenarios: apex/config/deploy/ â—Ź Modifying artifacts loaded into disk image during build: apex/build/undercloud.sh apex/build/overcloud-full.sh apex/build/overcloud-opendaylight.sh
- 21. Apex Integration Workflow â—Ź Reference integration guide: https://wiki.opnfv.org/display/apex/Integration+Guide â—Ź Create patches in apex-tripleo-heat-templates, apex-puppet-tripleo â—Ź Create patch in Apex to trigger including your templates based on new deployment settings or scenario â—Ź Apex patch should include dependent patches: Moving to forks on gerrit.opnfv.org Migrating off of github onto opnfv.org to host our forked projects that are side loaded into our builds apex-tripleo-heat-templates: Ic65cfeee4a55e993629f831c8c9d9addf6f3dff4 apex-puppet-tripleo: If498c41d706c8f14a5b0bbee64cb4d26cd78c2d0 apex-os-net-config: I5281a57640f388e984b061702362f9c82d08da78
- 22. Questions?
Editor's Notes
- #2: <number>