Getting started - Deployment Manager

With Deployment Manager, you can automate software deployments into development, test, staging and production environments.

To get started, do the following:

1. Download Deployment Manager

You can download DeploymentManager.zip from here.

The zip file contains two installers:

• DeploymentManager
• DeploymentAgent

2. Install the Deployment Manager server

On the server you want to use to host the Deployment Manager web interface, run the DeploymentManager installer.

View a list of requirements for the Deployment Manager server

Follow the instructions to complete the installation. For more information, see: Installing Deployment Manager.

An administration application is displayed when the installation is complete:

In the administration application, specify the port you want to use for the Deployment Manager web interface, and then click Use This Port.

You're now ready to browse to the Deployment Manager web interface. You can find the URL for the web interface in the administration application:

If you encounter a problem viewing the web interface, see: Common errors.

3. Create an administrator user

The first time you visit the web interface, you must create an administrator user account:

Enter details for the administrator, and click Create account.

4. Install the Agent service on your target machines

Next, install the Agent service on the machines you want to deploy to. On each of the machines you want to deploy to, run the DeploymentAgent installer.

View a list of requirements for a target machine

Follow the instructions to complete the installation. For more information, see: Installing an Agent.

An administration application is displayed when the installation is complete. If you encounter a problem launching the Agent administration application, see: Common errors.

To install and start the Agent service, in the administration application, on the Service tab, click Install:

5. Add your target machines to the web interface

Now that the Agent service is running on your target machine(s), you can add them to the web interface.

In Deployment Manager, you add a machine to an environment. For example, this allows you to group several machines as Development, Staging or Production.

To add an environment:

1. On the Environments tab, on the menu bar, click Add environment:

   

2. Enter a name for the environment, and click Create.

To add a machine:

1. On the environment bar, click Add machine:

   

2. Enter the name and URL of the machine you want to deploy to.
3. In the Key box, paste the Agent key from the Agent administration application:

   

4. In the Agent administration application, on the Security tab, under Server Keys, click Add:

   

5. In the Key box, paste the Deployment Manager server key:

   

6. Click Save.
7. On the Service tab, click Restart to restart the Agent service:

   

More information on adding target machines to Deployment Manager

6. Add a NuGet package repository

Next, you need to add a NuGet package repository to allow Deployment Manager to download the packages you want to deploy:

1. In the Deployment Manager web interface, click Settings.
2. Click Package repositories:

   

3. Click Add NuGet package repository:

   

4. Enter details for the repository, and click Add.

More information on NuGet package repositories

7. Create a project

Once you've added the machines you want to deploy to and a NuGet package repository, you need to create a project.

Projects contain the deployment steps you want Deployment Manager to perform.

To create a new project:

1. On the Projects tab, click Create project:

   

2. Enter a name for the project, and click Add.

To add deployment steps to a project:

1. In the Project list, click your project:

   

2. On the Steps page, click Add package step:

   

3. Specify the NuGet package you want to deploy, add the environments you want to deploy to, and then click Add.

8. Create and deploy a release

Next, create a release:

1. On the Releases page, click Create release:

   

2. Enter a version number for the release, select the version of the package you want to deploy, and then click Create release.

   You can now deploy the release:

3. On the page for the release you want to deploy, on the menu bar, click Deploy this release:

   

4. Select the environment you want to deploy to, add any comments you want, and click Deploy release.

   Deployment Manager executes the deployment, and displays output logging information:

   

You've now deployed your first release with Deployment Manager.