快速部署網站到 Heroku 雲平台

大家在寫開源專案時，一定需要一個免費的雲空間來放置網站，方便其他開發者在 GitHub 看到時，可以先點選 Demo 網站來試用，也許開發者可以使用 GitHub 提供的免費靜態網站，但是如果是跑 Golang 或是其他語言 Node.js 就不支援了，本篇來介紹 Heroku 雲平台，它提供了開發者免費的方案，您可以將 GitHub 儲存庫跟 Heroku 結合，快速的將程式碼部署上去，Heroku 會給開發者一個固定的 URL (含有 HTTPS 憑證)，也可以動態的用自己買的網域。最重要的是 Heroku 提供了兩種更新方式，第一為 Git，只要開發者將程式碼 Push 到 Heroku 儲存庫，Heroku 就可以自動判斷開發者上傳的語言，並進行相對應的部署，另一種方式為 Docker 部署，只要在儲存庫內放上 Dockerfile，透過 Heroku CLI 指令就可以將 Docker 容器上傳到 Heroku Docker Registry，並且自動部署網站。底下我們來透過簡單的 Go 語言專案: Facebook Account Kit 來說明如何快速部署到 Heroku。

教學影片

歡迎訂閱我的 Youtube 頻道

使用 Git 部署

註冊網站後，可以直接在後台建立 App，此 App 名稱就是未來的網站 URL 前置名稱。進入 App 的後台，切換到 Deploy 的 Tab 可以看到 Heroku 提供了三種方式，本文只會講其中兩種，在開始之前請先安裝好 Heroku CLI 工具，底下所有操作都會以 CLI 介面為主。用 Git 來部署是最簡單的，開發者可以不用考慮任何情形，只要將程式碼部署到 Heroku 上面即可。在 Go 語言只要觸發 Push Event 系統會預設使用 go1.11.4 來編譯環境，產生的 Log 如下:

-----> Go app detected
-----> Fetching jq... done
 !!    
 !!    Go modules are an experimental feature of go1.11
 !!    Any issues building code that uses Go modules should be
 !!    reported via: https://github.com/heroku/heroku-buildpack-go/issues
 !!    
 !!    Additional documentation for using Go modules with this buildpack
 !!    can be found here: https://github.com/heroku/heroku-buildpack-go#go-module-specifics
 !!    
 !!    The go.mod file for this project does not specify a Go version
 !!    
 !!    Defaulting to go1.11.4
 !!    
 !!    For more details see: https://devcenter.heroku.com/articles/go-apps-with-modules#build-configuration
 !!    
-----> Installing go1.11.4
-----> Fetching go1.11.4.linux-amd64.tar.gz... done
 !!    Installing package '.' (default)
 !!    
 !!    To install a different package spec add a comment in the following form to your `go.mod` file:
 !!    // +heroku install ./cmd/...
 !!    
 !!    For more details see: https://devcenter.heroku.com/articles/go-apps-with-modules#build-configuration
 !!    
-----> Running: go install -v -tags heroku .

系統第一步會偵測該專案使用什麼語言，就會產生相對應得環境，所以用 Git 方式非常簡單，開發者不需要額外設定就可以看到網站已經部署完畢，底下是 Git 基本操作，首先是登入 Heroku 平台。這邊會打開瀏覽器登入視窗。

`1`	`$ heroku login`

新增 Heroku 為另一個 Remote 節點

1
2

$ heroku git:clone -a heroku-demo-tw
$ cd heroku-demo-tw

簡單編輯程式碼，並且推到 Heroku Git 服務

1
2
3

$ git add .
$ git commit -am "make it better"
$ git push heroku master

使用 Docker 部署

Heroku 也提供免費的 Docker Registry 讓開發者可以寫 Dockerfile 來部署，底下是透過 Docker multiple stage 來編譯 Go 語言 App

FROM golang:1.11-alpine as build_base
RUN apk add bash ca-certificates git gcc g++ libc-dev
WORKDIR /app
# Force the go compiler to use modules
ENV GO111MODULE=on
# We want to populate the module cache based on the go.{mod,sum} files.
COPY go.mod .
COPY go.sum .
RUN go mod download

# This image builds the weavaite server
FROM build_base AS server_builder
# Here we copy the rest of the source code
COPY . .
ENV GOOS=linux
ENV GOARCH=amd64
RUN go build -o /facebook-account-kit -tags netgo -ldflags '-w -extldflags "-static"' .

### Put the binary onto base image
FROM plugins/base:linux-amd64
LABEL maintainer="Bo-Yi Wu <appleboy.tw@gmail.com>"
EXPOSE 8080
COPY --from=server_builder /app/templates /templates
COPY --from=server_builder /app/images /images
COPY --from=server_builder /facebook-account-kit /facebook-account-kit
CMD ["/facebook-account-kit"]

這裡面有一個小技巧，讓每次 Docker 編譯時可以 cache 住 golang 的 vendor，就是底下這兩行啦

# We want to populate the module cache based on the go.{mod,sum} files.
COPY go.mod .
COPY go.sum .
RUN go mod download

這時候只要我們沒有動過 go.* 相關檔案，每次編譯時系統就會自動幫忙 cache 相關 vendor 套件，加速網站部署，完成上述設定後，接著用 Heroku CLI 來完成最後步驟。首先在開發電腦上面必須安裝好 Docker 環境，可以透過底下指令來確認電腦是否有安裝好 Docker

`1`	`$ docker ps`

現在可以登入 Container Registry Now you can sign into Container Registry.

`1`	`$ heroku container:login`

上傳 Docker 映像檔到 Heroku，這邊會在 Local 直接編譯產生 Image

`1`	`$ heroku container:push web`

上面步驟只是上傳而已，並非部署上線，透過底下指令才能正確看到網站更新。

`1`	`$ heroku container:release web`

心得

上面所有的程式碼都可以在這邊找到，這邊我個人推薦使用 Docker 方式部署，原因很簡單，如果使用 Docker 部署，未來您不想使用 Heroku，就可以很輕易地轉換到 AWS 或 GCP 等平台，畢竟外面的雲平台不可以提供 Git 服務並且自動部署。使用 Docker 形式也可以減少很多部署的工作，對於未來轉換平台來說是非常方便的。

教學影片

使用 Git 部署

使用 Docker 部署

心得

See also