Configure Install Website Task

Table of ContentsLab Overview - HOL-1721-USE-4 - DevOps with vRealize Code Stream............................2

Lab Guidance .......................................................................................................... 3Module 1 - Introduction to vRealize Code Stream (30 minutes) ........................................9

Introduction........................................................................................................... 10Introducing vRealize Code Stream ........................................................................ 11Architecture Concepts........................................................................................... 14Introduction to Lab Scenario ................................................................................. 16Building a Simple Application Release Pipeline ..................................................... 18Executing a Simple Application Release Pipeline .................................................. 35Summary .............................................................................................................. 44

Module 2 - Using vRealize Code Stream for Application Release Automation (60minutes).......................................................................................................................... 45

Introduction to Lab Scenario ................................................................................. 46Building a "Staging" Stage for QA ......................................................................... 48Build a Gating Rule................................................................................................ 59Build an Approval Policy and Move to Production.................................................. 66Executing the Production Application Release Pipeline .........................................73Review Enhancements to the Pipeline .................................................................. 83Execute the Enhanced Pipeline ............................................................................. 99Summary ............................................................................................................ 109

Module 3 - vRealize Code Stream for IT DevOps (45 Minutes) ......................................110Introduction to vRealize Code Stream for IT DevOps ..........................................111Introduction to Lab Scenario ............................................................................... 112Capture a vRealize Automation Blueprint from Rainpole Development Tenant...113Migrate the Captured Blueprint to the Rainpole vRealize Automation ProductionTenant ................................................................................................................. 124Modify JSON Data to Customize Execution.......................................................... 136Summary ............................................................................................................ 152

HOL-1721-USE-4

Page 1HOL-1721-USE-4

Lab Overview -HOL-1721-USE-4 - DevOps

with vRealize CodeStream

HOL-1721-USE-4


Lab GuidanceNote: It will take more than 90 minutes to complete this lab. You shouldexpect to only finish 2-3 of the modules during your time. The modules areindependent of each other so you can start at the beginning of any moduleand proceed from there. You can use the Table of Contents to access anymodule of your choosing.

The Table of Contents can be accessed in the upper right-hand corner of theLab Manual.

You will explore how to use vRealize Code Stream to orchestrate DevOps releaseprocesses and continuous application delivery. The same concepts will then be appliedto the Software-Defined Data Center to move infrastructure components as codebetween environments.

Lab Module List:

• Module 1 - Introduction to vRealize Code Stream(45 minutes) (Beginner)Explore how vRealize Code Stream leverages your existing software developmentlifecycle tools. Review how to implement application release automation forcustom developed applications and IT infrastructure.

• Module 2 - Using vRealize Code Stream for Application ReleaseAutomation (60 minutes) (Advanced) Create an application release pipeline withvRealize Code Stream, vRealize Automation, Jenkins and Artifactory. As a releasemanager, you will automate the build, test and deployment of a sampleeCommerce application.

• Module 3 - vRealize Code Stream for IT DevOps(45 minutes) (Advanced)Walk through migrating vRealize Automation infrastructure constructs betweentenants using the vRealize Code Stream Management Pack for IT DevOps(fomerly known as Houdini).

Lab Captains:

• Module 1 - Adam Osterholt, Staff Systems Engineer, USA• Module 2 - Adam Osterholt, Staff Systems Engineer, USA• Module 3 - Gavin Lees, Senior Technical Account Manager, UK

This lab manual can be downloaded from the Hands-on Labs Document site found here:

http://docs.hol.vmware.com

This lab may be available in other languages. To set your language preference and havea localized manual deployed with your lab, you may utilize this document to help guideyou through the process:

http://docs.hol.vmware.com/announcements/nee-default-language.pdf

HOL-1721-USE-4


http://docs.hol.vmware.com

http://docs.hol.vmware.com/announcements/nee-default-language.pdf

Introduction to the Scenario

Rainpole Systems is an electronics manufacturer located in Palo Alto, CA. Rainpoledesigns and manufactures electronic devices for use in everything from aircraftinstrumentation to home automation. Given the diversity of their product set, Rainpoleneeds to develop cloud-based IT services to support the increasing demands of thebusiness units.

Rainpole Systems in planning to use vRealize Automation and vRealize Code Stream toautomate the build, test and deployment of their custom developed eCommerceapplication. They also plan to leverage the vRealize Code Stream Management Pack forIT DevOps to promote vRealize Automation application blueprints from development toproduction to minimize the chance of errors impacting their production cloudenvironment.

Rainpole systems is currently leveraging a number of tools in their softwaredevelopment lifecycle including Jenkins, Gitlab and Selenium. These systems have beenloosely tied together through custom scripts but they lack and overall view of whereparticular build are in the application release process. Furthermore, they lackgovernance as code is promoted from development to test and ultimately to production.They are exploring leveraging vRealize Code Stream to streamline these processes andimprove their overall software development lifecycle.

You will take on the roles of a Rainpole Cloud Administrator, a Rainpole Developer and aDevelopment Manager in this exciting lab exercise to experience how VMware andvRealize Code Stream can help make these goals a reality.

HOL-1721-USE-4


Location of the Main Console

1. The area in the RED box contains the Main Console. The Lab Manual is on the tabto the Right of the Main Console.

2. A particular lab may have additional consoles found on separate tabs in the upperleft. You will be directed to open another specific console if needed.

3. Your lab starts with 90 minutes on the timer. The lab can not be saved. All yourwork must be done during the lab session. But you can click the EXTEND toincrease your time. If you are at a VMware event, you can extend your lab timetwice, for up to 30 minutes. Each click gives you an additional 15 minutes.Outside of VMware events, you can extend your lab time up to 9 hours and 30

minutes. Each click gives you an additional hour.

Alternate Methods of Keyboard Data Entry

During this module, you will input text into the Main Console. Besides directly typing itin, there are two very helpful methods of entering data which make it easier to entercomplex data.

HOL-1721-USE-4


Click and Drag Lab Manual Content Into Console ActiveWindow

You can also click and drag text and Command Line Interface (CLI) commands directlyfrom the Lab Manual into the active window in the Main Console.

Accessing the Online International Keyboard

You can also use the Online International Keyboard found in the Main Console.

1. Click on the Keyboard Icon found on the Windows Quick Launch Task Bar.

<div class="player-unavailable"><h1 class="message">An error occurred.</h1><div class="submessage"><ahref="http://www.youtube.com/watch?v=xS07n6GzGuo" target="_blank">Try watching this video on www.youtube.com</a>, or enableJavaScript if it is disabled in your browser.</div></div>

HOL-1721-USE-4


Click once in active console window

In this example, you will use the Online Keyboard to enter the "@" sign used in emailaddresses. The "@" sign is Shift-2 on US keyboard layouts.

1. Click once in the active console window.2. Click on the Shift key.

Click on the @ key

1. Click on the "@" key.

Notice the @ sign entered in the active console window.

Activation Prompt or Watermark

When you first start your lab, you may notice a watermark on the desktop indicatingthat Windows is not activated.

HOL-1721-USE-4


One of the major benefits of virtualization is that virtual machines can be moved andrun on any platform. The Hands-on Labs utilizes this benefit and we are able to run thelabs out of multiple datacenters. However, these datacenters may not have identicalprocessors, which triggers a Microsoft activation check through the Internet.

Rest assured, VMware and the Hands-on Labs are in full compliance with Microsoftlicensing requirements. The lab that you are using is a self-contained pod and does nothave full access to the Internet, which is required for Windows to verify the activation.Without full access to the Internet, this automated process fails and you see this

watermark.

This cosmetic issue has no effect on your lab.

Look at the lower right portion of the screen

Please check to see that your lab is finished all the startup routines and is ready for youto start. If you see anything other than "Ready", please wait a few minutes. If after 5minutes you lab has not changed to "Ready", please ask for assistance.

HOL-1721-USE-4


Module 1 - Introduction tovRealize Code Stream (30

minutes)

HOL-1721-USE-4


IntroductionThis module will demonstrate the power of vRealize Code stream to rapidly buildapplication release pipelines. With application release pipelines, you can model andautomate existing processes to accelerate the delivery of custom application code fromthe developers laptop all the way through to production. You will begin with an overviewof vRealize Code Stream, how it works and what problems it solves. Finally, you willcreate a simple application release pipeline with a test stage.

