Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Speaker Deck
PRO
Sign in
Sign up
for free
Terraform Provider for Azure に貢献してみた話
Tatsuro Shibamura
February 18, 2020
Technology
0
260
Terraform Provider for Azure に貢献してみた話
Tatsuro Shibamura
February 18, 2020
Tweet
Share
More Decks by Tatsuro Shibamura
See All by Tatsuro Shibamura
shibayan
0
2.4k
shibayan
0
350
shibayan
1
1.8k
shibayan
1
18k
shibayan
2
980
shibayan
1
3.2k
shibayan
0
870
shibayan
0
3.1k
shibayan
1
1k
Other Decks in Technology
See All in Technology
yamamuteki
3
760
xecus
0
190
harshbothra
0
130
go5paopao
4
480
manuelmeyer
0
160
eayedi
2
150
grapecity_dev
0
130
tomihisa
1
1.2k
clustervr
0
240
askul
1
200
binarymist
0
1.3k
900groove
2
430
Featured
See All Featured
akmur
252
19k
deanohume
294
28k
lemiorhan
627
43k
mongodb
23
3.9k
holman
288
130k
3n
163
22k
shpigford
369
42k
lauravandoore
437
28k
gr2m
83
11k
reverentgeek
167
7.3k
philnash
9
580
yeseniaperezcruz
302
31k
Transcript
Terraform Provider for Azure に貢献してみた話 @shibayan
はじめに • AzureRM Terraform Provider に使いたい機能が入ってなかっ たので自分で追加した話です • Go をちゃんと触ったのがこれが最初でした
• 公式の README をちゃんと読めば迷わないです • https://github.com/terraform-providers/terraform-provider- azurerm/blob/master/README.md
今回の経緯 • 何故か Azure Function には ip_restriction 設定がなかった • App
Service 側にはあるので謎 • Issue が上がってて要望も多そうだった(自分もその一人) • 凄く使いたいのに、数か月動きがなかった • ないんだったら自分で実装すれば(以下略 • https://github.com/terraform-providers/terraform-provider- azurerm/pull/5440
必要なもの • Go version 1.13.x • Make for Windows •
ビルドするために必要 • Git Bash for Windows • Git for Windows に付いてきたものを利用した • Visual Studio Code + Go Extension
貢献までの流れ • Issue を検索して、同じ問題が上がっていないか調べる • 無い場合は先に Issue を作ってから • コードを修正、テストを追加
• make build を実行して Provider をビルド、手元で確認 • make test / make testacc でテストが通ることを確認 • testacc は acceptance tests のこと
Visual Studio Code は必須ツール 保存時にインデントを 自動で整えてくれる コンテキストに沿って IntelliSense が動作
ビルドした Provider を確認する • ビルドした terraform-provider-azurerm.exe を “.terraform¥plugins¥windows_amd64” 以下にコピー •
terraform init を再度実行 • これまで通り terraform plan や apply を実行 • ちゃんと PR にはテストコードを追加しましょう
PR を作成すると自動でラベルが付く
Windows 環境での注意点 • Git 設定が autocrlf = true だと make
build で落ちる • Formatter / Linter が crlf だとエラー扱いに • autocrlf = false にしてから clone しなおす • make の実行は Git Bash から行う • シェルスクリプトが使われてるので cmd / pwsh では無理 • WSL を使って構築した方が無難
貢献してみた感想 • Visual Studio Code があれば何とかなる • Formatter / Linter
の設定を読み取っていい感じに保存してくれる • ビルドツール周りが Windows だと少し辛い • Make for Windows や Git Bash for Windows が必要 • Terraform Provider の構造は簡単 • リソースへの CRUD を行うコードを定義している • Azure Resource Manager の知識が重要
おわりに • まだまだ機能が抜け落ちてる部分が多いので貢献しましょう • Issue を立ててリアクションを集めるのも貢献 • CI がガチガチに組まれている安心感 •
コーディングスタイルが統一されて便利でした • HashiCorp の人が丁寧にレビューしてくれました • 負荷を下げるためにスタイルなどはしっかり守る