Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
.ebextensions
src/httpserver
.gitignore
Buildfile
Dockerfile
Jenkinsfile
Makefile
Manifest.txt
Procfile
README.md
runTest.sh

README.md

Quickstart for debugging Java + AWS Elastic Beanstalk

A sample application for debugging Java + AWS Elastic Beanstalk using Rookout.

Before following this guide we recommend reading the basic Java + Rookout guide.

Adding Rookout to an existing EBS Project

To integrate Rookout into your existing java beanstalk application follow these steps:

  1. Add the source files to your built .jar file.

  2. Add these .ebextensions standalone config scripts to your project configuration.

    • sets up and runs Rook, allowing instrumentation and real time fetching of debug messages.

The process is described here : Rookout Integration Process

Running locally

  1. Compile the project jar and download the Java Agent:

    $ make build
  2. Run the application:

    $ make run
  3. Make sure everything worked: http://localhost:7000/?fname=rook&lname=out

  4. Go to http://app.rookout.com and start debugging!

Running on AWS Elastic Beanstalk

  1. Zip the project (the files, not the parent directory), use this command in the project directory to include all hidden files:

    $ zip -r <DEST_FILE.zip> * .*
  2. Upload the source bundle when creating a new Beanstalk app.

  3. Choose 'Java' Platform.

  4. Upload the zip you previously archived in the base configuration part.

  5. Make sure everything worked by accessing the url provided by Elastic Beanstalk after build completed.

  6. Go to http://app.rookout.com and start debugging!

Rookout Integration Process

We have added Rookout to the original project by:

  1. Adding sources to the project jar when building:

    jar cvfm target/server.jar Manifest.txt -C output/ . src/*
  2. Adding Rookout's Elastic Beanstalk .ebextensions to setup the Rookout Java Agent:

    files:
        "/opt/elasticbeanstalk/lib/rook.jar" :
            mode: "000444"
            owner: root
            group: root
            source: "http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.rookout&a=rook&v=LATEST"
    option_settings:
        aws:elasticbeanstalk:application:environment:
            JAVA_TOOL_OPTIONS: '-javaagent:/opt/elasticbeanstalk/lib/rook.jar'
            ROOKOUT_TOKEN: '<your-token>' //Add your token here
    
You can’t perform that action at this time.