buildIT

Automate creation of basic Terraform scripts for IBM IT architecture resources.

Overview

• Terraform data is maintained in spreadsheets where possible and transformed from spreadsheets into Terraform resources.
• Using spreadsheets improves viewability and maintainability of Terraform.
• Example webappvpc includes use of Terraform cloudinits and Ansible Playbooks to configure applications.
• Provided with no formal support but problems can be reported by opening a GitHub issue.
• Data format is subject to change.

Implementation

1. For column names, asterisk denotes a required field.
2. For complex lists, add number to group name in new column (e.g. network_interfaces2.subnet).
3. For data fields, values are copied directly to generated Terraform.
4. For sheet names, use either basename (e.g. instances) or basename-groupname (e.g. instances-group1).
5. For OS images, variables-system sheet is provided for reference but is subject to change.
6. For changed data, regenerate Terraform and let Terraform handle changes.
7. For directory backups, when generating Terraform an existing directory is backed up to directory.backupNNN.

Prerequisites

1. Terraform 1.1.9
2. Ansible 2.9.23
3. Python 3.10.5

Usage (Transitioning to Schematics)

1. Install prerequisites
2. Deploy Infrastructure using Terraform
3. Configure applications using Ansible

References

• drawIT
• IT Architecture Diagrams
• Code Pattern

License

This application is licensed under the Apache License, Version 2. Separate third-party code objects invoked by this application are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 and the Apache License, Version 2.