Welcome Gophers!

This repo has a pretty simple Buffalo app that shows off some things:

• Testing an app
• Buffalo resources
• Running DBs locally in Docker
• Doing stuff with the Database
• Deploying a Docker image

Getting Started & Developing Locally

You'll need Docker, Docker Compose and Buffalo installed. After you have that, getting started is pretty quick.

First, install Go dependencies with dep:

dep ensure

Then, start up the app:

make dev
buffalo dev

Deploying to the Interwebs

To deploy to ACI:

az container create \
	-n hd \
	-g ${RESOURCE_GROUP} \
	--image arschles/hd \
	--ip-address public \
	--ports 3000 \
	-e "GO_ENV=production" "DATABASE_URL=${DATABASE_URL}"

Notes:

• you can substitute arschles/hd with your own image name.
• DATABASE_URL should be something like this: postgres://${DB_USERNAME}:${DATABASE_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}?sslmode=require (DB_PORT is usually 5432)

The stuff below is Buffalo's boilerplate readme.

Database Setup

It looks like you chose to set up your application using a postgres database! Fantastic!

The first thing you need to do is open up the "database.yml" file and edit it to use the correct usernames, passwords, hosts, etc... that are appropriate for your environment.

You will also need to make sure that you start/install the database of your choice. Buffalo won't install and start postgres for you.

Create Your Databases

Ok, so you've edited the "database.yml" file and started postgres, now Buffalo can create the databases in that file for you:

$ buffalo db create -a

Starting the Application

Buffalo ships with a command that will watch your application and automatically rebuild the Go binary and any assets for you. To do that run the "buffalo dev" command:

$ buffalo dev

If you point your browser to http://127.0.0.1:3000 you should see a "Welcome to Buffalo!" page.

Congratulations! You now have your Buffalo application up and running.

What Next?

We recommend you heading over to http://gobuffalo.io and reviewing all of the great documentation there.

Good luck!

Powered by Buffalo