|
5 | 5 | * [What to expect](#what-to-expect) |
6 | 6 | * [Prerequisites](#prerequisites) |
7 | 7 | * [Usage](#usage) |
| 8 | +* [Terraform Overview](#terraform-overview) |
8 | 9 | * [Author Information](#author-information) |
9 | 10 | * [License](#license) |
10 | 11 |
|
@@ -101,7 +102,7 @@ git clone https://github.com/NetApp/FSx-ONTAP-samples-scripts.git |
101 | 102 |
|
102 | 103 | ### 2. Navigate to the directory |
103 | 104 | ```shell |
104 | | -cd Terraform/fsx-ontap-filesystem/standalone-module |
| 105 | +cd FSx-ONTAP-samples-scripts/Terraform/deploy-fsx-ontap/standalone-module |
105 | 106 | ``` |
106 | 107 |
|
107 | 108 | ### 3. Initialize Terraform |
@@ -137,48 +138,58 @@ You can see that Terraform recognizes the modules required by our configuration: |
137 | 138 | preferences and save the file. This will ensure that the Terraform code deploys resources according to your specifications. |
138 | 139 |
|
139 | 140 | **Make sure to replace the values with ones that match your AWS environment and needs.** |
| 141 | +Modify the remaining optional variables (e.g. defining AD) in the **`main.tf`** file and remove commenting |
| 142 | +where needed according to the explanations in-line. |
140 | 143 |
|
141 | | -- Modify the remaining optional variables in the **`main.tf`** file and remove commenting where needed according to the explanations in-line. |
| 144 | +### 5. Update Security Group |
| 145 | +A default security group is defined in the "security_groups.tf" file. At the top of |
| 146 | +that file you can see where you can specify either a CIDR block or a security group ID |
| 147 | +to allow access to the FSxN file system. Do not specify both, as it will cause |
| 148 | +the terraform deployment to fail. |
142 | 149 |
|
143 | | -### 5. Create a Terraform plan |
| 150 | +If you decide you don't want to use the security group, you can either delete the security_groups.tf file, |
| 151 | +or just rename it such that it doesn't end with ".tf" (e.g. security_groups.tf.kep). You will also need |
| 152 | +to update the `security_group_ids = [aws_security_group.fsx_sg.id]` line in the main.tf file |
| 153 | +to reference the security group(s) you want to use. |
| 154 | +
|
| 155 | +### 6. Create a Terraform plan |
144 | 156 | Run the following command to create an execution plan, which lets you preview the changes that Terraform plans to make to your infrastructure: |
145 | 157 | ```shell |
146 | 158 | terraform plan |
147 | 159 | ``` |
148 | 160 | Ensure that the proposed changes match what you expected before you apply the changes! |
149 | 161 |
|
150 | | -### 6. Apply the Terraform plan |
| 162 | +### 7. Apply the Terraform plan |
151 | 163 | Run the following command to execute the Terrafom code and apply the changes proposed in the `plan` step: |
152 | 164 | ```shell |
153 | 165 | terraform apply |
154 | 166 | ``` |
155 | 167 |
|
156 | 168 | <!-- BEGIN_TF_DOCS --> |
157 | 169 |
|
158 | | -## Repository Overview |
| 170 | +## Terraform Overview |
159 | 171 |
|
160 | 172 | ### Providers |
161 | 173 |
|
162 | 174 | | Name | Version | |
163 | 175 | |------|---------| |
164 | 176 | | aws | 5.25.0 | |
165 | | -| aws.secrets | 5.25.0 | |
166 | 177 |
|
167 | 178 | ### Inputs |
168 | 179 |
|
169 | | -| Name | Description | Type | Default | Required | |
170 | | -|------|-------------|------|---------|:--------:| |
171 | | -| aws_secretsmanager_region | The AWS region where the secret is stored. | `string` | `"us-east-2"` | no | |
172 | | -| fsx_capacity_size_gb | The storage capacity (GiB) of the FSxN file system. Valid values between 1024 and 196608. | `number` | `1024` | no | |
173 | | -| fsx_deploy_type | The filesystem deployment type. Supports MULTI_AZ_1 and SINGLE_AZ_1 | `string` | `"MULTI_AZ_1"` | no | |
174 | | -| fsx_name | The deployed filesystem name | `string` | `"terraform-fsxn"` | no | |
175 | | -| fsx_region | The AWS region where the FSxN file system to be deployed. | `string` | `"us-west-2"` | no | |
176 | | -| fsx_secret_name | The name of the AWS SecretManager secret that holds the ONTAP administrative password for the fsxadmin user that you can use to administer your file system using the ONTAP CLI and REST API. | `string` | `"fsx_secret"` | no | |
177 | | -| fsx_subnets | A list of IDs for the subnets that the file system will be accessible from. Up to 2 subnets can be provided. | `map(any)` | <pre>{<br> "primarysub": "subnet-22222222",<br> "secondarysub": "subnet-22222222"<br>}</pre> | no | |
178 | | -| fsx_tput_in_MBps | The throughput capacity (in MBps) for the file system. Valid values are 128, 256, 512, 1024, 2048, and 4096. | `number` | `128` | no | |
179 | | -| svm_name | The name of the Storage Virtual Machine | `string` | `"first_svm"` | no | |
180 | | -| vol_info | Details for the volume creation | `map(any)` | <pre>{<br> "cooling_period": 31,<br> "efficiency": true,<br> "junction_path": "/vol1",<br> "size_mg": 1024,<br> "tier_policy_name": "AUTO",<br> "vol_name": "vol1"<br>}</pre> | no | |
181 | | -| vpc_id | The ID of the VPC in which the FSxN fikesystem should be deployed | `string` | `"vpc-11111111"` | no | |
| 180 | +| Name | Description | Type | Default | Must be changed | |
| 181 | +|------|-------------|------|---------|-----------------| |
| 182 | +| aws_secretsmanager_region | The AWS region where the secret is stored. | `string` | `"us-east-2"` | No | |
| 183 | +| fsx_capacity_size_gb | The storage capacity (GiB) of the FSxN file system. Valid values between 1024 and 196608. | `number` | `1024` | No | |
| 184 | +| fsx_deploy_type | The filesystem deployment type. Supports MULTI_AZ_1 and SINGLE_AZ_1 | `string` | `"MULTI_AZ_1"` | No | |
| 185 | +| fsx_name | The deployed filesystem name | `string` | `"terraform-fsxn"` | No | |
| 186 | +| fsx_region | The AWS region where the FSxN file system to be deployed. | `string` | `"us-west-2"` | No | |
| 187 | +| fsx_secret_name | The name of the AWS SecretManager secret that holds the ONTAP administrative password for the fsxadmin user that you can use to administer your file system using the ONTAP CLI and REST API. | `string` | `"fsx_secret"` | Yes | |
| 188 | +| fsx_subnets | A list of IDs for the subnets that the file system will be accessible from. Up to 2 subnets can be provided. | `map(any)` | <pre>{<br> "primarysub": "subnet-22222222",<br> "secondarysub": "subnet-22222222"<br>}</pre> | Yes | |
| 189 | +| fsx_tput_in_MBps | The throughput capacity (in MBps) for the file system. Valid values are 128, 256, 512, 1024, 2048, and 4096. | `number` | `128` | No | |
| 190 | +| svm_name | The name of the Storage Virtual Machine | `string` | `"first_svm"` | No | |
| 191 | +| vol_info | Details for the volume creation | `map(any)` | <pre>{<br> "cooling_period": 31,<br> "efficiency": true,<br> "junction_path": "/vol1",<br> "size_mg": 1024,<br> "tier_policy_name": "AUTO",<br> "vol_name": "vol1"<br>}</pre> | No | |
| 192 | +| vpc_id | The ID of the VPC in which the FSxN fikesystem should be deployed | `string` | `"vpc-11111111"` | Yes | |
182 | 193 |
|
183 | 194 | ### Outputs |
184 | 195 |
|
|
0 commit comments