How to contribute to terraform-provider-aws Takeshi Kondo SRE at Quipper 2019/08/01 Terraform Meetup Tokyo#1 

No content

• Run test • Set debug • Read code • Read Issue • Read Pull Request 

Merged 3 Pull Requests 

Merged 3 Pull Requests See my blog for details: Google “πφϫλϦϚΠϥΠϑ” - Terraform importͷ࣮૷ - Terraform aws provider PR / lambdaͷnode engine v6.10ͷEOLରԠ 

• Join Terraform Source Code Reading • Join #codereading at Terraform-jp slack 

Agenda • Basic source code structure • 4 Steps of preparing • 6 Steps of contributing 

Agenda • Basic source code structure • 4 Steps of preparing • 6 Steps of contributing 

Basic source code structure • terraform-provider-aws • aws/ • data_source_aws_iam_policy.go • data_source_aws_iam_policy_test.go • resource_aws_iam_policy.go • resource_aws_iam_policy_test.go • website/ %FpOFE
w $SFBUF
w 3FBE
w 6QEBUF
w %FMFUF
w *NQPSUFS 

Agenda • Basic source code structure • 4 Steps of preparing • 6 Steps of contributing 

4 Steps of preparing • Clone and build • Set debug • Run test • Push to fork 

4 Steps of preparing • Clone and build • Set debug • Run test • Push to fork 

Clone and build (Thanks @minamijoyo) • git clone [email protected]:hashicorp/terraform.git • cd terraform • git checkout v0.12.3 • export GO111MODULE=on • make dev -> $GOPATH/bin/terraform • git clone [email protected]:terraform-providers/ terraform-provider-aws.git • cd terraform-provider-aws • git checkout v2.21.1 • export GO111MODULE=off • make • See Hackmd for details • https://hackmd.io/HeEmX_dPQAaEANhiH1lKQQ?view 

4 Steps of preparing • Clone and build • Set debug • Run test • Push to fork 

Set debug (Thanks @minamijoyo) • Terraform/main.go • terraform-provider-aws/main.go func main() { + log.SetFlags(log.Llongfile) // Override global prefix set by go-dynect during init() log.SetPrefix("") os.Exit(realMain()) import ( "github.com/hashicorp/terraform/plugin" "github.com/terraform-providers/terraform-provider-aws/aws" + "log" ) func main() { + log.SetFlags(log.Llongfile) plugin.Serve(&plugin.ServeOpts{ ProviderFunc: aws.Provider}) } 

Set debug (Thanks @minamijoyo) • Terraform/main.go • terraform-provider-aws/main.go func main() { + log.SetFlags(log.Llongfile) // Override global prefix set by go-dynect during init() log.SetPrefix("") os.Exit(realMain()) import ( "github.com/hashicorp/terraform/plugin" "github.com/terraform-providers/terraform-provider-aws/aws" + "log" ) func main() { + log.SetFlags(log.Llongfile) plugin.Serve(&plugin.ServeOpts{ ProviderFunc: aws.Provider}) } • See Hackmd for details • https://hackmd.io/HeEmX_dPQAaEANhiH1lKQQ?view • Terraform৬ਓೖ໳: ೔ʑͷӡ༻ͰֶΜͩ஌ݟΛ ୶ʑͱ·ͱΊΔ / @minamijoyo • TerraformΛσόοά͢Δٕज़ • https://qiita.com/minamijoyo/items/1f57c62bed781ab8f4d7 

4 Steps of preparing • Clone and build • Set debug • Run test • Push to fork 

Run test cat .envrc \ export AWS_PROFILE=“chaspy” make testacc \ TESTARGS=‘-run=TestAccAWSEcsCluster_basic’ Note that resources are actually created and charged for your account 

4 Steps of preparing • Clone and build • Set debug • Run test • Push to fork 

Push to fork • # fork the repository • # terraform-providers/terraform-provider-aws • # -> chaspy/terraform-provider-aws • git remote add fork https://github.com/chaspy/ terraform-provider-aws.git • git push fork 

Agenda • Basic source code structure • 4 Steps of preparing • 6 Steps of contributing 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push • Ask contributor (Thanks @kterada0509) • See “good first issue” label • Recommend: Support import issue 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push 

6 Steps of contributing • Determine the issue you solve • Make a sandbox • Apply the sample code • Reproduce the issue with debug log • Read the reference PR • Read a code and commit and push • Reviewed in a few days • They review kindly 

Conclusion • Anyone can send a pull request • Not afraid of Terraform by contributing • Motivated to use the latest version 

• Join Terraform Source Code Reading • Next: #2 2nd Sep. (Mon) • Join #codereading at Terraform-jp slack 

• @officel / @raki • Organizer of Terraform-jp Special Thanks • @morihaya • Co-organizer meetup • @minamijoyo • Lead code-reading • @kterada0509 / teraken0509 • Lead code-reading 

Thank You! chaspy chaspy_ / chaspy_en Site Reliability Engineer at Quipper Takeshi Kondo SRE Lounge Terraform-jp