AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Getting Set Up

AWS DevTools is a Git client extension that enables you to deploy applications to AWS Elastic Beanstalk quickly. This section describes the prerequisites for running AWS DevTools, where to get it, and how to set it up. For an example of how to configure your Git environment and deploy your AWS Elastic Beanstalk application using AWS DevTools, see Develop, Test, and Deploy.

Linux/Unix and Mac

The AWS DevTools works on Linux, Unix, and Mac OS X operating systems. This document assumes you can work in one of these environments. You can set up AWS DevTools in a few basic steps:

  • Install the prerequisite software

  • Download AWS DevTools

  • Create a Git repository directory

  • Run the AWS DevTools setup script

To set up AWS DevTools on a Linux/Unix or Mac computer

  1. Install the following software on to your local computer:

    • Git. To download Git, go to http://git-scm.com/. Make sure you have at least version 1.6.6 or later.

      To verify if Git is already installed, type the following command at the command prompt:

      git

      If Git is installed, you should get a list of the most commonly used commands.

    • Ruby version 1.8.7 or later. To view and download Ruby clients, go to http://www.ruby-lang.org/en/.

      To verify if Ruby is already installed, type the following command at the command prompt:

      ruby -v

      If Ruby responds, and if it shows a version number at or above 1.8.7, then you have the correct version installed.

  2. Download AWS DevTools, which is part of the command line interface package, at the AWS Sample Code & Libraries website. Simply download the .zip file, and unzip it to a directory on your local machine.

  3. If you haven't already set up a Git repository, you'll need to first create one. If you have an application in a directory, you can change to that directory and then type the following command to initialize your Git repository.

    git init .
  4. From your Git repository directory, run AWSDevTools-RepositorySetup.sh. You can find AWSDevTools-RepositorySetup.sh in the AWS DevTools/Linux directory. You need to run this script for each Git repository.

    To learn how to create and deploy an application using AWS DevTools, see AWS DevTools.

Windows

The AWS DevTools works on Windows operating systems. This document assumes you can work in a Windows environment. You can set up AWS DevTools in a few basic steps:

  • Install the prerequisite software

  • Download AWS DevTools

  • Run the setup script

  • Create a Git repository directory

  • Run the repository setup script

To set up AWS DevTools on a Windows computer

  1. Install the following prerequisites:

    Note

    You can check Control Panel | Programs | Programs and Features to verify if you have previously installed these applications.

  2. Download AWS DevTools, which is part of the command line interface package, at the AWS Sample Code & Libraries website. Simply download the .zip file, and unzip it to a directory on your local machine.

  3. Double-click AWSDevTools-OneTimeSetup.bat. You can find AWSDevTools-OneTimeSetup.bat in the AWS DevTools/Windows directory. The setup script installs all of the necessary pieces for pushing AWS Elastic Beanstalk applications. You need to run this setup script only once.

  4. If you haven't already set up a Git repository, you'll need to first create one. If you have an application in a directory, you can change to that directory and then type the following command to initialize your Git repository.

    git init .

    Note

    You need to run the PowerShell commands from an environment that has access to Git. If you installed Git as a native Windows program, that would be cmd.exe. If you installed Git wrapped inside Git Bash, that would be Git Bash.

  5. Copy the AWSDevTools-RepositorySetup.bat from the AWS DevTools/Windows directory to your Git repository directory, and then double-click AWSDevTools-RepositorySetup.bat. You need to run this script for each Git repository.

    Note

    If you receive an error, try running the AWSDevTools-OneTimeSetup.bat file again.

    To learn how to create and deploy an application using AWS DevTools, see AWS DevTools.