如何查找Terraform官方文档
本文的目的是什么?
Terraform真的很有趣,对吧?
我最近才剛入門,只能使用一些基礎的功能,但我仍然覺得很有趣。
这样的Terraform,官方文档感觉很好,但一开始我不知道该在哪里搜索我想要的信息,感到困惑。
因此,对于那些希望像我一样阅读Terraform官方文档,但不知道如何搜索想要的信息的人,我将在这篇文章中总结一下。
如果有人说:“如果你阅读了官方文档的这一部分,你的Terraform技能将会得到提高”,请务必告诉我!
请注意,以下说明的信息是截至2022年2月17日的最新信息。
由于Terraform官方网站的布局和发布的信息可能会发生变化,
请注意这一点。
首先,得出结论。
实际上,官方页面上详细说明了Terraform官方文档中的内容。
因为他非常简洁明了地总结了的,所以让我们首先看这个。
以下是一些我常常阅读的东西。
当你想要了解Terraform的整体设置时。
让我们阅读《配置语言》这份文件。
例如,依赖(dependency)和依存(dependent)是元参数(meta-arguments)中的一个例子,当您想要了解相关信息时,可以按照以下步骤进行查询。
![lang02.png](https://cdn.silicloud.com/blog-img/blog/img/657d8848913a08637a6c2a68/14-1.png)
就是这样。太简单了。
当想要了解Provider时,可以进行调查。
让我们阅读Terraform注册表中的文档。
如果您想要查找有关AWS资源之一的aws_security_group的信息,可以按照以下步骤进行。
![prov04.png](https://cdn.silicloud.com/blog-img/blog/img/657d8848913a08637a6c2a68/19-3.png)
这就是以上内容。
当你想要跨越Terraform文档进行研究时,应该怎么做?
在Terraform文档的中央上方的搜索框中输入。
![all1.png](https://cdn.silicloud.com/blog-img/blog/img/657d8848913a08637a6c2a68/23-0.png)
这样做会进行横向搜索,
但从个人角度来看,我更倾向于先打开相关文档,然后使用过滤器的方法进行搜索。
通常只要在配置语言中搜索一下,应该能找到解决方法。我坚信如此。
順便提一下,在进行横向搜索时,请注意Terraform Registry上的文档不在搜索范围之内。
换句话说,当你想要查找AWS的配置或其他信息时,这个工具就用不上了。
当你想要横跨各个Provider和Module进行调查时,你需要前往Terraform Registry并进行搜索。
后记
有时候遇到不明白的地方,我会进行各种搜索,可是就是找不到准确的信息,
正当我差点陷入困境时,尝试去阅读官方文件,发现里面其实写得很清楚,
这样的情况不仅仅在Terraform上会出现,其他情况也常常发生。
即使因为是英文而感觉有点麻烦,但最终发现这是最快捷的方式。
作为工程师,无论是使用英语还是其他语言,我们始终应该始终保持查阅官方文档的态度。这是我对自己的警示。