Developer Documentation

Documentation of developer-specific options in TripleO.

• Composable services tutorial
  • Introduction
    • Relevant repositories in this guide
    • Gerrit patches used in this example
    • Change prerequisites
  • Updating tripleo-heat-templates
    • Folder structure convention for tripleo-heat-templates
    • Changes list
    • Step 1 - Updating puppet references
    • Step 2 - overcloud-resource-registry-puppet.j2.yaml resource registry changes
    • Step 3 - roles_data.yaml initial changes
    • Step 4 - Create the services yaml files
  • Updating puppet-tripleo
    • Folder structure convention
    • Adding the puppet manifest
  • THT design patterns
    • Duplicated parameters
  • TLS support for services
    • Public TLS
    • Internal TLS
      • How it works
      • Enabling internal TLS for your service
        • Services that run over httpd
        • Configuring HAProxy to use TLS for your service
        • Internal TLS for services that don’t run over httpd
        • Internal TLS via a TLS-proxy
  • Summary
  • Service template sections description
    • What’s the bare-minimum?
      • Version and description
      • Parameters
      • The role_data output
    • Ansible-related parameters
      • Host prep deployment (or host_prep_tasks)
      • Pre Deploy Step tasks (or pre_deploy_step_tasks)
      • External deploy tasks
      • Deploy steps tasks
    • Container-related parameters
      • puppet_config section
      • kolla_config section
      • docker_config section
      • container_puppet_tasks section
• Release Management
  • Releases Overview
  • Releases for RDO
    • Update required metadata
    • Get latest promoted content
    • Prepare version tags
    • Notify RDO team of tags
• Primer python-tripleoclient and tripleo-common
  • TripleO commands: where
  • TripleO commands: how
• Upgrades Development
  • Overcloud Major Upgrade Workflow and CLI
    • openstack overcloud upgrade prepare $ARGS
    • openstack overcloud upgrade run $ARGS
    • openstack overcloud external-upgrade run $ARGS
    • openstack overcloud upgrade converge $ARGS
    • Upgrade CLI developer workflow
      • Making changes to the ansible playbooks
      • Making changes to the upgrades workflow
  • Minor version update
    • How update commands work
      • openstack overcloud update prepare
      • openstack overcloud update run
      • openstack overcloud external-update run
      • openstack overcloud update converge
    • Writing update logic for a service
      • Simple config/image replacement
      • Custom tasks during updates
  • TripleO Fast Forward Upgrade (FFU) N -> N+3
    • FFU and tripleo-heat-templates
  • Major upgrades & Minor updates CI coverage
    • Upgrades/Updates CI jobs
    • Upgrade/Update CI jobs, where to look
    • Debugging Upgrade/Update CI jobs
    • Replicating CI jobs