vandavilli / cd3-automation-toolkit

The CD3 Automation Toolkit generates Terraform modules from a design spec in an Excel sheet. It also allows a user to export an OCI tenancy into Excel and corresponding TF modules (and associated tfvars)

CD3-Automation-Toolkit

Table of Contents 🔖

1. Introduction
2. Pre-requisites
3. Launch Docker container
4. Connect container to OCI Tenancy
5. Getting Started with Automation Toolkit
6. Using the Automation Toolkit
   • Green Field Tenancies
   • Non-Green Field Tenancies
7. MUST READ...
   • Managing Network for Green Field Tenancies
   • Managing Network for Non Green Field Tenancies
8. Creating independent tfstate files for each resource
9. Expected Behaviour Of Automation Toolkit
10. FAQs
11. Steps to Upgrade Your Toolkit
12. Learn More...
    • CD3 Excel Information
      • Excel Templates
      • Toolkit Supported OCI Services
    • CD3 Validator Features
    • Additional CIS Compliance Features
    • OCI Resource Manager Upload
    • Support for Additional Attributes
13. Automation Toolkit Learning Videos

Introduction

CD3 stands for Cloud Deployment Design Deliverable. The CD3 Automation toolkit has been developed to help in automating the OCI resource object management.

It reads input data in the form of CD3 Excel sheet and generates the terraform files which can be used to provision the resources in OCI instead of handling the task through the OCI console manually. The toolkit also reverse engineers the components in OCI back to the Excel sheet and Terraform configuration. This generated Terraform code can be used by the OCI Resource Manager or leveraged by the organisations’ CI/CD processes.

OCI Services Currently Supported by Automation Toolkit

OCI Services	Details
IAM/Identity	Compartments, Groups, Dynamic Groups, Policies
Network	VCNs, Subnets, DRGs, IGWs, NGWs, LPGs, Route Tables, DRG Route, Tables, Security Lists, Network Security Groups, Application Load Balancer, Network Load Balancers
Governance	Tags (Namespaces, Tag Keys, Defined Tags, Default Tags, Cost Tracking)
Compute	Instances – VM, BM, Dedicated VM Hosts
Storage	FSS, Block and Boot Volumes, Backup Policies
Database	Exa Infra, ExaCS, DB Systems VM and BM, ATP, ADW
Management Services	Events, Notifications, Alarms, Service Connector Hub (SCH)
Developer Services	Resource Manager, Oracle Kubernetes Engine (OKE)
CIS Landing Zone Compliance	Download and Execute CIS Compliance Check Script, VCN Flow Logs, Cloud Guard, Object Storage, Key Vault, Budget

Pre-requisites

• Git
• Any docker CLI compatible platform such as Docker or Rancher.
• Local Directory - A directory in your local system that will be shared with the container to hold the generated Terraform files.
• OCI Tenancy Access Requirement - Appropriate IAM policies must be in place for each of the resources that the user may try to create. Minimum requirement for the user to get started is to have the ability to read to the tenancy.

Click here to get started and manage your OCI Infra!

Contributing

This project is open source. Please submit your contributions by raising an Issue or through Discussion topic in this repository. Currently, we do not accept any pull requests. Oracle appreciates any contributions that are made by the open source community.

License

Copyright (c) 2022 Oracle and/or its affiliates.

Licensed under the Universal Permissive License (UPL), Version 1.0.

See LICENSE for more details.

ORACLE AND ITS AFFILIATES DO NOT PROVIDE ANY WARRANTY WHATSOEVER, EXPRESS OR IMPLIED, FOR ANY SOFTWARE, MATERIAL OR CONTENT OF ANY KIND CONTAINED OR PRODUCED WITHIN THIS REPOSITORY, AND IN PARTICULAR SPECIFICALLY DISCLAIM ANY AND ALL IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. FURTHERMORE, ORACLE AND ITS AFFILIATES DO NOT REPRESENT THAT ANY CUSTOMARY SECURITY REVIEW HAS BEEN PERFORMED WITH RESPECT TO ANY SOFTWARE, MATERIAL OR CONTENT CONTAINED OR PRODUCED WITHIN THIS REPOSITORY. IN ADDITION, AND WITHOUT LIMITING THE FOREGOING, THIRD PARTIES MAY HAVE POSTED SOFTWARE, MATERIAL OR CONTENT TO THIS REPOSITORY WITHOUT ANY REVIEW. USE AT YOUR OWN RISK.