14-Deployment-On-Heroku

在本章，我会将应用部署到Heroku云平台

许多云托管提供商提供了一个应用程序可以运行的托管平台。 你只需提供部署到这些平台上的实际应用程序，因为硬件，操作系统，脚本语言解释器，数据库等都由该服务管理。 这种服务称为平台即服务（PaaS）。

Heroku,这是一种流行的云托管服务,对Python、Go、Nodejs等应用程序支持都很好,关键还免费,而且默认支持HTTPS

本章的GitHub链接为： Source, Diff, Zip

Heroku

Heroku 是首批PaaS平台之一。 它以Ruby的应用程序的托管服务开始，随后逐渐发展到支持诸多其他语言，如Java，Node.js，Python 还有Go。

在 Heroku 中部署Web应用程序主要是通过git版本控制工具完成的，因此你必须将应用程序放在git代码库中。 在通过git将应用程序上传到 Heroku 的服务器之后，你的工作基本就完成了，只需等待几秒钟，应用程序就会上线。 整个操作流程就是这么简单。

Heroku提供不同的服务级别，允许你自主选择为应用程序提供多少计算能力和运行时间，随着用户群的增长，你需要购买更多的“dynos”计算单元。

创建Heroku账户

在部署应用到 Heroku 之前，你需要拥有一个帐户。 所以请访问 heroku.com 并创建一个免费账户。 一旦注册成功并登录到 Heroku，你将可以访问一个dashboard，其中列出了你的所有应用程序。

安装Heroku命令行工具

我们可以在 Heroku 的 dashboard 上完成所有操作，不过还有个更简便的方法，就是安装Heroku cli 工具

$ brew install heroku

然后我们可以通过命令行来登陆 Heroku

$ heroku login

创建Heroku应用

要用Heroku注册一个新应用，需要在应用程序根目录下使用apps:create子命令，并将应用程序名称作为唯一参数传递：

$ heroku apps:create go-mega
Creating ⬢ go-mega... done
https://go-mega.herokuapp.com/ | https://git.heroku.com/go-mega.git

创建 Heroku 数据库

Heroku 只有Postgres数据库是免费的，Mysql是收费的，所以我们还是创建 Postgres 数据库

$ heroku addons:add heroku-postgresql:hobby-dev
Creating heroku-postgresql:hobby-dev on ⬢ go-mega... free
Database has been created and is available
 ! This database is empty. If upgrading, you can transfer
 ! data from another database with pg:copy
Created postgresql-angular-82467 as DATABASE_URL
Use heroku addons:docs heroku-postgresql to view documentation

初始化数据

$ heroku config
=== go-mega Config Vars
DATABASE_URL: ******************

针对Heroku做些代码优化

由于Heroku采用的是 Configvar 的设置环境变量的方式，而且我们把 config.yml git ignore了，所以加入 os.Getenv 的方式去获取Configvar的环境变量，包括 DBTYPE, EMAIL相关，以及Heroku postgres 提供的 DATABASE_URL

config/g.go

package config

import (
    "fmt"
    "log"
    "os"
    "strconv"

    "github.com/spf13/viper"
)

func init() {
    projectName := "go-mega"
    dbType := GetDBType()
    log.Println("OS DBTYPE:", dbType)

    if IsHeroku() {
        log.Println("Get Env from os.env")
    } else {
        log.Println("Init viper")
        getConfig(projectName)
    }
}

func getConfig(projectName string) {
    viper.SetConfigName("config") // name of config file (without extension)

    viper.AddConfigPath(".")                                                // optionally look for config in the working directory
    viper.AddConfigPath(fmt.Sprintf("$HOME/.%s", projectName))              // call multiple times to add many search paths
    viper.AddConfigPath(fmt.Sprintf("/data/docker/config/%s", projectName)) // path to look for the config file in

    err := viper.ReadInConfig() // Find and read the config file
    if err != nil {             // Handle errors reading the config file
        panic(fmt.Errorf("Fatal error config file: %s", err))
    }
}

// GetMysqlConnectingString func
func GetMysqlConnectingString() string {
    usr := viper.GetString("mysql.user")
    pwd := viper.GetString("mysql.password")
    host := viper.GetString("mysql.host")
    db := viper.GetString("mysql.db")
    charset := viper.GetString("mysql.charset")

    return fmt.Sprintf("%s:%s@tcp(%s:3306)/%s?charset=%s&parseTime=true&loc=Local", usr, pwd, host, db, charset)
}

// GetHerokuConnectingString func
func GetHerokuConnectingString() string {
    return os.Getenv("DATABASE_URL")
}

