Skip to content

Latest commit

 

History

History
32 lines (22 loc) · 1.93 KB

README.md

File metadata and controls

32 lines (22 loc) · 1.93 KB
Raw

minecraft-ondemand-terraform

Terraform implementation of https://github.com/doctorray117/minecraft-ondemand

Prerequisites

  • Terraform 1.0 (Terraform 0.13 and later likely to work, untested). This README assumes you have basic knowledge of Terraform.
  • A domain under your control, DNS servers must be changeable
  • An AWS account that you have admin access over
  • Optionally, an email address to receive "Server started" and "Server Stopped" notifications

Running

Set up authentication with your AWS account using your preferred method from this doc: Authentication Using the Static Credentials method requires changing the provider definition in terraform/provider.tf.

From the terraform directory, run terraform plan and terraform apply. You have to provide values to the following vars:

  • aws_region: The AWS region to deploy the Minecraft server in
  • domain_name : The domain your server will run under
  • domain_name : The domain your server will run under
  • sns_notification_email : The email address where you will receive notifications You can input these from the command line or through a tfvars file.

Note the hosted_zone_nameservers output from terraform apply. Apply these DNS server addresses to your domain.

Your sns_notification_email should have received a confirmation email from AWS. Follow the link in it to enable email notifications.

If everything worked correctly, trying to resolve minecraft.${DOMAIN_NAME} should start the server. This might take 5-10 minutes on the first run. The server should then be reachable at minecraft.${DOMAIN_NAME}.

Caveats

  • Limited testing done so far.
  • Twilio SMS notifications are not supported.
  • At this time terraform destroy is not guaranteed to work cleanly in a reliable manner.