echo web Download - echo web Source Code Скачать

Echo Web

Go Web Framework Echo пример.
master - v4 версия, v3 переключателей в ветвь v3 .

Требует

Echo китайский документ go-echo.org

Онлайн демо

Конфигурация среды

1. Скачать исходный код

$ go get github.com:hb-go/echo-web

2. зависеть от установки

Go Mod

Gfwgoproxy.io

Скользить

Установка инструмента Glide

.glide/mirrors.yaml Настройки ссылки

 # 编辑mirrors.yaml，或命令行glide mirror set [original] [replacement] --vcs [type]
$ vi ~ /.glide/mirrors.yaml

# 查看glide mirror
$ glide mirror list

$ cd $GOPATH /src/github.com/hb-go
$ glide install

3.mysql configuration

 # ./conf/conf.toml
[database]
name = " goweb_db "
user_name = " goweb_dba "
pwd  = " 123456 "
host = " 127.0.0.1 "
port = " 3306 "

# 测试数据库SQL脚本
./echo-web/res/db_structure.sql

4. Redis и Memcached Configuration, необязательная

Необязательно, вам необходимо изменить конфигурацию магазина сеанса и кеша

session_store = "file" или "cookie"
cache_store = "in_memory"

 # ./conf/conf.toml
[redis]
server = " 127.0.0.1:6379 "
pwd = " 123456 "

[memcached]
server = " localhost:11211 "

5. Название субдомена

 # ./conf/conf.toml
[server]
addr = " :8080 "
domain_api = " echo.api.localhost.com "
domain_web = " echo.www.localhost.com "
domain_socket = " echo.socket.localhost.com "

# 改host
$ vi /etc/hosts
127.0.0.1       echo.api.localhost.com
127.0.0.1       echo.www.localhost.com
127.0.0.1       echo.www.localhost.com

# Nginx配置，可选
server{
    listen       80 ;
    server_name  echo.www.localhost.com echo.api.localhost.com echo.socket.localhost.com ;

    charset utf-8 ;

    location / {
        proxy_pass http://127.0.0.1:8080 ;
        proxy_set_header X-Forwarded-For $remote_addr ;
        proxy_set_header Host $host ;
        proxy_http_version 1.1 ;
        proxy_set_header Upgrade $http_upgrade ;
        proxy_set_header Connection " upgrade " ;
    }
}

6.

Установка Bindata

бегать

 # 首次运行必须带 -a -t，更新assets.go、template.go的资源路径为本地
$ ./run.sh [-a] [-t]        # -a -t 可选(须安装Bindata)，以debug方式更新assets、template的Bindata资源包

# 浏览器访问
http://echo.www.localhost.com      # Nginx代理
http://echo.www.localhost.com:8080 # 无代理

# OpenTracing
http://localhost:8700/traces

Пакет

Bindata должен быть установлен для упаковки статических ресурсов и файлов шаблонов

 # 打包
$ ./build.sh 		    # 默认本机
$ ./build.sh -l		    # 打包Linux平台

# 运行
$ ./echo-web -c conf/conf.toml      # -c指定配置文件，默认conf/conf.toml

Структура каталога

assets          Web服务静态资源
conf            项目配置
middleware      中间件
model           模型，数据库连接& ORM
  └ orm         ORM扩展
module          模块封装
  ├ auth        Auth授权
  ├ cache       缓存
  ├ log         日志
  ├ render      渲染
  ├ session     Session
  └ tmpl        Web模板
res             项目资源
  └ db          数据
router          路由
  └ api         接口路由
    ├context    自定义Context，便于扩展API层扩展
    └router     路由
  ├ socket      socket示范
  └ web         Web路由
    ├context    自定义Context，便于扩展Webb层扩展
    └router     路由        
template        模板
  └ pongo2      pongo2模板
util            公共工具
  ├ conv        类型转换
  ├ crypt       加/解密
  └ sql         SQL

Функции структуры

Функция	описывать
Конфигурация	Файл конфигурации TOML
Развертывание субдомена	Модуль дифференциации имени субдона
кеш	Redis, Memcached, память
Сессия	Redis, файл, файлы cookie, поддержка флэш -памяти
Орм	Fork Gorm, `FirstSQL` , `LastSQL` , `FindSQL` , `CountSQL` поддерживает конструкцию запроса SQL
Кэш запроса	Поддерживает кэш запросов для `First` , `Last` , `Find` и `Count`
шаблон	Поддержите HTML/шаблон ( ~~Шаблон образца не поддерживается~~ ), pongo2, шаблоны поддерживают упаковку BindData
Статический	Статические ресурсы, поддержка упаковки BindData
Безопасность	CORS, CSRF, XSS, HSTS, код проверки и т. Д.
OpenTracing	Tracer поддерживает Jaeger и Appdash, отслеживание в слоях запроса и ORM, и может быть включен в конфигурации конфуза)
монитор	`Prometheus` `Grafana` `Graphite` `InfluxDB`
другой	Jwt, демо

Развертывание супервизора

 # Max open files问题，修改supervisord配置
$ vi /etc/supervisor/supervisord.conf
[supervisord]
minfds = 10240

$ vi /etc/supervisor/conf.d/echo-web.conf