This HOL-1721-USE-4 lab is broken up into 3 individual modules with varying lengths.Use the "Modules" list to determine which use case(s) you want to complete. You maychoose to complete any or all modules, keeping in mind you have 90 minutes availableper session.

If you have not already reviewed it, the Lab Introduction contains details about RainpoleSystems (our example company,) as well as important information on text entry,multiple language support and on-screen keyboard configuration. If desired, you canclick here to review this information again.

You will need about 30 minutes to complete this module.

HOL-1721-USE-4


Introducing vRealize Code StreamVMware vRealize Code Stream is an application release automation and continuousdelivery solution that allows developers and operations teams to release software morefrequently and efficiently, all the while leveraging their investments in existingdeveloper and operations tools.

vRealize Code Stream Introduction

What is vRealize Code Stream? Think of Code Stream as a code-release-specificorchestration engine. It allows users to define a visual representation/template of arelease pipeline, tying into all of the existing various SDLC mechanisms that a customeris using, while providing stage-gate checks to verify if a release should continue its pathfrom one stage to the next.

In a release delivery process, after development checks in their enhancements or newfeatures, several additional groups need to test, stage and accept the release prior toputting it into production. Today this is largely accomplished using siloed processes witha collection of tools that may or may not be consistent across groups. Not only does theprocess to deploy and test at each stage take too long, coordination and consistency ateach stage also suffers. Code Stream allows application release teams to model anykind of release process for any kind of application from simple, single node, on premiseapplications to complex, multi-tiered, cloud-based or hybrid next-gen applications.Pipeline models configure the workflow tasks and governance policies used to build,deploy and test the software at each stage in the delivery process as well as the gatingrules between stages.

As an introduction watch this brief video on vRealize Code Stream.

HOL-1721-USE-4


Code Stream Video Introduction

Overview/Benefits

VMware helps enterprise IT overcome cloud management challenges with the followingdifferentiators:

• Achieving Fastest Time-to-Cloud Value: extensive out-of-the-box capabilities,extensible architecture and ability to leverage existing investments, enables youto create scalable private, public and desktop cloud services in just days

• Rapid Ecosystem Integration: a full spectrum of extensibility options thatempowers IT personnel to enable, adapt, and extend their cloud to work withintheir existing IT infrastructure and processes, thereby eliminating expensiveservice engagements while reducing risk

• Embracing Consumerization of IT: unifies disparate systems and processes into ahighly personalized, self-service experience governed by user and organizationalawareness, ensuring the exact needs of the user are met in the context of thebusiness

• Boosting IT Efficiency: VMware's advanced self-service and automationcapabilities lead to a significant reduction in operational expenditures (OpEx),while organizationally aware governance enables a multi-tenant infrastructure,improving hardware utilization and eliminating capital expenditures (CapEx)

<div class="player-unavailable"><h1 class="message">An error occurred.</h1><div class="submessage"><ahref="http://www.youtube.com/watch?v=2hGEoot9viU" target="_blank">Try watching this video on www.youtube.com</a>, or enableJavaScript if it is disabled in your browser.</div></div>

HOL-1721-USE-4


• Increasing Business Agility: enterprise IT is empowered to quickly enable cloudservices so that the business can react quickly to changing market demands andcapture market share

• Hybrid Cloud Automation: agnostic provisioning of hardware platforms, operatingsystems, hypervisors, management tools, and public clouds; vRealize Automationallows customers to rapidly stand up cloud services to deliver quick time to valuefrom your IT investments

HOL-1721-USE-4


Architecture ConceptsvRealize Code Stream is integrated with vRealize Automation and can work with vCenterServer, Chef, Puppet, or scripts. vRealize Automation can also integrate with continuousintegration frameworks and testing frameworks.

Architecture

vRealize Code Stream includes an approval engine that can integrate with IT servicemanagement products and various commercial or custom approval systems. Based onthe type of integration, vRealize Code Stream uses the JFrog Artifactory or VMwarevRealize Orchestrator (formerly vCO) plug-ins for extensibility. Both of the approval andextensibility components are embedded in the vRealize Automation virtual appliance.

Deployment Engines

vRealize Code Stream integrates with a number of provisioning and deploymentsolutions including vRealize Automation. It can also trigger scripts or vRealizeOrchestrator workflows. Support for other provisioning solutions is delivered by plug-insthat VMware, partners, or users publish.

Testing Frameworks

vRealize Code Stream integrates with Jenkins to trigger Jenkins jobs, including testroutines. The user interface for test automation and for extensibility uses the vRealizeOrchestrator plug-in framework.

A Jenkins job can run test cases that are configured for an application. The TestAcceptance Threshold workflow in the gating rule verifies the results of the Jenkins joband returns the response to the vRealize Code Stream server. Based on the results ofthe test and the gating rules that have been defined, the build either proceeds to thenext stage of the release pipeline or it fails.

Approval Systems

vRealize Code Stream uses vRealize Orchestrator plug-ins for integration with approvalsystems. Manual approval tasks can be created within the vRealize Automation inbox,but vRealize Code Stream can also integrate with BMC Remedy ITSM, HP ServiceManager, ServiceNow, and other ticketing systems. The approval systems integrationrequires downloading and installing the appropriate vRealize Orchestrator plug-in fromthe VMware Solution Exchange.

HOL-1721-USE-4


Key Release Automation Concepts

Use the following definitions to help you understand the release pipeline modeling andthe artifact management workflow.

Artifact: A script or the output of a build process. The script can be deployed orupgraded in a given stage. Artifact types can be configuration files, application bits, orthird-party software.

Artifact Management: A service that manages the artifacts over a range of local andremote repositories. For example, managing a WAR file stored in the Maven repository.

Category: A task type. Some supported categories are Provision, Custom, Artifact,Deploy, and Test. A task belongs to a provider and a category.

Gating Rule: A set of rules that must be completed before the software changes arepromoted and the next set of tasks starts in the subsequent stage. The gating rulesinclude testing rules and compliance rules. Gating rules that are associated with apipeline are specific to an organization and applications.

Instance: A vRealize Orchestrator plug-in scenario that captures specific configurationsof a provider. The instance is created by using a vRealize Orchestrator client.

Pipeline: A collection of all the stages or environments in which a software change hasto pass through independently before it is released into production. For example,development, test, user acceptance test, load test, staging, and production.

Provider: Plug-in vendors that support the categories. For example, the Provisioncategory is supported by vRealize Automation and vCenter Server providers.

Stage: Every stage in the pipeline defines a set of activities. For example, deploy, test,approval through gating rules, and custom tasks.

Task: An activity in a given stage. For example, provision the machines, resolve theartifact, deploy the artifact, run the test, and so on.

HOL-1721-USE-4


Introduction to Lab ScenarioAs you work through the lab's use cases, you'll be assuming roles within a fictionalcompany, Rainpole, and addressing their business and IT challenges.

Rainpole is an IT company that is under pressure to build private clouds, which meanscreating a data center architecture that can deliver a flexible, scalable computing whilemaintaining governance and control over their environment. Rainpole IT Automationteam decided to reach out to VMware to help them with their journey to private cloud.vRealize Automation empowers IT to accelerate the delivery of personalized, business-relevant IT Services while improving overall efficiency, by delivering infrastructure,application and custom services through a unified IT service catalog. In addition for aneed to drastically cut off the time to provision services for their customers, Rainpolealso had a need to have a more agile development process that will enable morefrequent and reliable software releases. vRealize Code Stream fits into this category byallowing modeling any release process for any kind of software, while integrating withexisting continuous integration tools and artifact management.

Over the next few months, The IT Automation team will be starting their Private CloudJourney with vRealize Automation and vRealize Code Stream.

Rainpole's Fundamental IT Challenge

• Quickly implement a tool which will allow IT to maintain control over their datacenter resources while allowing engineering to quickly create and destroyenvironments for development and testing using shared, heterogeneous clouds.

• Provide a personalized self-service experience to the different teams withinengineering development (as a starting point, with QE and potentially other partsof the organization be added in the future).

• Decrease service delivery times by automating the end-to-end delivery andmanagement of resources to meet the needs of the agile developmentenvironment. Provide an approval mechanism when needed to ensure complianceis met.

