#Installing the Azure DevOps Plugin
##Step 1: Installing
- Open the CloudShell Colony Plugin page in Visual Studio's Marketplace.
- Click Get it free.
- Log in to VisualStudio.com and select the organization that will use this plugin.
NOTE: If you are not the organization’s admin, you may send a request to the admin to install the plugin for you.
Your plugin is now installed.
##Step 2: Configuring the Azure DevOps Plugin
Open your VisualStudio.com project
- Open the Project Settings/Services page
- Click New service connection and select CloudShell Colony.
- To the Connection Name, enter "Colony".
In CloudShell Colony, open the Settings page and click Integrations.
- Under the Azure DevOps icon click Connect Now.
- Copy the automatically generated token.
- Switch back to Azure DevOps Web UI and paste the token into this field.
NOTE: The token value is generated by CloudShell Colony.
- Click Verify connection and make sure the connection succeeds.
#Launching a Sandbox from your Azure DevOps Pipeline
After installing and configuring the Azure DevOps plugin, you can launch sandboxes from your Azure DevOps Pipeline.
Use the available build steps to create a sandbox from any blueprint, retrieve its details, start your tests and end the sandbox when it's no longer needed.
##Preparing the Azure DevOps Build
- Open your visualstudio.com project.
- In the Build and release page, create a new build or edit an existing build.
- Create a New Task in one of your build agent’s jobs.
- In the New Task form search for Cloudshell Colony.
The following tasks are displayed:
- CloudShell Colony End Sandbox (ends a sandbox with CloudShellColony).
- CloudShell Colony Start Sandbox (starts a sandbox with CloudShell Colony).
NOTE: If you do not see above tasks, it means that the plugin was not successfully installed.
##Launching a Sandbox
- Add the CloudShell Colony Start Sandbox task to your pipeline.
- Open the task settings and enter the following parameters:
- Service Connection – Enter "Colony". This is the name of the connection that you entered when you created the Colony service connection during the plugin configuration.
- Timeout- Set the timeout for this step, if your sandbox will not be ready when the timeout is reached, CloudShell Colony will abort the deployment.
- Space name - enter a name for your CloudShell Colony space.
- Blueprint name - Enter the name of the blueprint you would like to use for creating this sandbox.
NOTE: To specify one of CloudShell Colony’s sample blueprints, use a [sample] prefix.