34.Go YAML

Posted 2023-04-18

参考技术A YAML是一种流行的格式，用于以人类友好的格式序列化数据, 类似JSON但更易于阅读。

由于其表达能力和可读性，YAML作为配置文件的格式很受欢迎。

它也用于更复杂的场景中，例如推动Ansible服务器自动化。

标准库中没有用于处理YAML格式的软件包，但是社区库包括gopkg.in/yaml.v2

将YAML文件读取到Go结构中:

YAML:

YAML解码与JSON解码非常相似。

如果你知道YAML文件的结构，则可以定义映射该结构的结构，并将指向顶级结构的结构的指针传递给yaml.Decoder.Decode()函数(或从[]进行解码的yaml.Unmarshal())。 字节片)。

YAML解码器在结构字段名称和YAML文件中的名称之间进行智能映射，以便 YAML中的名称值被解码为结构中的字段名称。

最好使用yaml struct标签创建显式映射。 我仅在示例中省略了它们，以说明未指定它们时的行为。

将struct写入YAML文件:

yaml.Marshal将interface 作为参数。 可以传递任何Go值，并将其类型包装到interface 中。

Marshaller将使用反射检查传递的值并将其编码为YAML字符串。

在序列化结构时，仅对导出的字段(其名称以大写字母开头)进行序列化/反序列化。

在我们的示例中，未对fullName进行序列化。

结构被序列化为YAML字典。 默认情况下，字典键与结构字段名称相同。

结构字段名称在字典键名称下序列化。

我们可以提供带有struct标签的自定义映射。

我们可以将任意的struct标签字符串附加到struct字段。

yaml:“ age”指示YAML编码器/解码器将名称age用于表示字段Age的字典关键字。

序列化结构时，将值和指针传递给它会产生相同的结果。

传递指针效率更高，因为按值传递会创建不必要的副本。

在 app.yaml 上指定的环境变量，但它没有在 main.go 上获取

【中文标题】在 app.yaml 上指定的环境变量，但它没有在 main.go 上获取

【英文标题】：Environment variables specified on app.yaml but it's not fetching on main.go

【发布时间】：2016-01-25 00:39:03

【问题描述】：

我在 app.yaml 中指定了我的环境变量，当我在本地机器上运行它时会获取它，但是一旦我部署它 - 它就不会获取它。

我是这样设置的：

application: some-application
version: 1
runtime: go
api_version: go1
threadsafe: true

handlers: 
- url: /.*
  script: main.go
  secure: always

env_variables: 
  ENVIRONMENT_VAR1: 'some key'
  ENVIRONMENT_VAR2: 'some key'
  ENVIRONMENT_VAR3: 'some key'

我正在使用os.Getenv("ENVIRONMENT_VAR1") 检索密钥，当我在本地运行它时它可以工作，但在部署到谷歌应用引擎时无法工作。

【参考方案1】：

官方文档中没有记录：Defining environment variables，但是在调用init()函数之前没有设置生产中app.yaml中定义的环境变量。它们仅在处理第一个请求之前设置。

此问题已报告 here。引用 AppEngine 工程师的回答：

没错。不幸的是，由于实现的性质，环境变量在您的 init 函数中不可用。 尽管它们不与请求绑定，但直到所有 init 函数都已运行后才设置它们，而是在处理第一个请求之前设置。

因此，您可以在主处理程序中使用 sync.DoOnce 来根据环境变量的值执行所需的任何操作，因为届时它将被正确设置。

使用Once.Do() 实现此目的的示例：

var once = sync.Once

func MainHandler(w http.ResponseWriter, r *http.Request) 
    once.Do(mysetup)
    // do your regular stuff here


func mysetup() 
    // This function is executed only once. Read / use env vars here.
    var1 := os.Getenv("ENVIRONMENT_VAR1")
    _ = var1 // use var1

【讨论】：

嗨@icza - 我已经尝试过这里的实现，但我认为它不起作用。您能否提供更多有关此 sync.DoOnce 在主处理程序中的实际工作原理的背景信息？

【参考方案2】：

icza 提供的答案对我有用。此外，我将 once.Do() 调用放在 /_ah/start 方法的处理程序中，以便在 GAE 启动我的应用程序时立即调用它。