https://github.com/victorshinya/go-cloud

A Golang boilerplate code to test and benchmark cloud platforms.
https://github.com/victorshinya/go-cloud

go go-cloud golang golang-boilerplate golang-examples golang-server

Last synced: 25 days ago
JSON representation

A Golang boilerplate code to test and benchmark cloud platforms.

• Host: GitHub
• URL: https://github.com/victorshinya/go-cloud
• Owner: victorshinya
• License: mit
• Created: 2019-06-25T04:10:50.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2021-11-12T14:52:21.000Z (about 3 years ago)
• Last Synced: 2024-10-19T19:18:04.577Z (about 2 months ago)
• Topics: go, go-cloud, golang, golang-boilerplate, golang-examples, golang-server
• Language: HTML
• Homepage:
• Size: 703 KB
• Stars: 3
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ibmcloud - go-cloud - A Golang boilerplate code to benchmark cloud platforms to host a Go applications. (Platform)

README

        
# Go Cloud

[![IBM Cloud Powered](https://img.shields.io/badge/IBM%20Cloud-powered-blue.svg)](https://cloud.ibm.com)

[![Platform](https://img.shields.io/badge/platform-golang-lightgrey.svg?style=flat)](https://developer.ibm.com/?s=golang/)

[![Go Report Card](https://goreportcard.com/badge/github.com/victorshinya/go-cloud)](https://goreportcard.com/report/github.com/victorshinya/go-cloud)

A Golang boilerplate code to test and benchmark cloud platforms.

![Architecture Design](doc/source/images/architecture.jpeg)

## Run locally

Before you run the app, you need to install [Golang](https://golang.org) and quick set up the local environment (your computer). Install [Docker](https://www.docker.com) and [Docker Compose](https://docs.docker.com/compose/) if you want to start using the second option (modular and no "works on my machine"). After the installation and set up, you will be able to run the following code:

### Using Golang CLI

```sh

go run main.go

```

### Using Docker (with `docker-compose`)

```sh

cd deployments

docker-compose up

```

## Deploy the application on IBM Cloud

You can deploy on IBM Cloud in two different ways: using Go buildpack (using the Golang Runtime) or using Static buildpack (which uses [NGINX](https://www.nginx.com)). By default, the IBM Cloud will use Staticfile for cloud environment (because there is a `Staticfile` at the root of the project). If you want to deploy using Golang, use the flag `-b go_buildpack` or `-f deployments/manifest.yml` (which includes the reference to the Golang buildpack).

### Go Runtime

```sh

ibmcloud cf push -f deployments/manifest.yml

```

### Staticfile (or NGINX on IBM Cloud)

```sh

ibmcloud cf push

```

### 1-Click deploy

Also you can use the 1-click deploy button. It will use the platform's DevOps pipeline to build and deploy the app.

Support platforms:

- [IBM Cloud](https://cloud.ibm.com/devops/setup/deploy?repository=https://github.com/victorshinya/go-cloud)

- [Heroku](https://heroku.com/deploy?template=https://github.com/victorshinya/go-cloud/tree/master)

## License

MIT License

Copyright (c) 2020 Victor Shinya