Integrating with Puppet

This use case describes the deployment of a zip file on a target server by using the Puppet setup and executing a Puppet module as a part of the deployment process.

This deployment is described in the following steps:

1. John logs on to his Puppet setup and performs the following setup tasks:
   
   1. Configure a dispatcher on the Puppet Master server. For more information about installing a dispatcher without running the installation program, see Installing-and-starting-dispatchers.
   2. Configure an ENC for the dispatcher on the Puppet Master server.

   3. Add the following code block to the ENC:

      #################################
      # RLM External Node Classifier
      #################################
      PUPPET_ENC_TMP=/tmp/rlm_enc
      RLM_FILES=`find $PUPPET_ENC_TMP -name "RLM_${1}*" | sort -n |  head -1`
      if [ -n "$RLM_FILES" ]; then
         echo "classes:"
         cat $RLM_FILES
         echo "name: ${1}"
         echo "parameters: {}"
      else
          # Current ENC code here
      fi
2. He then logs on to BMC VaraLogix Q Deployment Automation and creates a server pointing to the Puppet Agent and the dispatcher so that BMC VaraLogix Q Deployment Automation can connect with Puppet. For this, he navigates to System > Servers > New Server. He provides the following details and then clicks Create.
   
   1. Hostname: The Puppet Agent server name
   2. Create Channel Template: None
   3. Role: Unassigned
   4. Agent: Puppet
   5. Dispatcher Server: Name of the server where the dispatcher is running.
   6. Remote Platform: None
3. He now navigates to the Topology tab to create a topology consisting of channel templates, channels, environments, and routes necessary to perform the deployment, as follows:
   1. On the Topology > Channel Templates > New Channel Template page, provide the necessary details to create a channel template, "Puppet_CT1:"
   2. On the Topology > Channels > New Channel page, select "Puppet_CT1" as the channel template, and provide other necessary details to create a channel named, "Puppet Channel 1."
   3. On the Topology > Environments > New Environment page, provide the necessary details to create an environment named, "Puppet Env 1."
   4. On the Topology > Routes > New Route page, create a route named "Puppet Route" by selecting the Type as Strict. Assign the "Puppet Env 1" to this route by dragging it from the Available Environments panel to the Environments panel.
      For more information about creating a topology, see Creating-and-managing-the-deployment-topology.
4. He navigates to the Define > Packages > New Packagepage, and provides details to create a package named, "Puppet Package." He adds a reference and an instance for this package, as follows:
   1. Click Add Reference to add a reference regarding the zip file by providing the necessary details and selecting the Method as File.
   2. Click New Instance next to the package summary and provides the necessary details and create the instance.
      For more information about creating a package and adding references and an instance for that package, see Packages.
5. He navigates to the Define > Processes > New Process page and creates a process called "Puppet Deploy zip file." He adds the following deployment activities on the Deployment Activities tab and then clicks Done:
   1. Create an activity called, "Send content" by using the Send Instance Content activity library to send the content pack to the appropriate directory on the target server.
   2. Create an activity called, "Unzip content pack" by using the Execute Command Line activity library to unzip the content pack on that directory. Add a dependency for the preceding activity.
   3. Create an activity called, "Copy directory" by using the Copy File or Directory activity library to copy the unzipped content pack to another directory on the deploy server. Add a dependency for the preceding activity.
   4. Create an activity called, "Puppet Module - Core Permissions" by using the Invoke Action activity library to execute the core_permissions Puppet module and add a dependency for the preceding activity. Under the Configure panel, ensure that Generic is selected as the value in the first list available for Action Name. Select Execute Puppet Module in the second list available for Action Name. In the Action Arguments box, specify core_permissions. Click Done.
      For more information on creating processes, see Creating-and-managing-processes-and-content-process-sets.
6. He navigates to the Deploy tab and deploys the relevant package. When the deployment begins, the Puppet Agent runs and the process starts executing on the target servers.
   For more information about performing a deployment, see Creating-and-managing-deployments.
7. He checks the Puppet Agent log to verify if the deployment was successful or not.