In order to support self-service for the engineering and QE teams while leveragingexisting infrastructure from both internal and external resources and retaining thenecessary controls, the Rainpole IT leadership team has decided to implement VMware'snext generation cloud management solution. The Rainpole development team will kickoff the implementation as the first group of users, with QE scheduled to follow on shortlyafter in a second wave.

If you have not already reviewed it, the Lab Introduction contains details about RainpoleSystems (our example company), as well as important information on text entry,multiple language support and on-screen keyboard configuration. If desired, you canclick here to review this information again.

HOL-1721-USE-4


In this module you will act as the Rainpole Cloud Administrator to explore the vRealizeCode Stream.

HOL-1721-USE-4


Building a Simple Application ReleasePipelineIn this exercise, you will build a simple Application Release Pipeline with vRealize CodeStream.

Open Chrome Browser from Windows Quick Launch TaskBar

First you will log in to the vRealize Code Stream to begin building a new applicationrelease pipeline.

1. Click on the Chrome Icon on the Windows Quick Launch Task Bar.

Log in to vRealize Code Stream

1. Log in as rpadmin with the password VMware1!2. Click Sign In

Passwords for all users will be the same: VMware1!

HOL-1721-USE-4


View the MyCommerce Test Blueprint in the Catalog

1. Click the Catalog tab2. Select the MyCommerce Service3. View the MyCommerce Test Service which will be used by the vRealize Code

Stream Pipeline to create test systems.

HOL-1721-USE-4


Examine the Blueprint

1. Click on the Design tab2. Select Blueprints3. To view the MyCommerce Test blueprint, click on the name (blue text) to open

the Blueprint Design Canvas

HOL-1721-USE-4


View the Blueprint Design Canvas

View the Blueprint on the Design Canvas and make note of its components. When youdeploy a test system with vRealize Code Stream you will select this blueprint whichdeploys a CentOS server, performs systems configuration (disable firewall), installsApache Web Server and connects the machine to an existing network.

1. Note the Apache and System_Configuration Software Component, deployedto the vSphere Machine

2. Note the Blueprints connection to the ExternalDefaultNetwork3. Click Cancel to exit the design canvas and beging creating your new pipeline

HOL-1721-USE-4


Navigate to Code Stream and Add a New Pipeline

1. Click the Code Stream tab2. Click the Pipelines sub-tab3. Finally, click the Add button in the toolbar to begin creating a new pipeline.

HOL-1721-USE-4


Build a new Pipeline with a Test stage

The first thing you'll want to do once you're in Code Stream is to start building out yourown pipeline. Pipelines can be modeled first without specifying any configurations. Thiscan give you a good way to lay out the entire process before entering any details.

1. Enter HOL - Simple Pipeline for the name2. Enter Simple Pipeline Created in Module 1 for the description3. Click Stages to begin modeling the pipeline

HOL-1721-USE-4


Adding a Pipeline Stage

To add a stage in vRealize Code Stream

1. Click on Add Stage which will create a basic staged named Stage02. Double-click Stage0 and enter Test3. Click Add Task to begin creation of the first task in the pipeline

HOL-1721-USE-4


Adding Provisioning Task

Enter the following information. Please note that the text fields here are CASESENSITIVE. If you do not enter the information with the correct case here, you mayhave issues later on.

1. Select PROVISION for the Category drop-down2. Select vRealize Automation 7 for the Provider drop-down3. For the Name, enter Provision Machine4. Select OK

HOL-1721-USE-4


Configure Provisioning Task

1. Select the gear icon (not shown) next to the Provision Machine Task and thenselect Configure in the drop down

You will be prompted to save the pipeline configuration (Not shown), click Yes whenprompted

HOL-1721-USE-4


Task vRA Properties

Before configuring the task, you should resize the window so it fits better in the screen.Click in the upper left-corner and drag down and to the right to resize (not shown here)

1. In the task editor, click the drop-down and select vRA Production for theEndpoint

2. Click the drop-down next to Blueprint and select MyCommerce Test. Note this isthe blueprint you examined earlier in this exercise

HOL-1721-USE-4


Task vRA Properties, Cont.

1. Scroll down the window by dragging the slider on the right side2. On the left side of the window, click MyCommerce3. Note the properties that are available for the virtual machine. The options for

CPUs, Memory, etc are defined in the vRealize Automation blueprint and availablefor selection (if allowed) here

4. Enter HOL-1721 Code Stream for the Description5. Click Save to continue

HOL-1721-USE-4


Adding a Deploy Website Task

1. Still using the Test stage, select the Add Task to create a new task

HOL-1721-USE-4


Deploy Task

1. Select Deploy for the Category drop-down2. Select Script for the Provider drop-down3. For the Name, enter Install Website4. Select OK

HOL-1721-USE-4


Configure Deploy Task

1. Scroll down the stage by dragging the slider on the right side2. Select the gear icon (not shown) next to the Install Website task and then

select Configure from the drop down

You will be prompted to save the pipeline configuration (Not shown), click Yes whenprompted.

Configure Custom Script Task - General

Step 1

• For Host, select Read From Pipeline or Task Property. This is because youwant to leverage the VM that gets created as a result of the Provision task youjust created

• In the Machine Type Property Path type ${Test.Provision Machine.machines}(Note, there is a space between the words Provision and Machine, andthat this field is case sensitive.)

• Select All Hosts from the dropdown next to the variable• Username: root• Password and Confirm Password: VMware1!• Script type: Bash

HOL-1721-USE-4


• Execute Script file: /root/install.sh

Step 2

• Select the Advanced Tab

