RLM create and deploy repo instance

You can use this automation script to create an instance for a repository and deploy it on BMC Release Package and Deployment by using the BMC Release Process Management user interface. For this script to work, you must have a created repository on BMC Release Package and Deployment.

This script creates an instance with the next available default name in the BMC Release Package and Deployment database. For example, if the last name with which an instance is created on BMC Release Package and Deployment is 0.0.0.2, then on running this script, the instance is created with the name 0.0.0.3.

Inputs required while creating a step

To use this automation script in a step, specify the following inputs:

• Repo: Select in a list of repositories present in the database of BMC Release Package and Deployment. You must select that repository for which you want to create an instance and deploy it.

  Note

  You see only those repositories in this list, which are in the ready state on BMC Release Package and Deployment.

• Locked: To create a locked instance for the selected repository, select Yes. Otherwise, select No.
• Route: Select in a list of routes present in the database of BMC Release Package and Deployment.

• Environment: A list of environments is populated when you select a route. You can select the route in a list of environments associated with the selected route.

  Note

  If the environment name used in the request of the step matches the environment name on BMC Release Package and Deployment, then such an environment is selected by default in the step and is suffixed with the text (inherited from request).

• Channels: Select the channel for the deployment in the list. A list of channels is populated when you select an environment.

  Note

  In automation scripts, channels for BMC Release Package and Deployment are available only if you use BMC Release Process Management 4.3.01.09 or later and the integration with BMC Release Package and Deployment 4.3.01.09 or later.

• Log Format: Select the format of the logs returned by the deploy operation from BMC Release Package and Deployment.

  Note

  In automation scripts, log format for BMC Release Package and Deployment is available only if you integrate with BMC Release Package and Deployment 4.4.00.06 or later.

• Set Properties: This item is displayed only when you select a repository. The table displayed provides a list of properties that are associated with the selected repository on BMC Release Package and Deployment. You can select one of these properties to override its value with a property value in BMC Release Process Management. For this, you must first create a mapping of properties in BMC Release Process Management with that on BMC Release Package and Deployment. For more information, see Setting-property-values-for-a-package-repository-or-instance.

Expected results after  running this automation script

After you run this script and the step is completed successfully, you can see the following script results on the step Automation tab.

• Repo Instance: The database ID of the repository instance that is created on BMC Release Package and Deployment.
• Repo Instance Log: Contains details about the snapshot of the repository instance that is created. You can download this file and save it. This file contains log details that are originally generated in BMC Release Package and Deployment. You can download the file from BMC Release Process Management.
• Repo Instances: Provides a URL that takes you to the Deploy > Repositories page on BMC Release Package and Deployment where you can see a list of existing repository instances. You can click any of the instances to view the log details.

• Deployment Log File: Contains log details about the repository instance deployment. This file contains log details that are originally generated in BMC Release Package and Deployment. You can download the file from BMC Release Process Management.
• Deployment Log URL: Provides a URL that takes you to the location where the deployment log file is available on BMC Release Package and Deployment.

 If errors occur and the repository instance creation or deployment fails, the step goes into a problem state. In this case, you can see the script errors on the Notes tab in a step.

Associated data retriever scripts

The RLM create and deploy repo instance automation script uses the following data retriever scripts: