DocsPipelines for ApplicationsServers
Set up an AWS EC2 instance

Set Up an Amazon Web Service EC2



Amazon Elastic Compute Cloud (EC2) is a virtual server that can be scaled up and down to meet app traffic demands. This tutorial walks through the steps to configure and launch AWS EC2 Instance.

To complete this tutorial, you need register a free account with AWS (the AWS Free-Tier gives you access to AWS’s basic services, which are sufficient to complete this tutorial), and Pipelines. Save your login credentials as you will need them for this tutorial.

Step 1. Create key pairs

Amazon EC2 uses public–key cryptography to encrypt and decrypt login information and we will have to create a Key Pair to log into our instance.

  1. Navigate to the AWS Console, then click on EC2.
  2. AWS EC2
  3. On the left pane, click on Key Pairs, then click on Create Key Pair
  4. EC2 Key Pairs
  5. Enter a name for your key, then click Create. The Key Pair will be automatically downloaded. You should move this key to a perminent location.
  6. To use SSH client on Mac or Linux you will need to change the permissions of this key to ready-only.
chmod 400 youKeyName.pem

Step 2. Create a security group

Security Group is a traffic control layer to your instance. You can specify which IP address is welcome for a particular protocal. For example, HTTP and SSH.

  1. Navigate to the left pane of your EC2, and click on Security Groups, then click Create Security Group.
  2. EC2 Key Pairs
  3. Fill out the **Security group name** and give it a **Description**. On the **Inbound** tab, click **Add Rules** create the following 3 rules:
  • Rule 1. Seletect HTTP under Type, make sure Source is set to *Anywhere.
  • Rule 2. Select HTTPS, make sure Source is set to Anywhere.
  • Rule 3. Select SSH, make sure Source is set to My IP.

EC2 Key Pairs

Step 3. Launching an EC2 instance

We are now ready to launch our EC2 instance. There are only a few steps left until your EC2 instance is up and running and ready for code to be deployed!

  1. On the left pane, click on EC2 Dashboard, then click on Launch Instance
  2. EC2 Dashboard
  3. Choose your server operating system and proceed.
  4. EC2 Dashboard
  5. Select Configure Security Group on top of the page.
  6. Check the option Select an existing security group, then seleted the name of your group.
  7. EC2 Instance Security Group
  8. Click Review and Launch.
  9. Click Launch. Select the key pair you created, then select Launch Instances.

EC2 Launch Instances

To make sure you have successfully launched your instance, navigate to the left pane of the EC2 page, and click on Instances. Check out Instance State, and make sure that it is running. You will need your instance IP address to connect to your instance. Your instance IP address can be found in the instance’s details. Refer to the image below:

EC2 Instance Details

Step 4. Connect to EC2 instance

With your running instance, let’s connect to your it using SSH.

  1. Open your terminal. Navigate to the directory where your Key Pairs are saved. Enter this command:
  1. Enter the following command to update your instance:
sudo apt-get update 

Congratulations, you now have access your server!

Step 5. Install the Pipelines agent

The Pipelines agent facilitates the auto deploy process. Install the Pipelines agent with the following command:

Linux and macOS X

To install on Linux or macOS X you can use either curl or wget with one of the following syntaxes.

wget example

wget -qO- | sh

curl example

curl -sSL | sh


To install on Windows, copy and paste the following PowerShell command into a command (cmd) window.

powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString(''))" & SET PATH=%PATH%;%ProgramFiles%/Distelli

Complete the install

After downloading the agent, you must run the install command to install the agent. To do so use the agent install command.

Note: This installation requires root (administrator) permissions.

jdoe@ServerB:~$ <b>wget -qO- | sh</b>
This script requires superuser privileges to install packages
Please enter your password at the sudo prompt

[sudo] password for jdoe:
    Installing Distelli CLI 3.55 for architecture 'Linux-x86_64'...
To install the agent, run:
    sudo /usr/local/bin/distelli agent install
jdoe@ServerB:~$ <b>sudo /usr/local/bin/distelli agent install</b>
Distelli Email: <b></b>
    1: User: jdoe
    2: Team: janedoe/teamjane
Team [2]: <b>1</b>
Server Info:
Starting upstart daemon with name:  dtk-supervise-cc1233c06f7ad94a8d34ac610381242f9ae28bb8

Verify the install

To validate the agent is installed and working use the agent status command.

/usr/local/bin/distelli agent status
Distelli Agent (serverA) is Running with id 766b88c8-e925-11e4-ae8b-080027cc07f7

Step 6. Add the new instance to Pipelines

You installed the Pipelines agent to your server. The agent will allow Pipelines to communicate with your server, and facilitate the auto deploy process. Let’s add the server to Pipelines.

  1. Login to your Pipelines account
  2. At the top menu, click Servers
  3. In the top right on the page, click Add Server
  4. Click Add existing server
  5. Next, click Install complete since you have already installed the Pipelines Agent.
  6. In step 3 of adding server, Pipelines makes connection with the Pipelines Agent. In the final step of the process, select BETA environment, then click Add Environments.

Note: You can save this EC2 instance as an Amazon Machine Image. This will allow you to launch identical EC2 instances without going through the entire set up process.

Step 7. Deploy your application

Now that our AWS EC2 Instance is launched and the Pipelines agent is installed on our server, we are now ready to deploy our application. See the Deployment tutorials section for information on deployments.

How helpful was this page?
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.