Setup your environment

How to set up your development environment to work on an Atura project.

Requirements:

Visual Studio 2017
Currently using version 15.9.5 at the time of writing.

RazorGenerator
We use this to embed client-specific HTML in a client-specific DLL. Install as a Visual Studio extension.

Git
Source control. We use "Git Extensions" to access our source code repos in BitBucket, but any git tool will do.

Bot Framework Emulator
The team currently uses the latest v3 Emulator as their preferred version. Once the Atura SDK has migrated to v4, the latest v4 Emulator should be used in accordance.

Node
This will be required for building and running the web chat and dashboard locally – currently using version 8.11.3.

npm
Requires node to be able to install the required packages to leverage the Atura sdk. Once you have the correct version of Node installed, simply run the command below in command prompt from the project folder "../{repository}/{project}/{botname}/"

Note: the packages.json will need to be in here in order to download and restore the correct node modules.

npm install

New environment creation in Azure

We will use scripts to create your environment in Azure. Components include:

• New AzureAD tenant for your dashboard users.
• Resource groups, one per environment (Eg. dev/qa/prod)
• Various app services and databases needed.
• Service Bus.
• Azure function app.

We will give you access to these resource groups in Azure, so that you can monitor and configure the environments as necessary.

Currently the bot and dashboard runs as Azure App Services, but there are plans to move to Kubernetes in future.

Continuous deployment configuration in VSTS

We will configure build and release steps to deploy Atura to your Azure environments. We will give you access to trigger these releases.

• Build/Release templates
• Service principals
• Connection strings