切换语言为:繁体

GoLang 环境变量与配置

  • 爱糖宝
  • 2024-06-10
  • 2091
  • 0
  • 0

在编程语言中环境变量与配置是相辅相成的。不同环境加载不同的配置成为了必需品。

一、开始

1.1) 为什么需要配置和环境变量?

  • 配置更好的管理项目的,集中式的管理项目,会使得项目更好维护。

  • 环境变量是与代码进行解耦,更好的维护。

  • 项目部署切换环境方便。

1.2) build 会将哪些内容打包到二进制

  • go 文件

  • 依赖的go文件

  • embed 嵌入文件

配置文件不是嵌入的,不会加入配置文件。

1.3) 哪些内容会需要配置

  • 数据库

  • 秘钥

  • 服务器端口

  • 环境变量

  • 路径

  • 特殊标识符(调试标识符)

  • 缓存、消息队列

  • 第三方服务

  • 定时任务

  • 分布式系统配置

  • 监控系统

  • 日志统计

  • ...

二、配置

  • viper 是 go 中出名的配置工具库

三、设置系统环境变量

set GO_ENV=production myapp.exe

#!/bin/bash
export GO_ENV=test && ./myapp


四、环境变量 dotenv

适合在开发环境:

  • 安装

go get -u github.com/joho/godotenv


  • 创建一个配置文件:

touch config.yml # config/config.yml


  • 一个配置文件示例:

server:
  port: 8090
db:
  user: admin
  password: secret
  url: 'https://db'


配置并使用

package main

import (
    "fmt"
    "github.com/spf13/viper"
)

func main() {
    println("hello world!")
    GetConfig()
}

func GetConfig() {
    viper.SetConfigName("config")
    viper.SetConfigType("yml")
    viper.AddConfigPath("./config")

    err := viper.ReadInConfig()

    if err != nil {
            panic(fmt.Errorf("Fatal Error config: file: %w \n", err))
    }

    fmt.Println("Server Port: ", viper.GetInt("server.port"))
    fmt.Println("Database User: ", viper.GetString("db.user"))
}


五、生产环境

systemd

systemd 是一套用于启动和管理系统进程的系统和服务管理器。

systemd 能够通过 systemctl配置文件对服务进行控制:

  • 配置文件位置:/etc/systemd/system/ 目录下。

  • systemctl 命令,以下是一些常用的命令

命令 作用
sudo systemctl start <unit> 启动指定的服务或其他 unit
sudo systemctl stop <unit> 停止指定的服务或其他 unit
sudo systemctl restart <unit> 重启指定的服务或其他 unit
sudo systemctl reload <unit> 重新加载指定的服务配置
sudo systemctl enable <unit> 启用服务开机自启动
sudo systemctl disable <unit> 禁用服务开机自启动
sudo systemctl status <unit> 查看指定服务或其他 unit 的状态
sudo systemctl daemon-reload 重新加载 systemd 管理器配置
  • 配置示例

[Unit]
Description=My App Service
After=network.target

[Service]
ExecStart=/path/to/myapp
ExecReload=/path/to/myapp reload
ExecStop=/path/to/myapp stop
Restart=always
Environment="GO_ENV=production"
EnvironmentFile=-/etc/myapp/env

[Install]
WantedBy=multi-user.target


配置文件是一个 ini 文件。Service 下的 Environment/EnvironmentFile 配置环境变量相关的内容。

六、docker

6.1) dockerfile

FROM golang:1.16

ENV GO_ENV=production
ENV DATABASE_URL=postgres://user:password@localhost:5432/proddb
WORKDIR /app
COPY . .
RUN go mod download
RUN go build -o myapp .
EXPOSE 8080

CMD ["./myapp"]


6.2) docker-compose

version: '3'
services:
  myapp:
    image: myapp:latest
    environment:
      - GO_ENV=production
      - DATABASE_URL=postgres://user:password@db:5432/proddb
    ports:
      - "8080:8080"

6.3) k8s

  • deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 2
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: myapp
        image: myapp:latest
        env:
        - name: GO_ENV
          value: "production"
        - name: DATABASE_URL
          value: "postgres://user:password@db:5432/proddb"
        ports:
        - containerPort: 8080

七、小结

本文主要介绍 go 中项目环境变量和配置文件处理方式,环境变量可以通过系统级配置,可以通过 env 配置,在环境多采用 docker 等配置进行配置。

0条评论

您的电子邮件等信息不会被公开,以下所有项均必填

OK! You can skip this field.