You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-49Lines changed: 16 additions & 49 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,10 @@
2
2
3
3
This terraform module is designed to deploy azure Windows or Linux virtual machines with Public IP, Availability Set and Network Security Group support.
4
4
5
-
These types of resources supported:
5
+
> **[NOTE]**
6
+
> **This module now supports the meta arguments including `providers`, `depends_on`, `count`, and `for_each`.**
@@ -17,9 +20,14 @@ These types of resources supported:
17
20
## Module Usage
18
21
19
22
```hcl
23
+
# Azurerm provider configuration
24
+
provider "azurerm" {
25
+
features {}
26
+
}
27
+
20
28
module "virtual-machine" {
21
29
source = "kumarvna/virtual-machine/azurerm"
22
-
version = "2.1.0"
30
+
version = "2.2.0"
23
31
24
32
# Resource Group, location, VNet and Subnet details
25
33
resource_group_name = "rg-shared-westeurope-01"
@@ -115,7 +123,7 @@ If the pre-defined Windows or Linux variants are not sufficient then, you can sp
115
123
```hcl
116
124
module "virtual-machine" {
117
125
source = "kumarvna/virtual-machine/azurerm"
118
-
version = "2.1.0"
126
+
version = "2.2.0"
119
127
120
128
# .... omitted
121
129
@@ -207,7 +215,7 @@ In the Source and Destination columns, `VirtualNetwork`, `AzureLoadBalancer`, an
207
215
```hcl
208
216
module "virtual-machine" {
209
217
source = "kumarvna/virtual-machine/azurerm"
210
-
version = "2.1.0"
218
+
version = "2.2.0"
211
219
212
220
# .... omitted
213
221
@@ -235,55 +243,14 @@ module "virtual-machine" {
235
243
236
244
## Recommended naming and tagging conventions
237
245
238
-
Well-defined naming and metadata tagging conventions help to quickly locate and manage resources. These conventions also help associate cloud usage costs with business teams via chargeback and show back accounting mechanisms.
246
+
Applying tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Each tag consists of a name and a value pair. For example, you can apply the name `Environment` and the value `Production` to all the resources in production.
247
+
For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.
239
248
240
-
### Resource naming
249
+
>**Important** :
250
+
Tag names are case-insensitive for operations. A tag with a tag name, regardless of the casing, is updated or retrieved. However, the resource provider might keep the casing you provide for the tag name. You'll see that casing in cost reports. **Tag values are case-sensitive.**
241
251
242
252
An effective naming convention assembles resource names by using important resource information as parts of a resource's name. For example, using these [recommended naming conventions](https://docs.microsoft.com/en-us/azure/cloud-adoption-framework/ready/azure-best-practices/naming-and-tagging#example-names), a public IP resource for a production SharePoint workload is named like this: `pip-sharepoint-prod-westus-001`.
243
253
244
-
> ### Metadata tags
245
-
246
-
When applying metadata tags to the cloud resources, you can include information about those assets that couldn't be included in the resource name. You can use that information to perform more sophisticated filtering and reporting on resources. This information can be used by IT or business teams to find resources or generate reports about resource usage and billing.
247
-
248
-
The following list provides the recommended common tags that capture important context and information about resources. Use this list as a starting point to establish your tagging conventions.
249
-
250
-
Tag Name|Description|Key|Example Value|Required?
251
-
--------|-----------|---|-------------|---------|
252
-
Project Name|Name of the Project for the infra is created. This is mandatory to create a resource names.|ProjectName|{Project name}|Yes
253
-
Application Name|Name of the application, service, or workload the resource is associated with.|ApplicationName|{app name}|Yes
254
-
Approver|Name Person responsible for approving costs related to this resource.|Approver|{email}|Yes
255
-
Business Unit|Top-level division of your company that owns the subscription or workload the resource belongs to. In smaller organizations, this may represent a single corporate or shared top-level organizational element.|BusinessUnit|FINANCE, MARKETING,{Product Name},CORP,SHARED|Yes
256
-
Cost Center|Accounting cost center associated with this resource.|CostCenter|{number}|Yes
257
-
Disaster Recovery|Business criticality of this application, workload, or service.|DR|Mission Critical, Critical, Essential|Yes
258
-
Environment|Deployment environment of this application, workload, or service.|Env|Prod, Dev, QA, Stage, Test|Yes
259
-
Owner Name|Owner of the application, workload, or service.|Owner|{email}|Yes
260
-
Requester Name|User that requested the creation of this application.|Requestor| {email}|Yes
261
-
Service Class|Service Level Agreement level of this application, workload, or service.|ServiceClass|Dev, Bronze, Silver, Gold|Yes
262
-
Start Date of the project|Date when this application, workload, or service was first deployed.|StartDate|{date}|No
263
-
End Date of the Project|Date when this application, workload, or service is planned to be retired.|EndDate|{date}|No
264
-
265
-
> This module allows you to manage the above metadata tags directly or as an variable using `variables.tf`. All Azure resources which support tagging can be tagged by specifying key-values in argument `tags`. Tag `ResourceName` is added automatically to all resources.
266
-
267
-
```hcl
268
-
module "virtual-machine" {
269
-
source = "kumarvna/virtual-machine/azurerm"
270
-
version = "2.1.0"
271
-
272
-
# Resource Group, location, VNet and Subnet details
0 commit comments