Skip to content

Commit 2bb1fef

Browse files
authored
Update NetworkingScenariosGF.md
1 parent a2ffad3 commit 2bb1fef

File tree

1 file changed

+39
-38
lines changed

1 file changed

+39
-38
lines changed

cd3_automation_toolkit/documentation/user_guide/learn_more/NetworkingScenariosGF.md

Lines changed: 39 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,10 @@ Before you start with Network Creation, make sure you have run 'Fetch Compartmen
77

88
### 1. Create Network
99
Creation of Networking components using Automation Toolkit involes four simple steps.
10-
- Feeding the details of networking resources to Excel.
10+
- Add the networking resource details to appropriate Excel Sheets.
1111
- Running the toolkit to generate auto.tfvars.
1212
- Executing Terraform commands to provision the resources in OCI.
13-
- Exporting the details of Security Rules and Route Rules to CD3 Excel Sheet.
13+
- Exporting the details of Security Rules and Route Rules to CD3 Excel Sheet as they are generated automatically by the toolkit and needs to be updated in CD3 Excel sheet,
1414

1515
Below are the steps in detail to create Network that includes VCNs, Subnets, DHCP, DRG, Security List, Route Tables, DRG Route Tables, NSGs, etc.
1616

@@ -35,7 +35,7 @@ Below are the steps in detail to create Network that includes VCNs, Subnets, DHC
3535

3636
```python setUpOCI.py /cd3user/tenancies/<customer_name>/<customer_name>_setUpOCI.properties```
3737

