Skip to content

Latest commit

 

History

History
67 lines (35 loc) · 3.11 KB

README.md

File metadata and controls

67 lines (35 loc) · 3.11 KB

Download Build Status

EC2PushButton

Simple one button touch to start and stop a given EC2 instance.

App Stop

Motivation

This project started with a need to easily start and stop our 7 Days to Die game server. Surprisingly, not everyone wanted to learn how to operate Amazon EC2 instances nor did they want to learn the nuances of Amazon Web Services (AWS) identity and access management (IAM). Consequently this project was born. Given an already created EC2 instance and existing credentials, team members may now start and stop the game server. Stopping is fairly important since we are all not yet strong players and if the server runs unchecked, the zombies would continue to get stronger and more aggressive.

Getting Started

To build this project you will need the following:

  • JDK
  • Maven
  • AWS Account (free tier is ok)

Running

For a historical reason, the EC2 instance ID is set to a default value. You may now view or change the target server instance. This is accessible via the new options menu.

Settings Menu

Clicking on the menu item brings up a properties form containing the instance ID.

Settings Form

Available EC2 instances may be viewed from the EC2 instances menu item.

Instances Form

Prerequisites

A Java runtime environment (JRE) is required. So first navigate to the Java download page and get the latest version for your PC. Note: you must first accept the license agreement. In most cases, choose the 64-bit version.

JRE Download

Java SE Runtime Environment 8 Downloads.

Installing

The first time the application is run, it will prompt for credentials. Currently, an AWS key and secret are the only form of identity that is supported. Enter the key and secret and click on OK.

Login

The Amazon AWS credential store will detect that a new key and secret has been added and ask you to confirm. Click on yes.

Credentials Changed

The app is now ready to start the EC2 instance.

App Start

Windows

Download the Windows executable and place it in a local folder, e.g. C:\Users\tools. Double click on the file name, EC2PushButton-0.5.0.exe to run the app.

Mac and Linux

The application is packaged as an executable JAR. Download it and place it in a local folder. If Java is already installed per the prerequisites then all that is necessary is to double-click on the newly downloaded JAR file. Or if you prefer the command line, use java -jar EC2PushButton-0.5.0.jar.

Acknowledgements

README template from @PurpleBooth.