• Overview
  • Release notes
  • Puppet platform documentation
  • Quick start guides
  • Managing Windows nodes
  • Installing
  • Upgrading
  • Migrating
  • Configuring PE
  • Monitoring infrastructure state
  • Managing nodes
  • Managing access
  • Managing applications
  • Enforcing change with Puppet orchestrator
  • Managing and deploying Puppet code
  • Provisioning with Razor
  • SSL and certificates
  • APIs
  • Managing MCollective
  • Maintenance
  • Troubleshooting
  • Appendix

Application orchestration: Overview

This version is out of date. For current versions, see Puppet Enterprise support lifecycle.

Application orchestration provides Puppet language extensions and command-line tools to help you configure and manage multi-service and multi-node applications.

What is application orchestration?

Application orchestration is:

  • Extensions of the Puppet language for describing configuration relationships between components of a distributed application.
  • A service that orchestrates configuration enforcement in a directed manner from the node level to the environment level.
  • A command-line tool for executing orchestration jobs, inspecting those jobs, and understanding application instances declared in an environment.

Why use application orchestration?

When you use these new capabilities:

  • Configuration updates are are no longer randomly applied when agents choose to check in. Instead, you can directly apply node configurations in a specified order.
  • The additions to the Puppet language enable you to model how the logical components of a node configurations relate to each other.
  • The Puppet orchestrator command-line tool makes it simple to update these configurations in the appropriate order, no matter how many nodes you’re configuring.

In a nutshell, when using application orchestration, you:

  1. Use the Puppet language to model the desired state of your application and its supporting infrastructure, describing how information is shared between components.
  2. Assign application components to Puppet nodes.
  3. Use the Puppet orchestrator to run Puppet in the correct order on the nodes that host application components.

Try it out: model a Wordpress instance

The Puppet wordpress_app is a module that demonstrates an example application model. The module contains application components you can use to set up a WordPress database, a PHP application server, and an HAProxy load balancer. With these components, you can build two WordPress applications: a simple LAMP stack or a complex stack that uses load-balancing.

Before beginning, please check the module’s dependencies and compatibilities. For r10k users, the module contains a Puppetfile that installs the needed dependencies. If you download the module with the PMT, the dependencies are installed for you.

Language extensions for application orchestration: An overview

To understand the the usefulness of the language extensions for application orchestration, consider the following example:

A common use-case for Puppet users is the three-tier stack application infrastructure: the load-balancer, the application/web server, and the database server. When you configure these servers, you want the application server to know where the database service is and how they connect so that you can cleanly bring up the application. You then want the load balancer to automatically configure itself to balance demand on a number of application servers. When you update the configuration of these machines, or roll out a new application release, you want the three tiers to reconfigure in the correct order.

Previously in Puppet, you’d write some Puppet code for each tier of this stack, and classify the nodes responsible for each tier. Then you’d manually run Puppet on each node in the desired order, or wait for configuration to converge after several node runs. In some cases, you even used exported resources to exchange information between the application and database servers, or you pre-filled information in Hiera.

In other words—you did a lot of labor to realize your stack.

With application orchestration functionality, you model each tier as a component of a larger construct—the application—and use Puppet Enterprise to trigger the nodes’ configurations in the order you specify. When you specify the order of the configurations, information is shared between nodes (for example, services are stopped or started) to ensure each component of the stack is created in the correct order.

The application definition

The application definition is a lot like a defined resource type, except that instead of defining a chunk of reusable configuration that applies to a single node, the application definition operates across multiple nodes. The components you declare inside an application can be individually assigned to separate nodes that you manage with Puppet.

The application definition defines the configuration of your application infrastructure—what dependencies nodes have on each other and what information they exchange about those dependencies.

Application components

An application component is an independent bit of Puppet code that can be used alongside one or more other components to create an application. Components are commonly defined types that consist of traditional Puppet resources that describe the configuration of the component (for example, a file, package, or service). But components can be classes or native resources too.

A type, class, or resource becomes an application component when you declare it in an application manifest while producing, consuming, or requiring a service resource (using the export, consume, or require metaparameters).

Service resources

When you compose applications, application components can share information with each other by exporting and consuming environment-wide service resources. This helps components work together even if they are on different servers. An environment service resource works like an exported resource, providing data for other parts of the application to consume. It also helps application components express dependent relationships.

You can also write custom service resource types.

Application orchestration is a Puppet Enterprise feature

Application orchestration is a Puppet Enterprise feature.

The language features work in open source Puppet, but since the Puppet orchestrator command-line tool and service is currently available only in Puppet Enterprise, the language features don’t result in ordered runs that respect node dependencies.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.