38-
7. Choose _'Network'_ from the displayed menu. Choose below sub-options:
38+
7. Choose _'Network'_ from the displayed menu. Choose below sub-options: (Make sure to choose all the three optionsfor the first time)
3939
- Security Rules
4040
- Export Security Rules (From OCI into SecRulesinOCI sheet)
4141
- Route Rules
@@ -59,7 +59,7 @@ In some scenarios, a DRG has already been created in the tenancy and rest of the
5959
Continue executing the remaining steps of [Create Network](#1-create-network).
6060

6161
### 2. Modify Network
62-
Modifying the Networking components using Automation Toolkit involes three simple steps.
62+
Modifying the Networking components using Automation Toolkit involves three simple steps.
6363
- Add/modify the details of networking components like the VCNs, Subnets, DHCP and DRG in Excel Sheet.
6464
- Running the toolkit to generate auto.tfvars.
6565
- Executing Terraform commands to provision/modify the resources in OCI.
@@ -84,8 +84,41 @@ _Steps in detail_:
8484

8585
This completes the modification of Networking components in OCI. Verify the components in console.
8686

87-
### 3. Export the Security, Route Rules and DRG Route Rules
88-
Once you have the Networking components created in OCI, the user may also choose to add, modify or delete rules in OCI Console manually at any point in time. Once all the desired changes are complete with respect to rules, follow the process to export the rules to the same CD3 Excel Sheet as the one used to Create Network and sync the Terraform files with OCI.
87+
### 3. Modify Security Rules, Route Rules and DRG Route Rules
88+
89+
Follow the below steps to add, update or delete the following components:
90+
- Security Lists and Security Rules
91+
- Route Table and Route Rules
92+
- DRG Route Table and DRG Route Rules
93+
94+
1. Modify your excel sheet to update required data in the Tabs - RouteRulesInOCI, SecRulesInOCI, DRGRouteRulesInOCI tabs.
95+
96+
2. Execute the _setupOCI.py_ file with _non_gf_tenancy_ parameter value to _false_:
97+
98+
```python setUpOCI.py /cd3user/tenancies/<customer_name>/<customer_name>_setUpOCI.properties```
99+
100+
4. Choose _'Network'_ from the displayed menu. Choose below sub-options:
101+
- Security Rules
102+
- Add/Modify/Delete Security Rules (Reads SecRulesinOCI sheet)
103+
- Route Rules
104+
- Add/Modify/Delete Route Rules (Reads RouteRulesinOCI sheet)
105+
- DRG Route Rules
106+
- Add/Modify/Delete DRG Route Rules (Reads DRGRouteRulesinOCI sheet)
107+
108+
Once the execution is successful, _<customer\_name>\_seclists.auto.tfvars_, _<customer\_name>\_routetables.auto.tfvars_ and _<customer\_name>\_drg-routetables.auto.tfvars_ file will be generated under the folder _/cd3user/tenancies/<customer\_name>/terraform_files/<region_dir>_. Existing files will move into respective backup folders.
109+
110+
**NOTE**: This will create TF for only those Security Lists and Route Tables in VCNs which are part of cd3 and skip any VCNs that have been created outside of cd3 execution.
111+
112+
Navigate to the above path and execute the terraform commands:<br>
113+
<br>_terraform init_
114+
<br>_terraform plan_
115+
<br>_terraform apply_
116+
117+
This completes the modification of Security Rules, Route Rules and DRG Route Rules in OCI. Verify the components in console.
118+
119+
120+
### 4. Export the Security Rules, Route Rules and DRG Route Rules to sync the manual changes in OCI with CD3 Excel Sheet and Terraform
121+
Follow the below process to export the rules to the same CD3 Excel Sheet as the one used to Create Network, and to sync the Terraform files with OCI whenever an user adds, modifies or deletes rules in OCI Console manually.
89122

90123
**NOTE**: Make sure to close your Excel sheet during the export process.
91124

@@ -120,38 +153,6 @@ Once you have the Networking components created in OCI, the user may also choose
120153

121154
This completes the export of Security Rules, Route Rules and DRG Route Rules from OCI. Terraform plan/apply should be in sync with OCI.
122155

123-
### 4. Modify Security Rules, Route Rules and DRG Route Rules
124-
125-
Follow the below steps to add, update or delete the following components:
126-
- Security Lists and Security Rules
127-
- Route Table and Route Rules
128-
- DRG Route Table and DRG Route Rules
129-
130-
1. Modify your excel sheet to update required data in the Tabs - RouteRulesInOCI, SecRulesInOCI, DRGRouteRulesInOCI tabs.
131-
132-
2. Execute the _setupOCI.py_ file with _non_gf_tenancy_ parameter value to _false_:
133-
134-
```python setUpOCI.py /cd3user/tenancies/<customer_name>/<customer_name>_setUpOCI.properties```
135-
136-
4. Choose _'Network'_ from the displayed menu. Choose below sub-options:
137-
- Security Rules
138-
- Add/Modify/Delete Security Rules (Reads SecRulesinOCI sheet)
139-
- Route Rules
140-
- Add/Modify/Delete Route Rules (Reads RouteRulesinOCI sheet)
141-
- DRG Route Rules
142-
- Add/Modify/Delete DRG Route Rules (Reads DRGRouteRulesinOCI sheet)
143-
144-
Once the execution is successful, _<customer\_name>\_seclists.auto.tfvars_, _<customer\_name>\_routetables.auto.tfvars_ and _<customer\_name>\_drg-routetables.auto.tfvars_ file will be generated under the folder _/cd3user/tenancies/<customer\_name>/terraform_files/<region_dir>_. Existing files will move into respective backup folders.
145-
146-
**NOTE**: This will create TF for only those Security Lists and Route Tables in VCNs which are part of cd3 and skip any VCNs that have been created outside of cd3 execution.
147-
148-
Navigate to the above path and execute the terraform commands:<br>
149-
<br>_terraform init_
150-
<br>_terraform plan_
151-
<br>_terraform apply_
152-
153-
This completes the modification of Security Rules, Route Rules and DRG Route Rules in OCI. Verify the components in console.
154-
155156

156157
### 5. Add/Modify/Delete NSGs
157158
Follow the below steps to update NSGs.

0 commit comments

Comments
 (0)