habitat-sh/national-parks

An example of packaging a Tomcat / MongoDB application in Habitat

National-Parks Habitat Demo

Build a map of all the United States national parks using Habitat! Build, deploy, and manage the application to any cloud, virtual machine, or container.

With this demo, you'll discover the magical space-cats living inside of Habitat, and learn the power of packaging, shipping, and updating applications in one atomic format.

Build

You can build the application by simply installing Habitat on your workstation and using the Habitat Studio.

1. Clone the repo.
2. cd national-parks
3. hab studio enter
4. build

Watch as the application builds! It should take a few minutes.

If you're showing this as a demo to others, this is a good time to talk about the plan.sh and show how it relates to the build process.

Export to Docker

Ready to see what the app looks like on your local workstation with Docker?

Inside the Studio, run:

1. hab pkg export docker path/to/build.hart

Now you'll have a Docker container on your local workstation.

2. Modify national-parks/docker-compose.yml to match your origin.

   national-parks:
    image: myorigin/national-parks

3. docker-compose up

4. Browse to http://localhost:8081/national-parks to see the app.

Provision AWS

Let's show the app in AWS using Terraform!

1. Install Terraform

2. Create a terraform.tfvars in the national-parks/terraform/aws directory. An example is provided for you at national-parks/terraform/aws/example.tfvars

3. cd national-parks/terraform/aws

4. terraform init

5. terraform plan

6. terraform apply -auto-approve

7. Browse to the URL output by Terraform for you.

Update the app

Let's update the appliation with some brand new colors to make a new version.

1. Modify src/main/webapp/index.html by replacing it with the contents of index.html.new. You can revert and show a rollback too, by using index.html.old.

2. Rebuild the app in the Habitat Studio.

3. Re-export the container, or upload the new package to builder.

national-parks's Issues

Workshop instances missing required tags

Per CHEF standards: https://app.getguru.com/#/facts/f3b15b56-ec7d-4b76-8b68-b1182928adb8

Instance reaping is in the process of being expanded. These instances will be reaped if they are not configured with the required tags.

National Parks map comes up blank in Azure deployments

When spinning up a stack in Azure, the stack completes successfully, but hitting the front end the map is blank rather than having pin drops for each park. You can get around this by sshing to the mongo host and unloading the loading the mongo package again.

Azure RG name conflict

The default Azure RG name is "${var.application}-rg". This is very generic and will produce conflicts (e.g. if tf misbehaves or if multiple users attempt to spin this up at once).

Suggest moving this to `"${var.application}-${var.habitat_origin}-rg" to generate unique RG names on at least a per-user basis.

terraform for AWS fails to reliably provision

Many folks (me, @ericcalabretta, @galenemery, and others) routinely have tf apply fail when run for AWS. A full log file is attached from my most recent attempt, but we can gather others as well. Additionally, let me know if there are other logs I should gather.

tf-aws.log

When using the terraform-native habitat provisioner, there are no issues. It works every time.

CC / @echohack @smford22