Configuring Target Machine

Last updated

This guide can be used with an AWS AMI instance of Ubuntu 14.04 LTS or an Azure VM running Ubuntu 14.04 LTS. If you want to use a different base instance there may be some slightly different steps you need to take during the configuration.

Deploying projects over SSH has some slightly different requirements to a standard Tentacle. Although you don't need to install and run a Tentacle service, there is some configuration that is required to allow Calamari to run on non Windows systems.

Install Mono

Authoritative Documention
The best and most up-to-date guide to installing mono will continue to be on the mono website. More detailed instructions can be found on their website which may change in future versions so check their documentation out for more info.

Starting with a fresh instance of Ubuntu 14.04, update the package repository and install mono-complete to get the latest stable version.

sudo apt-key adv --keyserver hkp:// --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
sudo apt-get update
sudo apt-get install mono-complete

Add User

Rather than connecting and deploying your application as the root user, you should create a custom user account that will be used for the purposes of deployment. The login credentials will then be able to be easily revoked without affecting other users who access the machine. Resources will also be able to be more granularly assigned, allowing greater control if the account is used maliciously.

Entire books have been published on the subject of security on Unix based systems. These steps are intended to serve a basic level of security, while making sure you stop and consider the role that it plays in your environment.

In this case we are going to create a simple user account with a password which will be used for both the deployment process and running the application process itself. In your case you may want to use different accounts for each task. Replace  with a random password of your choice and remember this value as it will be needed later when configuring the target on the Octopus Server

sudo useradd -m octopus
echo octopus:<the-password-you-want> | sudo chpasswd

By default the AWS Ubuntu AMI only allows authentication via SSH keys and not password. Although passwords are typically less secure, for the purposes of this guide we are going to enable their use.

Enable password authentication in AWS

sudo sed -i.bak -e s/'PasswordAuthentication no'/'PasswordAuthentication yes'/g /etc/ssh/sshd_config
sudo restart ssh

Install Application Dependencies

In this step we will install NodeJS, npm and pm2 which are required for hosting the sample application.

Your application may have different requirements, and this is the point where you would install all of those dependencies.

Firstly install NodeJS, and then create a symlink as /usr/bin/node so that it can be invoked with the command "node".

sudo apt-get install nodejs
sudo ln -s /usr/bin/nodejs /usr/bin/node

To help manage the web process when it runs on the machine, we will install the pm2 library (which itself is a node module) as a global module. This library is available in the npm repository which will also need to be installed if not already available.

sudo apt-get install npm
sudo npm install pm2 -g