Go (aka Golang) came to life at Google in 2009. It was designed by a few big names: , who had a large hand in the development of the Java Virtual Machine. Robert Griesemer , who holds a U.S. patent for windowing UI systems, helped build the Plan 9 operating system at Bell Labs. (In fact, the mascots and are remarkably similar because Pike’s wife, Renée French, is a renowned illustrator.) Rob Pike for Plan 9 for Golang , who designed and implemented a little thing called Unix. Ken Thompson In this article, we’ll demonstrate how simple it is to build a RESTful web service in Go. Then, we’ll demonstrate how to deploy this application with Heroku. But before we embark on this journey, let’s talk briefly about you might want to use Go. why Why Go? To build a web service in 2024, why would you choose to Go over another language, like Python or TypeScript? Go’s biggest advantage over those two languages is . Go is a compiled-to-machine-code language. It’s not interpreted like Python, Ruby, or JavaScript. It’s not even compiled into bytecode and run on a virtual machine like Java. Lots of benchmarks show Go to be 40x or 50x faster than applications written in interpreted languages. When it comes to speed, Go applications perform similarly to those written in Rust or C++. speed Go has a , often with only one particular way of doing something. This is appealing to many developers, especially any who have ever been in a development team setting, where squabbles over various ways of doing things eat up precious time. This simplicity drives conformity in a codebase and offers less perplexity when the code. (Believe it or not, most developers spend more of their time code rather than writing it.) simple syntax reading reading Go is a young language, so it comes packed with modern features out of the nursery. You get automatic garbage collection like in Java or Python. You get . You get a . And perhaps most beneficial to network programmers: You get an called . built-in linters, formatters, and unit testing rich network stack in the standard library easy-to-use multi-threading toolkit Goroutines Yes, there are some reasons why not everyone is hot on Go. One common complaint revolves around error handling in Go. Functions in Go can return multiple values, one of which is an error code. This hearkens back to the days of C—before exceptions—and feels admittedly archaic. It is easy to forget to check error codes for every function. It’s also tedious to percolate errors from down in the depths—when you awaken a balrog deep inside your application—up to somewhere manageable. You know you’ve done that. Alright, the Go cheerleading is done. Let’s get to building. Building a simple RESTful web service in Go We’ll build a small API service that provides some text operations that applications commonly need, such as: Encode a given string using a basic Caesar Cipher Determine if a string is a palindrome (Perhaps most importantly) SpongeBob-encode a zinging retort. If you’d rather skip ahead to the finished code for this application, you can find it in this . We’re not going to go through line by line, but we’ll talk about the important bits. GitHub repo main.go Let’s start with the main function, the bootstrapping code of the service: func main() {
	http.HandleFunc("/is-palindrome", palindromeHandler)
	http.HandleFunc("/rot13", rot13Handler)
	http.HandleFunc("/spongebob", spongebobHandler)
	http.HandleFunc("/health", healthHandler)

	appPort := ":" + os.Getenv("PORT")
	if appPort == ":" {
		appPort = ":8080"
	}
	err := http.ListenAndServe(appPort, nil)
	if err != nil {
		return
	}
} As we mentioned, one of Go’s powerful features is the expressive standard library. You don’t need any third-party dependencies to quickly get a basic RESTful service up and running. With , you can easily define your routes and assign handlers to the requests that are routed to those URIs. net/http http.HandleFunc The method kicks off the server, binding it to the port you specify. When we deploy to Heroku, . For our local deployment, we default to . http.ListenAndServe Heroku will handle setting the PORT var in the environment 8080 Let’s look at a handler: func spongebobHandler(w http.ResponseWriter, r *http.Request) {
	decoder := json.NewDecoder(r.Body)
	var t requestPayload
	err := decoder.Decode(&t)
	if err != nil {
		panic(err)
	}

	result := map[string]string{
		"original":  *t.Input,
		"spongebob": spongebob(*t.Input),
	}

	w.Header().Set("Content-Type", "application/json")
	err = json.NewEncoder(w).Encode(result)
	if err != nil {
		return
	}
} Our handler needs to do the work of taking the JSON body of the request and parsing it into a Go struct defined outside of this snippet. Then, it needs to build the result from other functions that transform the input string into a SpongeBob utterance. Again, none of the libraries here are third-party dependencies; they all come standard with Go. You can see the prevalence of error handling here via error codes, as working with takes up a large part of the code real estate. err $ go run main.go Then, we send a GET request to : /health $ curl -s http://localhost:8080/health We receive a JSON response indicating the service is up and healthy. That’s it—one file with roughly 100 lines of actual code, and you have a working Go RESTful microservice! Deploying your Go service to Heroku Running the service on your laptop is OK, I guess. But you know what would be really cool? Running it on the web, that’s what. These days, we have lots of options for how to host a service like this. You could build out your own infrastructure using AWS or Azure, but that quickly gets complicated and expensive. Lately, I’ve been turning more and more to . As a platform-as-a-service (PaaS), it’s a low-hassle, low-cost option that allows me to deploy applications to the cloud quickly. Heroku When I’m doing testing and development, I use their Eco Dyno plan to get 1000 dyno hours per month for $5. To deploy basic apps to production, I use their Basic Dyno Plan, which costs a max of $7 per month. For frameworks that Heroku supports, the process of deploying right from your local machine to the web is quick and painless. After setting up a Heroku account, I installed the and logged in from the command line. Heroku CLI You can create a new app directly through the CLI, or you can use the web UI. I named my application the same as my GitHub repo: . We’ll think of something snazzier before our IPO, but for now, this will do. golang-text-demo To deploy our GitHub repo to Heroku, we first need to add a remote repository. $ heroku git:remote -a golang-text-demo This creates a new remote location in our GitHub repo, pointing it to the Heroku application we just created. Now, whenever we push our branch to that remote ( ), it will kick off a flurry of activity as Heroku gets to work. git push heroku main Lastly, we add one file called , which specifies our app’s build dependencies (we don’t have any) and build configurations for Heroku. Our file is short and sweet; simply setting the Go version we want Heroku to use: go.mod module golang-text-demo

