Knowledge Base/Engine Yard Using the Windows Azure Store/Engine Yard for Azure Store: Get Started

Engine Yard for Azure: Deploy Your Application

Keri Meredith
posted this on July 17, 2013 09:28 PM

Updated: January 21st, 2014

Deploy your application on Engine Yard using the Windows Azure Store

This document describes how to deploy your application on Engine Yard using the Windows Azure Store:

Prerequisites

Before you deploy your app on Engine Yard for Windows Azure, you must:

  • Log in through Windows Azure, then navigate to Azure_Manage.png the Engine Yard add-on. (You cannot go directly to Engine Yard at this time.)
  • Have successfully connected your Windows Azure subscription to Engine Yard, as described in Get Started with Engine Yard for Windows Azure.

Create a new environment

You'll need to create your pre-defined application environment first. An environment is a container for your Engine Yard project clusters, which provides a way of organizing your Windows Azure servers (VMs) into logical groups.

To create your app environment

  1. Enter a unique name without spaces. It's a good idea to include the application name and role. For example, MyAppProduction or MyAppStaging. Valid characters are: alpha, numeric, underscores.

    EY_AddCreate_Environment.png

  2. Enter the GitHub repository location so your application code can be accessed by Engine Yard.

    If this is your first trial, you can use git://github.com/engineyard/todo.git as a demo application.

  3. Click Create Environment.

Add a deploy key

If your code is in a private GitHub repository, you need to cut/paste the deploy key to provide Engine Yard access rights to deploy your app.

To give Engine Yard deploy access to your application

  1. If your code is not in a private GitHub repository, click Done! Continue to my Environment.

    You are ready to update the configuration; continue to the next section.

  2. (Optional) If you have a secure repository, copy the key provided:

    EY_AddDeployKey.png

  3. Add the key to your target repo's settings page. See Managing Deploy Keys on GitHub for more information.

    Note: Engine Yard took care of Step one, generating the key for you.

Update the configuration

Engine Yard for Windows Azure organizes your servers into clusters, by type:

Before you deploy your application, you'll need to ensure that all servers (Windows Azure VMs) have been provisioned, and all server software is up to date.

Note: this process can take up to 20 minutes.

To update the clusters

  1. Click EY_UpdateClustersButton.png

    The page indicates the update is in progress with visual indicators:

    EY_UpdatingInProgress.png

    Note: this process can take up to 20 minutes, depending on the number of servers that need updating.

    Once the update completes, the Update Clusters and Deploy buttons become available again.

  2. If an error occurs, visual indicators appear red with the error message:

    EY_UpdatingErrorMessage.png

  3. Correct any errors and repeat the steps if necessary.
  4. When all clusters appear with a EY_GreenCheckMark.png next to each server, you are ready to deploy; continue to the next section.

Deploy your application

Once you have successfully updated the clusters, you are ready to deploy your app. When you click deploy, Engine Yard gets the latest code and then deploys it so you can run your application in the cloud.

To deploy your application with Engine Yard for Windows Azure

  1. Verify that the clusters are all up to date. Every server should have a green status:

    EY_UpdatedGreen.png

  2. Click EY_DeployButton.png

    The page indicates the application code deploy is in progress with visual indicators:

    EY_DeployingInProgress.png

    Note: this process usually takes a minute or two.

    Once the deploy completes, the Update Clusters and Deploy buttons become available again.

    EY_DeployComplete.png

  3. Correct any errors and repeat the steps if necessary.
  4. When the blue deploy bar is no longer visible, and all clusters appear with a EY_GreenCheckMark.png next to each server, your application is available on the cloud; continue to the next section.

Verify Engine Yard for Windows Azure

The best way to verify your deploy is to visit your running application.

To verify Engine Yard for Windows Azure

  1. Navigate to the load balancer cluster.
  2. Click the link for one of the load balancers to visit your live cloud app:

    EY_LoadBalancerVisitLiveApp.png

    Your application should appear.

  3. If your application does not appear, review the Update the configuration and Deploy your application sections. If you are still having trouble, contact Engine Yard Support.

More information

This table provides other resources related to deploying Engine Yard for Windows Azure.

For more information about...See...
Onboarding process Get Started with Engine Yard for Windows Azure
All the docs Engine Yard for Windows Azure documentation

If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.