// GetSMTPConfig func
func GetSMTPConfig() (server string, port int, user, pwd string) {
    if IsHeroku() {
        server = os.Getenv("MAIL_SMTP")
        port, _ = strconv.Atoi(os.Getenv("MAIL_SMTP_PORT"))
        user = os.Getenv("MAIL_USER")
        pwd = os.Getenv("MAIL_PASSWORD")
        return
    }

    server = viper.GetString("mail.smtp")
    port = viper.GetInt("mail.smtp-port")
    user = viper.GetString("mail.user")
    pwd = viper.GetString("mail.password")
    return
}

// GetServerURL func
func GetServerURL() (url string) {
    if IsHeroku() {
        url = os.Getenv("SERVER_URL")
        return
    }
    url = viper.GetString("server.url")
    return
}

// GetDBType func
func GetDBType() string {
    dbtype := os.Getenv("DBTYPE")
    return dbtype
}

// IsHeroku func
func IsHeroku() bool {
    return GetDBType() == "heroku"
}

修改ConnectToDB函数，支持postgres的数据库形式

model/g.go

...

// ConnectToDB func
func ConnectToDB() *gorm.DB {
    if config.IsHeroku() {
        return ConnectToDBByDBType("postgres", config.GetHerokuConnectingString())
    }
    return ConnectToDBByDBType("mysql", config.GetMysqlConnectingString())
}

// ConnectToDBByDBType func
func ConnectToDBByDBType(dbtype, connectingStr string) *gorm.DB {
    log.Println("DB Type:", dbtype, "\nConnet to db...")
    db, err := gorm.Open(dbtype, connectingStr)
    if err != nil {
        panic("Failed to connect database")
    }
    db.SingularTable(true)
    return db
}

cmd/db_init/main.go

    ...
    _ "github.com/jinzhu/gorm/dialects/postgres"
    ...

main.go 与数据初始化无关，不过最后部署还是要做响应的调整

main.go

    ...
    _ "github.com/jinzhu/gorm/dialects/postgres"
    ...


    port := os.Getenv("PORT")
    log.Println("Running on port: ", port)
    http.ListenAndServe(":"+port, context.ClearHandler(http.DefaultServeMux))

数据init

$ export DATABASE_URL=postgres://xxxxxxx
$ export DBTYPE=heroku

$ go run cmd/db_init/main.go

然后我们会发现数据初始化就完成了，让我们确认下

# 安装 psql
$ brew install postgresql

$ heroku pg:psql 
$ DATABASE=> select * from post;
id | user_id |              body               |           timestamp
----+---------+---------------------------------+-------------------------------
  1 |       1 | Beautiful day in Portland!      | 2018-10-23 07:13:30.664214+00
  2 |       2 | The Avengers movie was so cool! | 2018-10-23 07:13:36.118051+00
  3 |       2 | Sun shine is beautiful          | 2018-10-23 07:13:38.502164+00

# 退出
$ DATABASE=> \q

本小节 Diff

部署 Heroku

设置Config Vars

可以访问 https://dashboard.heroku.com/apps/go-mega/settings dashboard 的Config Vars 进行设置

也可以通过heroku cli

$ heroku config:set DBTYPE=heroku

# 设置root url
$ heroku config:set SERVER_URL=https://go-mega.herokuapp.com

# 设置mail
$ heroku config:set MAIL_SMTP=smtp.zoho.com
$ heroku config:set MAIL_SMTP_PORT=587
$ heroku config:set MAIL_USER=your_username
$ heroku config:set MAIL_PASSWORD=your_password

# 查看config
$ heroku config

Procfile

Procfile

web: go-mega-code

现在我们可以通过 heroku local来在本地查看应用

$ heroku local

Go dep

目前我们的代码和配置都已经完成了，不过部署 heroku 还需要我们提供依赖，我们这里使用 Godep

可以参照Go Dependencies via Godep

$ go get -u github.com/tools/godep
$ godep save http://127.0.0.1:4000/...

# 结果可以看见多了两个文件夹: vendor/ 和 Godeps/

Push heroku

# Remote add heroku
$ heroku git:remote -a go-mega
set git remote heroku to https://git.heroku.com/go-mega.git
$ git remote -v
heroku    https://git.heroku.com/go-mega.git (fetch)
heroku    https://git.heroku.com/go-mega.git (push)
origin    git@github.com:bonfy/go-mega-code.git (fetch)
origin    git@github.com:bonfy/go-mega-code.git (push)

# push branch to heroku master
$ git push heroku 14-Deployment-On-Heroku:master

现在访问 https://go-mega.herokuapp.com/ 就能看见 Demo 了

Notice: Heroku 绑定域名要收费，所以这里就不绑定域名了

本小节 Diff