Menu
AWS CodeStar
User Guide

Use Eclipse with AWS CodeStar

You can use Eclipse to make code changes and develop software in an AWS CodeStar project. You can edit your AWS CodeStar project code with Eclipse and then commit and push your changes to the source repository for the AWS CodeStar project.

Note

The information in this topic applies only to AWS CodeStar projects that store their source code in AWS CodeCommit. If your AWS CodeStar project stores its source code in GitHub, you can use a tool such as EGit for Eclipse. For more information, see the EGit website and EGit Documentation on the EGit website.

If the AWS CodeStar project stores its source code in AWS CodeCommit, you must install a version of the AWS Toolkit for Eclipse that supports AWS CodeStar. You must also be a member of the AWS CodeStar project team with the owner or contributor role.

To use Eclipse, you'll also need:

  • An IAM user that has been added to an AWS CodeStar project as a team member.

  • If the AWS CodeStar project stores its source code in AWS CodeCommit, Git credentials (user name and password) for the IAM user.

  • Sufficient permissions to install Eclipse and the AWS Toolkit for Eclipse on your local computer.

Step 1: Install AWS Toolkit for Eclipse

The Toolkit for Eclipse is a software package you can add to Eclipse. It is installed and managed in the same way as other software packages in Eclipse. The AWS CodeStar toolkit is included as part of the Toolkit for Eclipse.

To install the Toolkit for Eclipse with the AWS CodeStar module

  1. Install Eclipse on your local computer if you don't have a supported version already installed. Supported versions of Eclipse include Luna, Mars, and Neon.

  2. Download and install the Toolkit for Eclipse. For more information, see the AWS Toolkit for Eclipse Getting Started Guide.

  3. In Eclipse, choose Help, and then choose Install New Software.

  4. In Available Software, choose Add.

  5. In Add Repository, choose Archive, browse to the location where you saved the .zip file, and open the file. Leave Name blank, and then choose OK.

  6. In Available Software, choose Select all to select both AWS Core Management Tools and Developer Tools, and then choose Next.

  7. In Install Details, choose Next.

  8. In Review Licenses, review the license agreements. If you agree, choose I accept the terms of the license agreement and choose Finish. Restart Eclipse.

Step 2: Import Your AWS CodeStar Project to Eclipse

After you have installed the Toolkit for Eclipse, you can import AWS CodeStar projects and edit, commit, and push code from the IDE.

Note

You can add multiple AWS CodeStar projects to a single workspace in Eclipse, but if you do, you must update your project credentials when you change from one project to another.

To import an AWS CodeStar project

  1. Open the drop-down menu on the AWS toolbar icon and choose Import AWS CodeStar Project. Alternatively, choose File, and then choose Import. In Select, expand AWS, and then choose AWS CodeStar Project.

    Choose Next.

  2. In AWS CodeStar Project Selection, choose your AWS profile and the region where the AWS CodeStar project is hosted. If you do not have an AWS profile configured with an access key and secret key on your computer, choose Configure AWS accounts and follow the instructions.

    In Select AWS CodeStar project and repository, choose your AWS CodeStar project from the list. In Configure Git credentials, provide the user name and password you generated for access to the project's repository. (If you don't have Git credentials, see Getting Started.) Choose Next.

    
                    Choosing an AWS CodeStar project in Eclipse
  3. All branches of the project's repository are selected by default. If you don't want to import one or more branches, clear the boxes, and then choose Next.

  4. In Local Destination, choose a destination where the import wizard will create the local repo on your computer, and then choose Finish.

  5. In Project Explorer, expand the project tree to browse the files in the AWS CodeStar project.

Step 3: Edit AWS CodeStar Project Code in Eclipse

After you have imported an AWS CodeStar project into an Eclipse workspace, you can edit the code for the project, save your changes, and commit and push your code to the source repository for the project. This is the same process you follow for any Git repository using the EGit plugin for Eclipse. For more information, see the EGit User Guide.

To edit project code and make your first commit to the source repository for an AWS CodeStar project

  1. In Project Explorer, expand the project tree to browse the files in the AWS CodeStar project.

  2. Edit one or more code files and save your changes.

  3. When you are ready to commit your changes, open the context menu for that file, choose Team, and then choose Commit.

    You can skip this step if you have the Git Staging window already open in your project view.

  4. In the Git Staging window, stage your changes by moving modified files into Staged Changes. Type a commit message in Commit Message, and then choose Commit and Push.

    
                    Pushing a change to an AWS CodeStar project in Eclipse

To view the deployment of your code changes, return to the dashboard for your project. For more information, see Step 3: View Your Project.