Skip to content

Commit 928b012

Browse files
xs2suruchixs2suruchi
authored
Merge pull request #88 from oracle-devrel/develop
Automation Toolkit Release v2024.1.0
2 parents 7db16a3 + cc95df2 commit 928b012

File tree

8 files changed

+34
-24
lines changed

8 files changed

+34
-24
lines changed

‎README.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@
22

33
[![License: UPL](https://img.shields.io/badge/license-UPL-green)](https://img.shields.io/badge/license-UPL-green) [![Quality gate](https://sonarcloud.io/api/project_badges/quality_gate?project=oracle-devrel_cd3-automation-toolkit)](https://sonarcloud.io/dashboard?id=oracle-devrel_cd3-automation-toolkit)
44
<ul>
5+
<kbd>
6+
<img width="1018" alt="Screenshot 2024-02-06 at 1 11 21 PM" src="https://github.com/oracle-devrel/cd3-automation-toolkit/assets/103508105/f989efee-45cc-413b-a706-e1bfe7f2a8fc">
7+
</kbd><br><br>
58
<li> <a href= "#introduction">Introduction</a></li>
69
<li> <a href = "https://github.com/oracle-devrel/cd3-automation-toolkit/releases/tag/v2024.1.0">What's new in this release</a></li>
710
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/learn_more/CD3ExcelTabs.md">Toolkit Supported OCI Services</a></li>
@@ -51,7 +54,7 @@
5154
### Existing Users
5255
<ul>
5356
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/Upgrade_Toolkit.md">Steps to Upgrade Your Toolkit</a></li>
54-
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/Jobs_Migration.md">Migrating Jenkins Jobs</a></li>
57+
5558
</ul>
5659

5760
### Videos
@@ -72,20 +75,21 @@
7275
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/learn_more/CISFeatures.md">Additional CIS Compliance Features</a></li>
7376
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/learn_more/SupportForCD3Validator.md">CD3 Validator Features</a></li>
7477
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/learn_more/SupportforAdditionalAttributes.md">Support for Additional Attributes</a></li>
78+
<li> <a href = "/cd3_automation_toolkit/documentation/user_guide/Jobs_Migration.md">Migrate Jenkins configuration to Customer Environment</a></li>
7579
</ul>
76-
80+
81+
<br>
82+
7783
## Introduction
7884
CD3 stands for <b>C</b>loud <b>D</b>eployment <b>D</b>esign <b>D</b>eliverable.
7985
The CD3 Automation toolkit has been developed to help in automating the OCI resource object management.
8086
<br><br>
8187
It reads input data in the form of CD3 Excel sheet and generates 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. The toolkit can be used throughout the lifecycle of tenancy to continuously create or modify existing resources. The generated Terraform code can be used by the OCI Resource Manager or can be integrated into organization's existing devops CI/CD ecosystem.
8288
<br><br>
8389
<kbd>
84-
<img width="923" alt="Screenshot 2024-02-02 at 8 23 51 PM" src="https://github.com/oracle-devrel/cd3-automation-toolkit/assets/103508105/c2d06575-1bcb-4cb3-9c49-682bf19f3ac9">
85-
90+
<img width="1018" alt="Screenshot 2024-02-06 at 1 11 21 PM" src="https://github.com/oracle-devrel/cd3-automation-toolkit/assets/103508105/f989efee-45cc-413b-a706-e1bfe7f2a8fc">
8691
</kbd>
8792
<br>
88-
8993
#### OCI Services Currently Supported by Automation Toolkit
9094

9195
| OCI Services | Details |

‎cd3_automation_toolkit/documentation/user_guide/Intro-Jenkins.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Below table shows the stages executed in this pipeline along with their descript
3535
### 2. terraform_files Folder
3636

3737
This is equivalent to **/cd3user/tenancies/<customer_name>/terraform_files** folder on your local system.
38-
The region directories along with all service directories, are present under this terraform_files folder.
38+
The region directories along with all service directories, are present under this terraform_files folder. The toolkit will generate the .tfvars files for all resources under the service directory.
3939
Inside each service directory, pipelines for **terraform-apply** and **terraform-destroy** are present.
4040

4141
The terraform pipelines are either triggered automatically from setUpOCI pipeline or they can be triggered manually by navigating to any service directory path.

‎cd3_automation_toolkit/documentation/user_guide/Launch_Docker_container.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ To ease the execution of toolkit, we have provided the steps to build an image w
3333
Eg for Mac: ```docker run --platform linux/amd64 -it -p 8443:8443 -d -v /Users/<user_name>/mount_path:/cd3user/tenancies cd3toolkit:v2024.1.0```
3434

3535
Eg for Windows: ```docker run --platform linux/amd64 -it -p 8443:8443 -d -v D:/mount_path:/cd3user/tenancies cd3toolkit:v2024.1.0```
36+
37+
> If you are launching the container on cloud, Please make sure to use a private server or a bastion connected server with restricted access(i.e. not publicly available) to host the container.
3638
3739
* Run ```docker ps```
3840

‎cd3_automation_toolkit/documentation/user_guide/LearningVideos.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
# Automation Toolkit Learning Videos
22

33
* [CD3 Automation Toolkit Explained in 1 minute](https://www.youtube.com/watch?v=TSNu0pUHYsE&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=1)
4-
* [Introduction to Automation Toolkit Part 1](https://www.youtube.com/watch?v=rwxjbYWNbTo&t=57s)
5-
* [How to Install and Configure Rancher Desktop Part 2](https://www.youtube.com/watch?v=2QNAOJpeJZc)
6-
* [How to Create the Image and Run the container with CD3 Part 3](https://www.youtube.com/watch?v=FUUiSZmDFI4)
7-
* [How to Connect the Container to Tenancy with CD3 Part 4](https://www.youtube.com/watch?v=Nv3oXhrDnoU&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=5)
8-
* [How to Group Generated Terraform Files Part 5](https://www.youtube.com/watch?v=iASN7ZTbOKQ&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=6)
9-
* [How to use CD3 Excel Sheets Part 6](https://www.youtube.com/watch?v=79laRDhvKiE&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=7)
10-
* [What Are Greenfield Tenancies? Part 7](https://www.youtube.com/watch?v=8wecHuY08Ps&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=8)
11-
* [How to upload CD3 stack to Resource Manager Part 8](https://www.youtube.com/watch?v=OifKu-t57CU&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=9)
12-
* [Management Services - CD3 Automation Toolkit Part 9](https://www.youtube.com/watch?v=wFkECxy209s&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=10)
13-
* [Non-Greenfield Tenancies - CD3 Automation Toolkit Part 10](https://www.youtube.com/watch?v=l_lUEF3XYoM&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=11)
14-
* [Support for Additional Attributes - CD3 Automation toolkit Part 11](https://www.youtube.com/watch?v=6bWWbchS2vk&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=12)
15-
* [Provisioning of OCI Object Storage Buckets - CD3 Automation toolkit Part 12](https://youtu.be/1lVQw3pDp4U)
16-
* [Configuring OCI Private DNS - CD3 Automation toolkit Part 13](https://youtu.be/RE-36ip68ZE)
4+
* [Part 1- Introduction to CD3 Automation Toolkit](https://www.youtube.com/watch?v=rwxjbYWNbTo&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=3)
5+
* [Part 2 - How to Install and Configure Rancher Desktop with CD3](https://www.youtube.com/watch?v=2QNAOJpeJZc&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=3)
6+
* [Part 3 - How to Create the Image and Run the Container with CD3](https://www.youtube.com/watch?v=FUUiSZmDFI4&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=4)
7+
* [Part 4 - Connect CD3 Automation toolkit container to OCI tenancy](https://www.youtube.com/watch?v=E_9RRokDiUs&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=5)
8+
* [Part 5 - How to use CD3 Excel Sheets](https://www.youtube.com/watch?v=79laRDhvKiE&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=6)
9+
* [Part 6 - Execute the CD3 Automation toolkit using CLI to create resources in OCI](https://www.youtube.com/watch?v=pnPy1edO278&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=7)
10+
* [Part 7 - Execute CD3 Automation Toolkit using CLI to export resources in OCI](https://www.youtube.com/watch?v=v54HfX-Pvys&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=8)
11+
* [Part 8 - Execute the CD3 Automation toolkit using Jenkins to create resources in OCI](https://www.youtube.com/watch?v=buchK2gfTpk&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=9)
12+
* [Part 9 - Execute the CD3 Automation toolkit using Jenkins to export resources from OCI](https://www.youtube.com/watch?v=p4NGLAMs5us&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=10)
13+
* [Part 10 - Support for Additional Attributes - CD3 Automation toolkit](https://www.youtube.com/watch?v=6bWWbchS2vk&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=11)
14+
* [Configuring OCI Private DNS using CD3](https://www.youtube.com/watch?v=9Ie4t4TzgqQ&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=12)
15+
* [Provisioning OCI Object storage Buckets using CD3](https://www.youtube.com/watch?v=NOexp3lqxHU&list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp&index=13)
1716

18-
<br>[Here](https://www.youtube.com/playlist?list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp) is the Youtube playlist link for all these videos.
17+
<br>[Here](https://www.youtube.com/playlist?list=PLPIzp-E1msrbJ3WawXVhzimQnLw5iafcp) is the Youtube playlist link for all these videos.

‎cd3_automation_toolkit/documentation/user_guide/NonGreenField-Jenkins.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
# Export Resources from OCI via Jenkins(Non-Greenfield Workflow)
22

3+
>Note: Please make sure that service for which export is done does not have existing tfvars/state file.
34
45
**Step 1**:
56
<br>Choose the appropriate CD3 Excel sheet template from [Excel Templates](/cd3_automation_toolkit/documentation/user_guide/ExcelTemplates.md)

‎cd3_automation_toolkit/documentation/user_guide/NonGreenField.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Export Resources from OCI (Non-Greenfield Workflow)
22

3-
> **Note**
4-
3+
> **Note**<br>
4+
Please make sure that service for which export is done does not have existing tfvars/state file.<br><br>
55
>Course of actions involved in Exporting objects from OCI-
66
> * Automation Tool Kit fetches the data for the supported services. You can chose to export the data from a specific region or the compartment. Exported data is written to appropriate sheets of the CD3 Excel Sheet based on the resources being exported.
77
> * Tool Kit then generates the TF configuration files/auto.tfvars files for these exported resources.

‎cd3_automation_toolkit/documentation/user_guide/Workflows-jenkins.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ Jenkins integraton with the toolkit is provided to jump start your journey with
2020
> Notes:
2121
> - \<Port> is the port mapped with local system while docker container creation Eg: 8443.
2222
> - Network Connectivity should be allowed on this host and port.
23+
> - Please make sure to use a private server or a bastion connected server with restricted access(i.e. not publicly available).
2324
- It will prompt you to create first user to access Jenkins URL. This will be the admin user.
2425
- The Automation Toolkit only supports a single user Jenkins setup in this release.
2526
- Once you login, Jenkins Dashbord will be displayed.

‎cd3_automation_toolkit/documentation/user_guide/remote_state.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,11 @@
3232
}
3333
```
3434

35-
* For single outdir, tfstate for all subscribed regions will be stored as ```<region>\terraform.tfstate``` eg ```london\terraform.tfstate``` for london ```phoenix\terraform.tfstate``` for phoenix.
36-
* For multi outdir, tfstate for all services in all subscribed regions will be stored as ```<region>\<service_dir_name>\terraform.tfstate``` eg ```london\tagging\terraform.tfstate``` for tagging dir in london region
35+
* For single outdir, tfstate for all subscribed regions will be stored as ```<region>/terraform.tfstate``` eg ```london/terraform.tfstate``` for london ```phoenix/terraform.tfstate``` for phoenix. See below screenshot showing objects in the bucket storing remote state:
36+
<img width="1297" alt="Screenshot 2024-02-06 at 8 07 45 PM" src="https://github.com/oracle-devrel/cd3-automation-toolkit/assets/103508105/79c6939c-d785-43e7-99a3-41a95cf90cc8">
37+
38+
* For multi outdir, tfstate for all services in all subscribed regions will be stored as ```<region>/<service_dir_name>/terraform.tfstate``` eg ```london/tagging/terraform.tfstate``` for tagging dir in london region. See below screenshot showing objects in the bucket storing remote state:
39+
<img width="1485" alt="Screenshot 2024-02-06 at 3 57 02 PM" src="https://github.com/oracle-devrel/cd3-automation-toolkit/assets/103508105/ee7dd418-f998-4ee8-bfe9-f7bd7d0e30ff">
3740

3841
<br><br>
3942
<div align='center'>

0 commit comments

Comments
 (0)