Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Blueprints assist users with creating FlexDeploy projects and the associated configuration, accelerating the journey to the ultimate goal - building  building and deploying software! A blueprint has the understanding of the end goal, and gathers the information necessary to auto-generate the underlying componentry.  

Whether you use a blueprint or create objects by hand the componentry is the same.  The underlying components consist of a Topology definition, build and deploy workflows, a source code repository connection, and a project definition.  Blueprints provide a jump start to get something working quickly, and letting you come back later to enrich and extend.  In that spirit, blueprints default many properties and configure a single deployment target - Development.

You can launch utilize Blueprints by clicking on the Image Removed icon in the FlexDeploy header.  To accessing the create new project screen in FlexDeploy.  To create a project, complete the 5 simple steps in the wizard.

Step 1 - Select a Blueprint

...

Enter the Blueprint properties and Project Information and select the Build and Deploy options

Image Removed

On the right hand side you will see a summary of the choices made and meta data that will be created. At the bottom of the summary you will find the navigation control. After filling out your Blueprint Properties, click Continue.

Image Removedif applicable.

...

Step 2 - Where is your source code?

Select Below the Project Information section, select the Source Control Management System

Image Removed

...

titlePreferred Source Control

...

for the project.

...

Info
title

Using Git

Checkout Tips and Tricks for deeper Git Integration


If In the Source Repository dropdown, if you have already created a connection to your source code repository, select it.

Image Removed

...

To make a new repository connection.  Enter the connection details and click Done.

Image Removed

...

titleValidate Connection

...

, select + Create new Source Repository in the dropdown.

In the Create Source Control Repository popup, select desired Source Control Type and fill in all required properties to make a connect to your repository. 

...

Tip

Validate Connection

When creating a new repository connection, click the TEST CONNECTION button to ensure FlexDeploy can connect to your repository using the supplied parameters. 

Enter the project configuration for the selected repository.  This information further helps identifies the location of the source code within the select repository.

 Image Removed

...

properties. 

Step 3 - Gather Build information

This step will collect any environment specific build properties, and identify which endpoint to execute on.Image Removed

...

Enter values for any workflow properties which are required for the build.  In the image above, no properties are one property is required for this build.  Select the target

For some Blueprints, specific endpoints will be required, showing theImage Addedicon next to it. Otherwise, select the desired endpoint that this build should execute on from the drop down, or click the Image Removed icon to create a new one within the dropdown. Image Removed

...

Tip
titleExisting Endpoint

If an Endpoint already exists for the build instance, it will be selected automatically (and it cannot be changed).  A message will be displayed at the bottom of the Build Endpoint section similar to the following.

Image Removed

...

Validate Connection

When creating a new endpoint, click the TEST CONNECTION button to ensure FlexDeploy can connect to your endpoint using the supplied parameters

Step 4 - Gather Deployment information

This step will collect any environment specific deployment properties, and identify which endpoint to execute on.

Tip
title

Development Environment Only

Keep in mind that the focus of the Blueprint is to get something working quickly.  With that in mind, the blueprint collects information for the Development environment only. You can map and configure as many environments as you wish later.

...

Enter values for any workflow properties which are required for deployment into the Development environment.  In the image above, several properties are required for this deployment.  Select the target   

Similar to build, specific endpoints may be required, showing theImage Addedicon next to it. Otherwise, select the desired endpoint that this deployment deploy should execute on from the drop down, or click the Image Removed icon to create a new one .

Image Removed

Tip
titleExisting Endpoint

If an Endpoint already exists for the target Development instance or if the Blueprint is configured to use the same endpoint as selected during Build, it will be selected automatically (and it cannot be changed).  A message will be displayed within the Development Endpoint section similar to one of the following.

Image Removed

Image Removed

Click Next arrow in the left navigationwithin the dropdown

Step 5 - Final Review

The final step is to review the information and generate the project and supporting components.   The project name and project location are derived based on other information provided, but can be changed upon final review if desired.  You can see the source code repository and the source code location that has been selected for the project, the build and deploy workflows that will be created or linked, and the build and deploy environments and instances that will be created or linked within the topology.

Image Removed

Click the Create button to start creating the project. A popup will appear with the results and a link taking you to the project.

Once ready, select the SAVE button at the bottom of the page to create the project. On creation, you will be redirected to the project's page.

...

Summary

The Blueprint creates the Topology configuration, the build and deploy workflows, the source code repository connection, the project, and the linkages between them.  

TopologyImage Removed

...

Source Code Repository Connecton (SCM Instance)Image Removed

...

Workflows

Image Removed

...

Project

Image Removed

...