Ссылка на конфигурацию

[program:echo-web]
directory = /{path}/echo-web                                            ; 程序的启动目录
command =  /{path}/echo-web/echo-web -c /{path}/echo-web/conf/conf.toml ; 启动命令，与手动在命令行启动的命令是一样的
process_name=%(program_name)s                                           ; process_name expr (default %(program_name)s)
numprocs=1           ; number of processes copies to start (def 1)
autostart = true     ; 在 supervisord 启动的时候也自动启动
startsecs = 5        ; 启动 5 秒后没有异常退出，就当作已经正常启动了
autorestart = true   ; 程序异常退出后自动重启
startretries = 3     ; 启动失败自动重试次数，默认是 3
user = root          ; 用哪个用户启动
redirect_stderr = true          ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 20MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 7      ; stdout 日志文件备份数
; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile = /var/log/echo-web/stdout.log
; 这一配置项的作用是：如果supervisord管理的进程px又产生了若干子进程，使用supervisorctl停止px进程，停止信号会传播给px产生的所有子进程，确保子进程也一起停止。这一配置项对希望停止所有进程的需求是非常有用的。
stopasgroup=false
killasgroup=false
environment=GOGC=1000

Конфигурация управления Confd

 # 安装confd
$ go get github.com/kelseyhightower/confd

 # 将配置写入etcd，统一前缀echo-web
$ etcdctl ls --recursive --sort /echo-web
/echo-web/app
/echo-web/app/name
......
/echo-web/tmpl/suffix
/echo-web/tmpl/type

$ cd {pwd}/echo-web
$ confd -onetime -confdir conf  -backend etcd -node http://127.0.0.1:4001 -prefix echo-web

OpenTracing

Включить или отключить в conf.toml

AppDash можно использовать напрямую, проверьте http: // localhost: 8700
Jaeger необходимо создать услугу, вы можете построить среду разработки в Docker, проверить http: // localhost: 16686

[opentracing]
disable = false

# jaeger or appdash
type = " jaeger "

# jaeger serviceName
service_name = " echo-web "

# jaeger-agent 127.0.0.1:6831
# appdash http://localhost:8700
address = " 127.0.0.1:6831 "

Метрики

Включить или отключить в conf.toml

[metrics]
disable = false
freq_sec = 10
address = " 127.0.0.1:2003 "  # Graphite

Графана

Браузер: Localhost: 3000

docker run --name grafana -d -p 3000:3000 grafana/grafana

Прометей

Браузер: Localhost: 9090

docker run -d --name prometheus -p 9090:9090 -v ~ /tmp/prometheus.yml:/etc/prometheus/prometheus.yml 
              prom/prometheus
              
# Dashboard JSON
# middleware/metrics/prometheus/grafana.json

Для получения дополнительных ссылок на промежуточное программное обеспечение/метрики/readme.md

Docker развертывание

DockerFile содержит два метода, пакет изображений исходного кода слишком большой

 # 创建镜像，注意修改配置
$ docker build -t hbchen/echo-web:v0.0.1 .

# 运行容器
$ docker run  
     -p 8080:8080 
     --name=echo-web 
     hbchen/echo-web:v0.0.1

*Проблемы с конфигурацией обслуживания MySQL, Redis, Memcached и т. Д.

 # 如果是服务在宿主机需要配置服务IP为主机IP，127.0.0.1/localhost网络不通

# hbchen/echo-web使用的配置，在宿主机host上做个映射(192.168.1.8为主机IP)
# 192.168.1.8 mysql.localhost.com
# 192.168.1.8 redis.localhost.com
# 192.168.1.8 memcached.localhost.com
[database]
host = " mysql.localhost.com "

[redis]
server = " redis.localhost.com:6379 "

[memcached]
server = " memcached.localhost.com:11211 "

Автоматически изменять /etc /hosts, отображать пользовательские доменные имена для IP -IP -хоста

$ vi ~ /.profile

# 添加
grep -v " etcd.localhost.com|consul.localhost.com|mysql.localhost.com|redis.localhost.com|memcached.localhost.com " /etc/hosts > ~ /hosts_temp
cat ~ /hosts_temp > /etc/hosts
LC_ALL=C ifconfig en0 | grep ' inet ' | cut -d ' ' -f2 | awk ' {print $1 " etcd.localhost.comn" $1 " consul.localhost.comn" $1 " mysql.localhost.comn"$1     " redis.localhost.comn" $1 " memcached.localhost.com"} ' >> /etc/hosts

# 修改配置或切换网络时更新
$ source ~ /.profile

PPROF

 import "github.com/hb-go/echo-web/middleware/pprof"

echo . Pre ( pprof . Serve ())
/*或*/
echo . Use ( pprof . Serve ())

Информация о просмотре веб -страниц

http: // {host}/debug/pprof/

Google/pProf

Здание PPROF
Запустите PPROF через веб -интерфейс

$ go get -u github.com/google/pprof

$ pprof -http=[host]:[port] [main_binary] profile.pb.gz

# 使用echo-web演示
$ pprof -http=localhost:8080 --alloc_space http://echo.www.hbchen.com/debug/pprof/heap

Расширять