Knowledge Base

Add a connection to Amazon Web Services EC2 cloud

To create a new connection to Amazon Web Services EC2 infrastructure from Deploy4Me you can do the following:

  1. Start a new project or select an existing one
  2. Click continue to see the Connect to Cloud screen
  3. Click button Amazon EC2
  4. Fill the parameters in the New Connection form

    Add new AWS EC2 connection in Deploy4Me
    Fig. 1: Add new AWS EC2 connection in Deploy4Me

  5. Click continue

To allow Deploy4Me work with Amazon EC2 you need to know:

  1. Access Key ID
  2. Secret Access Key
  3. Region by default
  4. Name of the connection (defined by yourself. Just some description for future use)

No other information is required.

Note that for security reasons you cannot edit the connection parameters once it's created (apart from the name). To edit the connection you can delete the existing and add a new one with the new parameters.

Get the Connection Parameters

1. Access Key ID and Secret Access Key

To get the Access Key ID and Secret Access Key from your AWS account:

  1. Click on Account Name
  2. Select Security Credential

    Security Credentials menu in Amazon EC2
    Fig. 2: Security Credentials menu in Amazon EC2

  3. If it is your first visit to the security credentials page you will see the popup window. Select Continue to Security Credentials

    The Continue to Security Credentials popup
    Fig. 3: The Continue to Security Credentials popup

  4. You now should see Your Security Credentials page. Select Access Keys (Access Key ID and Secret Access Key)

    Amazon EC2 Your Security Credentials page
    Fig. 4: Amazon EC2 Your Security Credentials page

  5. Click the button Create New Access Key

    Create a new Access Key
    Fig. 5: Create a new Access Key

  6. In the dialogue Create Access Key click the button Download Key File
Note that if the Create New Access Key button is not active then you already reached the limit the maximum of available active keys. You can have a maximum of two access keys (active or inactive) at a time. If this is the case we recommend to use the existing key. Otherwise you can deactivate or delete one of the existing keys. Make sure you know what to expect before deleting any keys.

Access Key ID and Secret Access Key are global and fits to all regions.

2. Connection Name

Use any name for a connection (or keep default). This name will be displayed in Existing connections. It can be changed any time.

Editing of the existing connection
Fig. 6: Editing of the existing connection

3. Region by default

When you add a server to the project it will be placed in one of the regions where AWS have a data center. Region by default allows you set it once and do not configure it for each server individually.

You still have an ability to change the region for each server, but the default one will be used for all new servers.

Tip: If you create the distributed architecture with different regions you can create multiple connections having different default regions. This works for the same AWS cloud as well.

On the deployment of the project you can find your servers in the specific region in Amazon EC2. Just open your EC2 console and select the region.

Region selection in Amazon EC2
Fig. 7: Region selection in Amazon EC2

Save the connection using Continue button

Once you have found all parameters and paste in the New Connection form you can click Continue.

The filled form for a new connection to Amazon EC2 cloud
Fig. 8: The filled form for a new connection to Amazon EC2 cloud

The Continue button will save your connection and start the connection check. If all parameters are entered correctly the wizard shows you the next step. Successful check confirmation will be on a screen.

Connection successful check confirmation
Fig. 9: Connection successful check confirmation

Deploy4Me allows you to deploy the software on if connection is valid.