Note: You can paste the variables or start typing ${ and make the selectionfrom the list presented. The next variable will be presented once you click onthe existing variable.

Configure Custom Script Task - Advanced

Under Script Parameters - Other enter the following parameters.

Step 1

• Select +Add

Step 2

Create a variable with the following

HOL-1721-USE-4


• Parameter Name: JENKINS_SERVER• Parameter Value: jenkins-l-01a.corp.local

Select +Add to add another variable

• Parameter Name: JENKINS_JOB_NAME• Parameter Value: MyCommerce-Build (Note: The parameter value is case

sensitive)

Step 3

• Click Save

HOL-1721-USE-4


Completed Test Stage

1. Once both tasks are configured and saved, click Activate to activate the pipelinetemplate

HOL-1721-USE-4


Executing a Simple Application ReleasePipelineIn the previous exercise, you created a simple application release pipeline and activatedit. It is now time to execute the pipeline to validate everything is working as expected.

Execute the Pipeline

1. Click to highlight the pipeline HOL - Simple Pipeline2. Click Execute

HOL-1721-USE-4


Execute the Pipeline, Continued

1. Click OK

HOL-1721-USE-4


Enable Auto-Refresh

1. Click the Pipeline Executions tab (not shown)2. Click Enable Auto-refresh to automatically update the status. (It will likely take

several minutes for the pipeline to complete)3. Click the small arrow on the left of the pipeline execution to see the details

HOL-1721-USE-4


Successful Pipeline Execution

Once the pipeline Test Stage and tasks turn green it has executed successfully.

HOL-1721-USE-4


Deployment Verification

To verify the VM and code deployment worked you will need the IP address of the VMthat was created.

1. Within vRealize Automation, select the Items tab2. Click the Deployments Tab3. Click the arrow next to most recent deployment in the list that has a name

starting with MyCommerce Test to expand the components4. Click on the virtual machine that has a name beginning with dev- which will take

you to the Item Details screen

HOL-1721-USE-4


Deployment Verification, Item Details Screen

1. Click the Network tab2. Document the IP address. The IP address range could be from one of several

subnets due to the round-robin network selection configured as part of theblueprint.

HOL-1721-USE-4


Website Verification

Once you have the IP address you can verify that your pipeline execution was a success.

1. Create a new tab in Chrome2. Browse to the IP of the newly created VM in the new tab, which will show the

MyCommerce.com homepage.

HOL-1721-USE-4


Exercise Clean-up

Once you have verified the Pipeline has completed successfully you will now clean upthe the lab.

1. Click on the vRealize Automation Tab2. Scroll down the screen by dragging the slider bar down to the bottom3. Click Close

HOL-1721-USE-4


Destroy the Provisioned Machine

1. Click to highlight the my recent MyCommerce Test deployment2. Click the arrow next to Actions3. Click Destroy

Confirm Destroy

Click Submit to destroy the virtual machine and OK (not shown) to confirm. You havesuccessfully concluded this exercise.

HOL-1721-USE-4


SummaryIn this module, you have begun to explore the capabilities of vRealize Code Stream. Youlearned about Application Release Automation and modeled a simple pipeline to quicklydeploy a test system with vRealize Automation. After modeling this pipeline, youexecuted it and verified the results. This was a very simple example and we encourageyou to explore Module 2 in this lab to see more complex pipelines and use cases.

You've finished Module 1

Congratulations on completing Module 1.

We hope you have enjoyed this lab, if you want to learn more about vRealize CodeStream please try;

• Visit https://www.vmware.com/products/vrealize-code-stream.html• Or use your smart device to scan the QRC Code.

How to End Lab

To end your lab click on the END button.

HOL-1721-USE-4


https://www.vmware.com/products/vrealize-code-stream.html

Module 2 - Using vRealizeCode Stream for

Application ReleaseAutomation (60 minutes)

HOL-1721-USE-4


Introduction to Lab ScenarioAs you work through the lab's use cases, you'll be assuming roles within a fictionalcompany, Rainpole, and addressing their business and IT challenges.

Rainpole is an IT company that is under pressure to build private clouds, which meanscreating a data center architecture that can deliver a flexible, scalable computing whilemaintaining governance and control over their environment. Rainpole IT Automationteam decided to reach out to VMware to help them with their journey to private cloud.vRealize Automation empowers IT to accelerate the delivery of personalized, business-relevant IT Services while improving overall efficiency, by delivering infrastructure,application and custom services through a unified IT service catalog. In addition for aneed to drastically cut off the time to provision services for their customers, Rainpolealso had a need to have a more agile development process that will enable morefrequent and reliable software releases. vRealize Code Stream fits into this category byallowing modeling any release process for any kind of software, while integrating withexisting continuous integration tools and artifact management.

Over the next few months, The IT Automation team will be starting their Private CloudJourney with vRealize Automation and vRealize Code Stream.

Rainpole's Fundamental IT Challenge

• Quickly implement a tool which will allow IT to maintain control over their datacenter resources while allowing engineering to quickly create and destroyenvironments for development and testing using shared, heterogeneous clouds.

• Provide a personalized self-service experience to the different teams withinengineering development (as a starting point, with QE and potentially other partsof the organization be added in the future)..

• Decrease service delivery times by automating the end-to-end delivery andmanagement of resources to meet the needs of the agile developmentenvironment. Provide an approval mechanism when needed to ensure complianceis met.

In order to support self-service for the engineering and QE teams while leveragingexisting infrastructure from both internal and external resources and retaining thenecessary controls, the Rainpole IT leadership team has decided to implement VMware'snext generation cloud management solution. The Rainpole development team will kickoff the implementation as the first group of users, with QE scheduled to follow on shortlyafter in a second wave.


HOL-1721-USE-4


This module will build on the simple application release pipeline created in Module 1. Ifyou did not take Module 1, a starter pipeline with the work from Module 1 is alreadycreated so there is no requirement to previously complete it.

In this module, you will act as the Rainpole Administrator and the Rainpole CloudAdministrator to explore the vRealize Code Stream.

HOL-1721-USE-4


Building a "Staging" Stage for QAIn this exercise, you will expand a simple Application Release Pipeline to include a"Staging" stage.


First you will log in to the vRealize Code Stream to begin building a new applicationrelease pipeline.


Log in to vRealize Code Stream


Passwords for all users will be the same: VMware1!

HOL-1721-USE-4


Navigate to Code Stream and Edit a Pipeline

1. Click the Code Stream tab2. Click the Pipelines sub-tab3. Click the pipeline named Base - Standard Pipeline4. Finally, click the Edit button in the toolbar to begin editing the pipeline

HOL-1721-USE-4


Navigate to Stages

1. Click on Stages> to navigate to the Stages view

HOL-1721-USE-4


Adding a "Staging" Stage

To add a "Staging" stage in vRealize Code Stream

1. Click on Add Stage which will create a basic staged named Stage02. Double-click Stage0 and enter Staging

HOL-1721-USE-4


Clone and Existing Task

Next, you're going to create an Install Website task for the "Staging" stage. To savetime, you can Clone the existing task from the Test stage.

1. Select the gear icon (not shown) next to the Install Website Task and then selectClone in the drop down

Click OK (not shown) on the Clone Task warning that passwords will be reset to null

HOL-1721-USE-4


Configure the Install Website Task

1. Drag the cloned Install Website - clone task to the "Staging" stage2. Select the gear icon (not shown) next to the Install Website - clone task and then

click Configure in the drop down


Change the Name of the Install Website task

1. Click in the Name field of Task Configuration and type the name Install Website

Configure Install Website Task - General

Step 1

• Scroll down the Task Configuration window by dragging the slider on the rightside

Step 2

HOL-1721-USE-4


• For Host, select User Defined Hosts. This is because you will use an existingmachine that has already been provisioned to demonstrate the ability to leverage"brownfield" hosts in a pipeline.

• In the open text box below User Defined Hosts, type brownfield-01a.corp.localand press Enter

• Username: Verify is is still set to root• Password and Confirm Password: VMware1!• Script type: Verify it is still set to Bash• Execute Script file: Verify it is still set to /root/install.sh

Step 3

• Click the Advanced Tab

Configure Install Website Task - Advanced

Step 1

Under Script Parameters - Other verify the following parameters.

• Parameter Name: JENKINS_SERVER• Parameter Value: jenkins-l-01a.corp.local• Parameter Name: JENKINS_JOB_NAME

HOL-1721-USE-4


• Parameter Value: MyCommerce-Build (Note: The parameter value is casesensitive)

Step 2

Click Save

HOL-1721-USE-4


Add a Delete Test Machine Task

Because you no longer need the test machine you provisioned in the test stage, you cancreate a task to delete the test machine. A vRealize Orchestrator workflow has alreadybeen created to call the vRealize Automation API and destroy the virtual machine. Youwill now add it as another step in the "Staging" stage.

1. Click + Add Task on the "Staging" stage

Add a Delete Test Machine Task, Continued


1. Select CUSTOM for the Category drop-down2. Select vRealize Orchestrator Workflow for the Provider drop-down3. For the Name, enter Delete Test Machine4. Select OK

HOL-1721-USE-4


Configure Delete Test Machine Task

1. Select the gear icon (not shown) next to the Delete Test Machine Task and thenselect Configure in the drop down


HOL-1721-USE-4


Configure Custom Script Task - General

1. Scroll down the Task Configuration window by dragging the slider on the rightside

2. For Workflow click the down arrow and select Destroy vRA Machine3. In Input Parameters, for machineName enter ${Test.Provision Test

Machine.machines} (Note, there is a space between the words Provisionand Test and Machine, and that this field is case sensitive.)

4. Click Save


This completes the "Staging" stage for now. Remain on the Edit Pipeline screen forthe next exercise.

HOL-1721-USE-4


Build a Gating RuleGating rules allow you to control when code is promoted between pipeline stages.

You can create gating rules based upon approvals or the results of automated testsperformed with testing frameworks like Selenium. In this exercise, you will create agating rule to promote code from the Test stage to the "Staging" stage based upon theresults of a Selenium Test executed by Jenkins.

Return to the Pipeline Properties Screen

1. On the Edit Pipeline screen from the previous exercise, click < Previous

Add a Property Value to the Pipeline

Step 1

Click + Add to add a new property

Step 2

Enter the following for the newly created property:

• Property Name: teststring

HOL-1721-USE-4


• Property Description: Test String for Selenium Tests• Parameter Value: MyCommerce.com - Deal of the Day

Note: All entries in Step 2 are case sensitive

Step 3

• Click Stages to continue

Create a Selenium Test Task in the Test Stage

1. In the Test stage, Click +Add Task

HOL-1721-USE-4


Adding Selenium Test Task


1. Select TEST for the Category drop-down2. Select Jenkins for the Provider drop-down3. For the Name, enter Selenium Test4. Select OK

HOL-1721-USE-4


Configure Selenium Test Task

1. Scroll down the Test stage by dragging the slider on the right side2. Select the gear icon (not shown) next to the Selenium Test Task and then select

Configure in the drop down


HOL-1721-USE-4


Selenium Test Jenkins Properties


2. For Endpoint click the down arrow and select Jenkins Production3. For Job click the down arrow and select MyCommerce-Test4. In the Parameters section for the testurl enter ${Test.Provision Test

Machine.machines[0].value.hostIp[0]} (Note, there is a space betweenthe words Provision and Test and Machine, and that this field is casesensitive.)

5. In the Parameters section for the teststring enter ${pipeline.teststring}(Note, this field is case sensitive.)

6. Click Save

Note: You can paste the variables or start typing ${ and make the selectionfrom the list presented. The next variable will be presented once you click onthe existing variable though the last two in the string will need manuallyentered. The next step will explain more about the syntax used above.

Note About JSON Syntax

When specifying the testurl parameter in the previous step, you may have noticed howthe parameter completion didn't work once you got to the "[0]" part. This is because weneed to pass the IP of the host to our Selenium job which is verifying that the websiteactually got deployed and is running.

HOL-1721-USE-4


These kinds of expressions are possible in vRCS, since the values get passed in JSONformat. For variable binding in vRCS, you can autocomplete up to any variable in thepipeline, but the expression after (in our case after ".machines"), is a pure JSON pathexpression.

The string we are parsing contains a "hostIp" parameter, which we need to pass to ourSelenium test. We know that it contains this because we first captured the outputof${Test.Provision Test Machine.machines}.

For more information about this syntax, refer to https://github.com/jayway/JsonPath.

Add a Gating Rule

1. Between the Test and "Staging" stages, click on the gating rules icon (it lookslike an open door)

Configure the Gating Rule

1. Select the radio button next to "If outcome of a vRealize Orchestrator workflowis successful"

2. For Select Workflow click the down arrow and select Test AcceptanceThreshold

3. In the Input Parameters section, for the Threshold Percentage enter 1004. In the Input Parameters section, for the Test Result enter ${Test.Selenium

Test.testResult} (Note, there is a space between the words Seleniumand Test, and that this field is case sensitive.)

5. Click Save


HOL-1721-USE-4


https://github.com/jayway/JsonPath

This completes this exercise, next you will build a production stage.

HOL-1721-USE-4


Build an Approval Policy and Move toProductionNext you will create a new stage called Production with an approval policy that requiresthe Rainpole Cloud Admin to approve code moves to production.

To save on lab resources, you will re-deploy to the brownfield server and pretend thatit's a server in a production environment.

Adding a Production Stage

To add a Production stage in vRealize Code Stream

1. Click on + Add Stage which will create a basic staged named Stage02. Double-click Stage0 and enter Production3. Select the gear icon (not shown) next to the Install Website Task and then select

Clone in the drop down

Click OK (not shown) on the Clone Task warning that passwords will be reset to null

Configure the Install Website Task

1. Drag the cloned Install Website - clone task to the Production stage

HOL-1721-USE-4


2. Select the gear icon (not shown) next to the Install Website - clone task and thenclick Configure in the drop down


Change the Name of the Install Website task

1. Click in the Name field of Task Configuration and type the name Install Website

Configure Install Website Task - General

Step 1

• Scroll down the Task Configuration window by dragging the slider on the rightside

Step 2

HOL-1721-USE-4


• For Host, select User Defined Hosts. This is because you will use an existingmachine that has already been provisioned to demonstrate the ability to leverage"brownfield" hosts in a pipeline.

• In the open text box below User Defined Hosts, type brownfield-01a.corp.localand press Enter

• Username: Verify is is still set to root• Password and Confirm Password: VMware1!• Script type: Verify it is still set to Bash• Execute Script file: Verify it is still set to /root/install.sh

Step 3

• Click the Advanced Tab

NOTE: The Production and "Staging" stages utilize the same brownfield server.This would not normally be done in a pipeline, but was done here due to

limited lab resources.

Configure Install Website Task - Advanced

Step 1

Under Script Parameters - Other verify the following parameters.

HOL-1721-USE-4


• Parameter Name: JENKINS_SERVER• Parameter Value: jenkins-l-01a.corp.local• Parameter Name: JENKINS_JOB_NAME• Parameter Value: MyCommerce-Build (Note: The parameter value is case

sensitive)

Step 2

Click Save

HOL-1721-USE-4


Add a Gating Rule

1. Between the "Staging" and Production stages, click on the gating rules icon (itlooks like an open door)

HOL-1721-USE-4


Configure the Gating Rule

1. Select the radio button next to "If outcome of a vRealize Orchestrator workflowis successful"

2. For Select Workflow click the down arrow and select Approval3. In the Input Parameters section, for the Approval Group (DN) enter

vsphere.local\approvalgroup4. Click Save

The base lab already has a custom group created in vRealize Automation namedapprovalgroup with a [email protected] as it's only member.

HOL-1721-USE-4


Activate Pipeline

1. Once both tasks are configured and saved, click Activate to activate the pipelinetemplate

The pipeline is now ready to be executed.

HOL-1721-USE-4


Executing the Production ApplicationRelease PipelineIn the previous exercise, you created a production application release pipeline andactivated it. It is now time to execute the pipeline to validate everything is working asexpected.

Note: Execution of this pipeline may take 10-15 minutes to complete.


1. Click to highlight the pipeline Base - Standard Pipeline2. Click Execute

HOL-1721-USE-4



1. Click OK

HOL-1721-USE-4


Enable Auto-Refresh

1. Click the Pipeline Executions tab (not shown)2. Click Enable Auto-refresh to automatically update the status.3. Click the small arrow on the left of the pipeline execution to see the details

HOL-1721-USE-4


Pipeline Pause for Approval

1. The pipeline will successfully complete through the gating rule between"Staging" and Production. This pause is for the approval policy you defined onthe gating rule.

Note: The pipeline is paused when a yellow 'pause' symbol appears next to theIN_PROGRESS status. You will also notice a vertical yellow bar next to the gating rule.Continue to the next step when the pipeline pauses. (may take ~10 minutes)

Log out of vRealize Automation

Now let's logout of vRealize Code Stream in order to approve the request to move codeto production.

1. Click Logout

HOL-1721-USE-4


Return to Login Page

1. Click Go back to login page

Login to the vRealize Automation as Cloud Admin

1. Log in as cloudadmin with the password VMware1!2. Click Sign In

HOL-1721-USE-4


Navigate to the Inbox to Approve the Request

1. Click the Inbox tab2. Click on the Manual User Action tab3. Click on request number(example: the number 1) to open the approval tab

HOL-1721-USE-4


Approve the Request

1. Notice the details of the request in the Approver Message field2. Enter "This code is ready for production" in the Comments field3. Click Submit to approve


Now lets logout of vRealize Code Stream in order to approve the request to move codeto production.

1. Click Logout

HOL-1721-USE-4




Login to the vRealize Automation as rpadmin


HOL-1721-USE-4



You will now return to the pipeline execution tab and validate the pipeline completedsuccessfully.

1. Click on the Code Stream tab2. Click the Pipeline Executions sub-tab3. Validate that the Status of the pipeline has changed to "All the tasks of the

flow have completed successfully"

HOL-1721-USE-4



You can verify that your pipeline execution was a success.

1. Create a new tab in Chrome2. Browse to http://brownfield-01a.corp.local in the new tab, which will show the

MyCommerce.com homepage

You have completed this exercise. Next you will review an enhanced pipeline.

HOL-1721-USE-4


Review Enhancements to the PipelineIn this exercise, you will review a pre-created pipeline with a number of enhancementsto the workflow including parallel execution, conditional execution and artifactmanagement. This enhanced pipeline will build on the work you completed in previousexercises.

Navigate to Code Stream and Edit a Pipeline

1. Click the Code Stream tab2. Click the Pipelines sub-tab3. Click the pipeline named Complete - Enhanced Pipeline4. Finally, click the Edit button in the toolbar to begin editing the pipeline

Note: If you still have the MyCommerce website tab open. click on the vRealizeAutomation tab in Chrome first.

Pipeline Properties

Step 1

• Scroll down the Pipeline window by dragging the slider on the right side

HOL-1721-USE-4


Step 2

Three new properties have been added to the pipeline which will be used by tasks laterin this lesson.

• EMERGENCY_RELEASE is set to a default value of false. This property will beused later to signify an emergency bugfix release of the software and will bypassthe Install Website task in the "Staging" stage.

• BUILD_NAME is set to a default value of MyCommerce-Build. This property willbe used in the artifact management tasks to resolve the correct binary artifacts

• BUILD_NUMBER does not have a default value. This property will also be usedin artifact management tasks to resolve the correct binary artifacts

Step 3

• Click the Stages > button to continue

HOL-1721-USE-4


Parallel Tasks in Test Stage

vRealize Code Stream has the capability to execute tasks in parallel to accelerate thesespeed of execution.

1. In the Test stage, notice the Provision Test Machine and Resolve Artifacttasks are side by side. This signifies that they will execute in parallel. To make atask run in parallel, just drag the task next to the task you would like it to run inparallel with.

View Configuration of the Resolve Artifact Task

1. Select the gear icon (not shown) next to the Resolve Artifact task and then clickConfigure in the drop down

View Added Artifact Properties

This task will resolve an artifact from Artifactory utilizing the pipeline properties definedpreviously.


HOL-1721-USE-4


2. Note the three properties that are being utilized to resolve the correct artifact.These are buildName, buildNumber and name which are all defined based on

properties defined at the pipeline level.3. Click Cancel to return to the Pipeline view

View Configuration of the Install Website Task

1. Select the gear icon (not shown) next to the Install Website task and then clickConfigure in the drop down

View Install Website Properties

This Install Website task is updated to take advantage of Artifactory for binary retrieval.

HOL-1721-USE-4



2. The Execute Script File value has been updated to /root/artifactory-install.shin order to take advantage of Artifactory integration

3. Click Advanced at the top of the screen to view the details on the propertiessent to the script

HOL-1721-USE-4


View Install Website Advanced Properties

The advanced properties are utilized to specify the location and build for the artifactsbeing retrieved.


2. The Artifact Group is assigned to ${Test.ResolveArtifact.ARTIFACT_OUTPUT}. This value is one of the outputs from the ResolveArtifact task covered previously.

3. For Script Parameters Artifact, TargzFile has been added with a Value of Artifactand Download URL. This will be the download URL for the binary artifact storedin Artifactory from the output of the Resolve Artifact task

4. In Script Parameters Other, build_id has been added which have a value of${pipeline.BUILD_NUMBER}

5. Click Cancel to return to the Pipeline view

HOL-1721-USE-4


View Configuration of the Install Website Task in "Staging"

1. Select the gear icon (not shown) next to the Install Website task and then clickConfigure in the drop down

HOL-1721-USE-4


View Install Website Properties

The Install Website task in the "Staging" stage is identical to the one in the Test stagewith one exception. This task has conditional logic applied which allows it to bebypassed in the event the EMERGENCY_RELEASE pipeline property is set to true. Thisfunctionality can be useful to speed up the deployment process for bug or security fixes.

1. For Execute Task, the radio button for On Conditions is selected2. In the box below the radio button, you will see the algorithm to determine

whether or not the task will be executed. In this case, the task will be executed aslong of EMERGENCY_RELEASE is not equal to TRUE, True or true.


HOL-1721-USE-4


View Configuration of the Resolve Certified Artifact Task

1. Scroll to the right in the Edit Pipeline window by dragging the slider on the rightside

2. Select the gear icon (not shown) next to the Resolve Certified Artifact task inthe Production stage and then click Configure in the drop down

HOL-1721-USE-4


View Added Artifact Properties

The Resolve Certified Artifact task is largely identical to the task in the Test stage,except it searches on an additional property RELEASE_CERTIFIED. This is an example ofa custom Artifactory property that can be leveraged by Release Managers to certify arelease is approved for production.


2. Note the three properties that are being utilized to resolve the correct artifact.These are build.name, build.number and RELEASE_CERTIFIED


Note: The Install Website task (not shown) in the production stage was modified as wellto use this CertifiedArtifact rather than the Artifact from the Test stage.

HOL-1721-USE-4


Close Edit Pipeline

1. Click Close in the Edit Pipeline window

HOL-1721-USE-4


Open Artifactory

Before you execute the pipeline, you need to mark a release certified in Artifactory.vRealize Code Stream includes a license for Artifactory and it is pre-installed on theappliance.

1. Create a new tab in Chrome2. Click Admin on the bookmarks bar3. In the menu that appears, click on Artifactory

Login to Artifactory

1. Click Log In in the upper right hand corner of the Artifactory screen.

HOL-1721-USE-4


Login to Artifactory, Continued

1. Enter vmadmin for the username2. Enter VMware1! for the password3. Click Log In

HOL-1721-USE-4


Access Properties for the Binary Artifact

1. Click on Artifacts on the left side menu bar2. Click the arrow next to demo-repo in the Artifact Repostory Browser tree3. Click on cs-demo-2.tar.gz under demo-repo4. Click the>> on the right-hand side next to Effective Permissions5. Click Properties to add or edit properties to the file

HOL-1721-USE-4


Add the RELEASE_CERTIFIED Property

1. Enter RELEASE_CERTIFIED for the Name. (Note: This value is casesensitive)

2. Enter TRUE for the Value3. Click Add to save the property

HOL-1721-USE-4


Validate Changes

1. Scroll down the properties window by dragging the slider on the right side2. Verify that the RELEASE_CERTIFIED property exists with a value of TRUE

This concludes this exercise, you will now execute this pipeline to see it in action.

HOL-1721-USE-4


Execute the Enhanced PipelineIn the previous exercise, you reviewed an enhanced application release pipeline. It isnow time to execute the pipeline to validate everything is working as expected.

Note: Execution of this pipeline may take 10-15 minutes to complete.


1. Click on the vRealize Automation Tab2. Click to highlight the pipeline Complete - Enhanced Pipeline3. Click Execute

HOL-1721-USE-4



1. Change the value for the EMERGENCY_RELEASE property to TRUE2. Enter 2 for the BUILD_NUMBER Property3. Click OK to start the application release pipeline

HOL-1721-USE-4


Enable Auto-Refresh

1. Click the Pipeline Executions tab (not shown)2. Click Enable Auto-refresh to automatically update the status. (It may take ~10

minutes for this pipeline execution to complete)3. Click the small arrow on the left of the pipeline execution to see the details4. As the pipeline executes, note that Provision Test Machine and Resolve

Artifact execute concurrently in the Test stage.

HOL-1721-USE-4


Pipeline Pause for Approval

1. The pipeline will successfully complete through the gating rule between "Staging"and Production. This pause is for the approval policy you defined on the gatingrule. The status of the pipeline will remain at IN_PROGRESS but it will have ayellow pause sign next to it.

2. Note that the Install Website task was skipped (gray bar at the top of the task)because we set the EMERGENCY_RELEASE value to TRUE when executing thepipeline


Now lets logout of vRealize Code Stream in order to approve the request to move codeto production.

1. Click Logout

HOL-1721-USE-4




Login to the vRealize Automation as Cloud Admin

1. Log in as cloudadmin with the password VMware1!2. Click Sign In

HOL-1721-USE-4


Navigate to the Inbox to Approve the Request

1. Click the Inbox tab2. Click on the Manual User Action tab3. Click on request number (example: the number 2) to open the approval tab

HOL-1721-USE-4


Approve the Request

1. Notice the details of the request in the Approver Message field2. Enter "This code is ready for production" in the Comments field3. Click Submit to approve


Now lets logout of vRealize Code Stream to check the status of the pipeline.

1. Click Logout

HOL-1721-USE-4




Login to the vRealize Automation as rpadmin


HOL-1721-USE-4



You will now return to the pipeline execution tab and validate the pipeline completedsuccessfully.

1. Click on the Code Stream tab2. Click the Pipeline Executions sub-tab3. Validate that the Status of the pipeline has changed to "All the tasks of the

flow have completed successfully"

HOL-1721-USE-4



You can verify that your pipeline execution was a success.

1. Create a new tab in Chrome2. Browse to http://brownfield-01a.corp.local in the new tab, which will show the

MyCommerce.com homepage

You have completed this exercise.

HOL-1721-USE-4


SummaryIn this module, you have explored building complex application release pipelines withvRealize Code Stream. You learned about approvals, artifact management tasks,automated testing, conditional execution and viewing pipeline statuses. vRealize CodeStream is truly the glue that binds together your Software Development Lifecycle (SDLC)processes to increase agility and ensure processes are repeatable.



We hope you have enjoyed this lab, if you want to learn more about vRealize CodeStream please try;

• Visit https://www.vmware.com/products/vrealize-code-stream.html• Or use your smart device to scan the QRC Code.

How to End Lab


HOL-1721-USE-4


https://www.vmware.com/products/vrealize-code-stream.html

Module 3 - vRealize CodeStream for IT DevOps (45

Minutes)

HOL-1721-USE-4


Introduction to vRealize Code Streamfor IT DevOpsVMware’s concept of the Software-Defined Data Center (SDDC) abstracts every servicein the data center from its underlying platform and defines services as software.Software-defined content can be treated just like code in any software application,meaning that modern software development methodologies can be adopted, andpractices such as agile development and DevOps can be applied to the configurationsand content within the SDDC. Although this approach lends itself to moderndevelopment practices and rapid service delivery, the reality is that it can still bechallenging to manage a whole data center's worth of software-defined services.

The vRealize Code Stream Management Pack for IT DevOps eases the burden ofmanaging software-defined content by providing administrators with the followingcapabilities:

• Manage Software-Defined Data Center (SDDC) content as code, automating therelease process.

• Apply version control to all SDDC content.• The ability to provide Continuous Integration/Continuous Delivery (CI/CD) through

automated testing and release.• Capture software-defined content automatically in a consistent format from

multiple environments.• Store content in a central JFrog Artifactory repository with the ability to

alternatively store large files on attached storage• Partition the repository to allow multiple developers to work on the same content

separately using branches• Tag content to allow concurrent release to multiple environments.• Roll back to the last good releasable version across any content type• Leverage vRealize Automation Advanced Service Design (ASD) forms, API access

and access control through entitlements of catalog items.• Using vRealize Code Stream to extend pre/post extensibility using custom

pipelines.• (Optional) Require approval before deploying content to a test or release

environment.• Audit and version control logs

HOL-1721-USE-4


Introduction to Lab ScenarioIn this module you will walk through migrating vRealize Automation infrastructureconstructs between Rainpole's Development and Production tenants using the vRealizeCode Stream Management Pack for IT DevOps (the artist formerly known as Houdini).

vRealize Code Stream Management Pack for IT DevOps

The Rainpole Cloud Administrators have decided to set up a Development vRealizeAutomation Tenant to develop their Blueprints and Software Components. In order tomanage the release of their developed Blueprints and components they have installedthe IT Devops Management pack allowing them to manage infrastructure as codeutilizing a Devops lifecycle.


In this module you will act as both the Rainpole Cloud Administrator and as aDevelopment User to explore the IT Devops Management Pack with vRealizeAutomation.

HOL-1721-USE-4


Capture a vRealize AutomationBlueprint from Rainpole DevelopmentTenantHere, you will prepare a blueprint for deployment into the Rainpole Production Tenant byfirst capturing it from the Development Tenant, assigning a version to it and storingwithin the Artifactory repository.


First you will log in to the Rainpole Development tenant to view the new blueprint to becaptured.


Browse to the Rainpole vRealize Automation DevelopmentTenant

1. Click on the vRA - Dev Tenant bookmark on the Chrome bookmarks bar

HOL-1721-USE-4


Log in to the Rainpole vRealize Automation DevelopmentTenant

1. Ensure that the domain corp.local is selected from the dropdown menu2. Click Next

HOL-1721-USE-4


Log in to the Rainpole vRealize Automation DevelopmentTenant

1. Log in as RPAdmin with the password VMware1!2. Click Sign In

HOL-1721-USE-4


View the Blueprint in the Catalog

1. Click Catalog2. View the Hadoop Service, we will be capturing this Blueprint

Examine the Blueprint that you will Capture

1. Click on the Design tab2. Click on Blueprints3. To view the Hadoop blueprint, click on the name (blue text) to open the Blueprint

Design Canvas

HOL-1721-USE-4



View the Blueprint on the Design Canvas and make note of its components, you willcapture this Blueprint as code and store it in the Artifactory repository ready fordeployment into production.

1. Note the Hadoop-Master Software Component, deployed to the vSphereMachine

2. Note the Blueprints connection to the ExternalDefaultNetwork3. Click Cancel

Log out of the Rainpole vRealize Automation DevelopmentTenant

1. Click Logout

Browse to the Rainpole vRealize Automation ProductionTenant

You will now log in to the Rainpole production tenant and request the service to capturethe Hadoop Service from the Rainpole Development Tenant

HOL-1721-USE-4


1. Click on the vRealize Automation bookmark on the Chrome bookmarks bar

Log in to the Rainpole vRealize Automation ProductionTenant

1. Ensure that the domain corp.local is selected from the dropdown menu2. Click Next

HOL-1721-USE-4


Log In to the Rainpole vRealize Automation ProductionTenant

You will log in as the Rainpole Administrator, a Cloud Admin user who has been grantedrights to vRealize Codestream Devops for IT Management pack


Navigate to the Catalog

1. The Home tab loads by default. Click on the Catalog tab to navigate to theService Catalog

HOL-1721-USE-4


Run the Single Package Request

You will now submit a Single Package Request as you will only be capturing a singlepackage in this instance. Note that Group Package Requests can be submitted from thisscreen which can be used to Capture, test and release a group of content packages suchas multiple blueprints.

1. Select the Packages Service Category2. Find the Single Package Request service and Click Request

HOL-1721-USE-4


Fill in the Request Details (Part 1)

1. Click Next


1. Select the Checkbox for Capture content from endpoint2. Click Next>


You will now specify; the type of package to capture, in this exercise you will becapturing a vRealize Automation Composite Blueprint, the source endpoint to capturethe package from and finally the content you will be capturing, which in this examplewill be the Hadoop service you viewed earlier.

HOL-1721-USE-4


1. From the Select package type: dropdown menu select Automation-CompositeBlueprint

2. From the Select source endpoint: dropdown menu select Rainpole vRADevelopment Tenant

3. From the Select content package: dropdown menu select the blueprintHadoop - [id=Hadoop]

4. Select the Include dependencies: Checkbox5. Click Next>

Submit the Request

1. Enter "Production Ready" in the Enter a version comment box2. Tick the Mark new version as release (optional) Checkbox3. Click Submit

HOL-1721-USE-4


Complete the Request

Click OK

Monitor the Pipeline Execution

1. Now, let's check the Pipeline execution. Click the Code Stream tab2. Click the Pipeline Executions tab3. Monitor the Status4. Click Refresh until the Status is "All the tasks of the flow have completed"

Congratulations! You have successfully captured a package containing a vRealizeAutomation composite blueprint from the Rainpole Development tenant. Continue to thenext section to deploy the captured package into the Rainpole Development Tenant.

HOL-1721-USE-4


Migrate the Captured Blueprint to theRainpole vRealize AutomationProduction TenantYou will now take your previously captured blueprint and deploy it to the RainpolevRealize Automation Production Tenant.

View the existing Blueprints

First lets check that the Hadoop blueprint we captured from the Rainpole Developmenttenant earlier does not exist in the Rainpole Production tenant

1. Click the Design tab2. Click Blueprints to ensure you are viewing the Blueprints3. Ensure that the Hadoop Blueprint does not exist in the list of blueprints

HOL-1721-USE-4


View the existing Software Components

Lets also check that the Hadoop blueprint software component dependencies do notexist in the Rainpole production tenant

1. Click Software Components2. Check the Hadoop Software Component doesn't exist in the list of Software

Components

HOL-1721-USE-4



Now you will release the Hadoop blueprint into the Rainpole production tenant, whichyou captured and stored within Artifactory earlier.

1. Click on the Catalog tab2. Select the Packages Service Category3. Find the Single Package Request service and Click Request

HOL-1721-USE-4



1. Click Next


1. Select the Checkbox for Capture content from endpoint2. Click Next>


Here you will identify the package that will be released into the production tenant.


HOL-1721-USE-4


2. From the Select content package: dropdown menu select Hadoop3. From the Version (optional): dropdown menu select 14. Click Next>

Fill out the Release Details

Now you will specify where to release the content package.

1. Select the Checkbox Rainpole vRA Production Tenant in the Select releasecontent endpoints: box

2. In the Enter a release comment: type "Version 1.0 Blueprint"3. Click Next>

HOL-1721-USE-4


Submit the Request

1. Click Submit


1. Click OK

HOL-1721-USE-4


Monitor the Pipeline Execution

1. Now lets check the Pipeline execution. Click the Code Stream tab2. Click the Pipeline Executions tab3. Monitor the Status4. Click Refresh until the Status is "All the tasks of the flow have completed" this

can take a few minutes

HOL-1721-USE-4


View the Migrated Blueprint

Now lets verify that the Hadoop Blueprint you captured earlier has been successfullyreleased into the Rainpole Production tenant

1. Click the Design tab2. Click Blueprints to ensure you are viewing the Blueprints3. Click on the new Hadoop blueprint that you just migrated to view the Design

Canvas

HOL-1721-USE-4



1. You can see that the Blueprint and its components were all migrated to theProduction tenant

2. Click Cancel

HOL-1721-USE-4


View Software Components

View the software components to ensure that the Hadoop Blueprint dependencies werealso captured and released into the Rainpole Production tenant

1. Click Software Components2. See that the Hadoop-Master software component was migrated as it was a

dependency for the Hadoop Blueprint


Now lets check if the Service Catagory and Hadoop Service were created in the catalog,you will need to log out and log in as a Rainpole Development user to view the service.

1. Click Logout

HOL-1721-USE-4




Login to the Rainpole Production Tenant as Devuser

1. Log in as Devuser with the password VMware1!2. Click Sign In

HOL-1721-USE-4




View the Hadoop Service in the Catalog

1. Click Big Data Service Category2. The Hadoop was added to the Big Data Service Catalog, as all dependencies

were captured including the Service Icon !

Congratulations! You have successfully migrated a Composite Blueprint and all of itsdependent components from the Rainpole vRA Development Tenant to the vRA RainpoleProduction Tenant.

HOL-1721-USE-4


Modify JSON Data to CustomizeExecutionIn this chapter, you will request a single package capture with the mock request flagchecked. You will then utilize the Cloud Client to export the request in a JSON file format,modify it by setting mock request flag to false and using the Houdini plugin for CloudClient submit the request capturing a new version of the Hadoop Blueprint.


First you will need to log out and log back in as the Rainpole Administrator

1. Click Logout



HOL-1721-USE-4


Log In to the Rainpole vRealize Production Tenant





You will now run through a new Single Package Request, however this time you will markit as a mock request so that the request is not actually deployed. You will export thisrequest in a JSON file format later.

HOL-1721-USE-4


1. Select the Packages Service Category2. Find the Single Package Request service and Click Request


1. Click Next


1. Select the Checkbox for Capture content from endpoint

HOL-1721-USE-4


2. Click Next>



2. From the Select source endpoint: dropdown menu select Rainpole vRADevelopment Tenant

3. From the Select content package: dropdown menu select the blueprintHadoop - [id=Hadoop]

4. Select the Include dependencies: checkbox5. Click Next>

HOL-1721-USE-4


Submit the Request

1. Enter Generating a request from the vRA UI in the Enter a versioncomment box

2. Tick the Mark new version as release (optional) checkbox3. Tick the Email request data checkbox4. Enter the Email addresses (comma separated): [email protected]. Tick the Mock request checkbox, as we do not want to run the actual request6. Click Submit

HOL-1721-USE-4



1. Click OK

Next, you will identify this request using the CloudClient, export it in a JSON format sothat you can edit it.

Open CloudClient

Double Click the CloudClient icon on the Desktop

HOL-1721-USE-4


Edit Window properties

Lets first increase the window so that you can read the CLI more easily

1. Click the Icon in the top left of the Window2. Select Properties from the Menu

HOL-1721-USE-4


Increase Window Width

1. Set Width to 1252. Click OK

HOL-1721-USE-4


Login to Houdini

1. Enter the following command to login to Houdini

houdini login userpass --server vra-01a.corp.local --user [email protected] --passwordVMware1! --tenant vsphere.local --vroUser [email protected] --vroPassword VMware1!

2. Type Y and press Enter to accept the certificate

HOL-1721-USE-4


Identify the last Request ID

In order to export our last request into a JSON file format we must first identify theRequest ID

1. Run the command;

vra request list

2. Right Click in the CloudClient Window Select Mark3. Highlight the ID for the last request in the list and Right Click again to copy it

HOL-1721-USE-4


Export the request to a JSON formatted file

Now you will run the command to export the request into a JSON file format

1. Run the command:

vra request detail --id <paste the request id copied earlier here> --export c:\request.json--format JSON

Remember that you can paste the request ID by right-clicking in the command windowand selecting Paste

Open File Explorer

1. From the Taskbar open File Explorer

HOL-1721-USE-4


Open the Request.JSON File using Notepad++

Now you will begin to modify the previous request by editing the JSON file you justcreated.

1. Navigate to Local Disk (C:)2. Right Click on the file Request.JSON (not pictured)3. Click Edit with Notepad++

HOL-1721-USE-4


Search for the line to edit

You will modify the previous request by editing the JSON file to remove the MockRequest which was set during request.

1. From the Menu Bar Click on the image of the Binoculars to open the FindWindow

2. In the Find what: field type provider-mock3. Click Find Next4. Click Close

HOL-1721-USE-4


Edit the JSON File

1. In the provider-mock section change the vale from true to false2. Click Save to save the file3. Close the Notepad++ window4. Return to the CloudClient Window

HOL-1721-USE-4


Display the Content Packages

Now lets check the current version of the Hadoop blueprint stored within the Artifactoryrepository.

1. Run the command;

houdini content list

The list shows the captured Hadoop Blueprint and dependancies package that wascaptured in the first lesson of this module.

Note the current version and latest release version are set to 1

Run the modified JSON Request

You will now use the Cloudclient Houdini plugin to submit the modified JSON request

1. Run the command

houdini request --file c:\request.json

HOL-1721-USE-4


Check the Request completed successfully

1. Run the command

vra request list

You will see that request is now in progress, run the command again until the statechanges to successful. This may take some time depending on your lab environment, soplease be patient!

Check the Houdini Content Package version

1. Run the command;

houdini content list

The list shows that captured Hadoop Blueprint and dependancies package that youcaptured earlier, has now been recaptured and its version has been incremented. Thiswas achieved by setting the mock request flag of a previous mock request to false byediting the JSON request.

Congratulations! You've reached the end of this module.

HOL-1721-USE-4


SummaryIn this module you have begun to explore the capabilities of the vRealize Code StreamDevOps for IT Management pack. From the Rainpole Development Tenant you captureda vRealize Automation Blueprint and its dependencies, adding it to the artifactoryrepository with version control. You then took that blueprint and its dependencies,deploying it to the Rainpole Production Tenant and confirming that it was added to thecatalog and that its Software components came along for the ride.

You then explored the use of the "Houdini" plugin for CloudClient by exporting a request,modifying the JSON file and using it to submit a new request.



I hope you have enjoyed this lab, if you want to learn more about the DevOps for ITManagement pack please try;

• Visit https://solutionexchange.vmware.com/store/products/vmware-vrealize-code-stream-management-pack-for-it-devops--2

• Or use your smart device to scan the QRC Code.

How to End Lab


HOL-1721-USE-4


https://solutionexchange.vmware.com/store/products/vmware-vrealize-code-stream-management-pack-for-it-devops--2

https://solutionexchange.vmware.com/store/products/vmware-vrealize-code-stream-management-pack-for-it-devops--2

ConclusionThank you for participating in the VMware Hands-on Labs. Be sure to visithttp://hol.vmware.com/ to continue your lab experience online.

Lab SKU: HOL-1721-USE-4

Version: 20161024-104338

HOL-1721-USE-4


http://hol.vmware.com/

Date post:	13-Feb-2017
Category:	Documents
Upload:	phungnga
View:	248 times
Download:	1 times

Configure Install Website Task

Documents