go 1.22 When we push to our Heroku remote, Heroku initializes all the required resources in the cloud. This may take a minute or two the first time you deploy your app, but the results appear to be cached, reducing the time in subsequent deploys. When your app has successfully deployed, you’ll see output that looks similar to this: This gives us the URL for our deployed Heroku app. Sweet! With a single command, we’ve deployed a Go microservice to the cloud, and it is now accessible anywhere in the world. To interact with it, we simply issue the same curl command we did before, but we use the Heroku app URL instead of . git push localhost The Heroku CLI also gives us access to our application’s logs. It’s almost exactly like working with the tools directly on your local machine. We just run , and we see the latest log lines from Heroku and our application right there in our terminal window. heroku logs -tail Before we finish, let’s briefly highlight the impressive insights that can be gained about your application from the Heroku app dashboard. Sure, there’s the obvious stuff you care about—like how much your resources are costing or whether or not they are functioning. But the metrics section gives you impressive details about the performance of your application in near real time. Somebody better do something about those critical errors… 🥴 Conclusion In this walkthrough, we’ve explored why Go is a great choice for building a modern, low-dependency, and efficient web service. We built a simple API service in Go and demonstrated how to deploy our service using Heroku. As a PaaS, Heroku supports running a wide variety of services, not just Go. With that, you now have the tools needed to get started on your own Go services journey. Don’t wait, get Go-ing! Also published . here

This story contains new, firsthand information uncovered by the writer.

The writer was physically present in relevant location(s) to this story. The location is also a prevalent aspect of this story be it news or otherwise.

How I Built My First Go App and The Deployed it to Heroku

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

How to Handle Log Spikes Like the Pros: How Top DevOps Teams Tame Bursty Workloads

104 Stories To Learn About Go

The Noonification: How to Use React to Replace useEffect (12/31/2022)

3 Golang Pitfalls Every Developer Needs to Know

207 Stories To Learn About Golang

How to Handle Log Spikes Like the Pros: How Top DevOps Teams Tame Bursty Workloads

104 Stories To Learn About Go

The Noonification: How to Use React to Replace useEffect (12/31/2022)

3 Golang Pitfalls Every Developer Needs to Know

207 Stories To Learn About Golang

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps