Golang项目部署

文章来源：https://goframe.org/deploymen...

1、独立部署

使用GF开发的应用程序能够独立地部署到服务器上，设置为后台守护进程运行便可。这种模式经常使用在简单的API服务项目中。

服务器咱们推荐使用*nix服务器系列(包括:Linux, MacOS, *BSD)，如下使用Ubuntu系统为例，介绍如何部署使用GF框架开发的项目。

1. nohup

咱们可使用简单的nohup命令来运行应用程序，使其做为后台守护进程运行，即便远程链接的SSH断开也不会影响程序的执行。在流行的Linux发行版中每每都默认安装好了nohup命令工具。
命令以下：

nohup ./gf-app &

2. tmux

tmux是一款Linux下的终端复用工具，能够开启不一样的终端窗口来将应用程序做为后台守护进程执行，即便远程链接的SSH断开也不会影响程序的执行。
在ubuntu系统下直接使用sudo apt-get install tmux安装便可。使用如下步骤将应用程序后台运行。

1. tmux new -s gf-app；
2. 在新终端窗口中执行./gf-app便可；
3. 使用crt + B & D快捷键能够退出当前终端窗口；
4. 使用tmux attach -t gf-app可进入到以前的终端窗口；

3. supervisor

supervisor是用Python开发的一套通用的进程管理程序，能将一个普通的命令行进程变为后台daemon，并监控进程状态，异常退出时能自动重启。官方网站：http://supervisord.org/
常见配置以下：

[program:gf-app]
user=root
command=/var/www/main
stdout_logfile=/var/log/gf-app-stdout.log
stderr_logfile=/var/log/gf-app-stderr.log
autostart=true
autorestart=true

使用步骤以下：

1. 使用sudo service supervisor start启动supervisor服务；
2. 建立应用配置文件/etc/supervisor/conf.d/gf-app.conf, 内容如上;
3. 使用sudo supervisorctl进入supervisor管理终端；
4. 使用reload从新读取配置文件并重启当前supoervisor管理的全部进程；
5. 也可使用update从新加载配置(默认不重启)，随后使用start gf-app启动指定的应用程序；
6. 随后可使用status指令查看当前supervisor管理的进程状态；

2、代理部署

代理部署即前置一层第三方的WebServer服务器处理全部的请求，将部分请求(每每是动态处理请求)有选择性地转交给后端的Golang应用程序执行，后端部署的Golang应用程序能够配置有多个。这种模式经常使用在复杂的WebServer配置中，常见的场景例如：须要静态文件分离、须要配置多个域名及证书、须要自建负载均衡层，等等。

虽然 Golang实现的 WebServer也可以处理静态文件，可是相比较于专业性的 WebServer如 nginx/ apache来讲比较简单，性能也较弱。所以不推荐使用 Golang WebServer做为前端服务直接处理静态文件请求。

Nginx

咱们推荐使用Nginx做为反向代理的前端接入层，有两种配置方式实现动静态请求的拆分。

静态文件后缀

这种方式经过文件名后缀区分，将指定的静态文件转交给nginx处理，其余的请求转交给golang应用。
配置示例以下：

server {
    listen       80;
    server_name  goframe.org;

    access_log   /var/log/gf-app-access.log;
    error_log    /var/log/gf-app-error.log;

    location ~ .*\.(gif|jpg|jpeg|png|js|css|eot|ttf|woff|svg|otf)$ {
        access_log off;
        expires    1d;
        root       /var/www/gf-app/public;
        try_files  $uri @backend;
    }

    location / {
        try_files $uri @backend;
    }

    location @backend {
        proxy_pass                 http://127.0.0.1:8199;
        proxy_redirect             off;
        proxy_set_header           Host             $host;
        proxy_set_header           X-Real-IP        $remote_addr;
        proxy_set_header           X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
}

其中，8199为本地的golang应用WebServer监听端口。

例如，在该配置下，咱们能够经过http://goframe.org/my.png访问到指定的静态文件。

静态文件目录

这种方式经过文件目录区分，将指定目录的访问请求转交给nginx处理，其余的请求转交给golang应用。
配置示例以下：

server {
    listen       80;
    server_name  goframe.org;

    access_log   /var/log/gf-app-access.log;
    error_log    /var/log/gf-app-error.log;

    location ^~ /public {
        access_log off;
        expires    1d;
        root       /var/www/gf-app;
        try_files  $uri @backend;
    }

    location / {
        try_files $uri @backend;
    }

    location @backend {
        proxy_pass                 http://127.0.0.1:8199;
        proxy_redirect             off;
        proxy_set_header           Host             $host;
        proxy_set_header           X-Real-IP        $remote_addr;
        proxy_set_header           X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
}

其中，8199为本地的golang应用WebServer监听端口。

例如，在该配置下，咱们能够经过http://goframe.org/piblic/my.png访问静态文件。

3、容器部署

容器部署即便用docker化部署golang应用程序，这是在云服务时代最流行的部署方式，也是最推荐的部署方式。

1. 编译程序

跨平台交叉编译是golang的特色之一，能够很是方便地编译出咱们须要的目标服务器平台的版本，并且是静态编译，很是方便地解决了运行依赖问题。
使用如下方式静态编译Linux平台amd64架构的可执行文件：

CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o gf-app main.go

这样便编译出来一个gf-app的可执行文件。

2. 编译镜像

咱们须要将该可执行文件gf-app编译生成docker镜像，以便于分发及部署。Golang的运行环境推荐使用alpine基础系统镜像，编译出的容器镜像约为20MB左右。

一个参考的Dockerfile文件以下（ 能够参考gf-home项目的Dcokerfile: https://github.com/gogf/gf-home ）：

FROM loads/alpine:3.8

LABEL maintainer="john@johng.cn"

###############################################################################
#                                INSTALLATION
###############################################################################

ADD ./gf-app /bin/main
RUN chmod +x /bin/main

###############################################################################
#                                   START
###############################################################################

CMD main

其中，咱们的基础镜像使用了loads/alpine:3.8这个镜像，基础镜像的Dockerfile地址：https://github.com/johngcn/do... ，仓库地址：https://hub.docker.com/u/loads

随后使用 docker build gf-app . 命令编译生成名为gf-app的docker镜像。

3. 运行镜像

使用如下命令运行镜像：

docker run gf-app

4. 镜像分发

容器的分发可使用docker官方的平台：https://hub.docker.com/ ，国内也能够考虑使用阿里云：https://www.aliyun.com/produc... 。

5. 容器编排

在企业级生产环境中，docker容器每每须要结合kubernetes或者docker swarm容器编排工具一块儿使用。
容器编排涉及到的内容比较多，感兴趣的同窗能够参考如下资料：

• https://kubernetes.io/
• https://docs.docker.com/swarm/