Skip to content

stfnzl/terraform-azurerm-naming

 
 

Repository files navigation

Azure Naming

This module helps you to keep consistency on your resources names for Terraform The goal of this module it is that for each resource that requires a name in Terraform you would be easily able to compose this name using this module and this will keep the consistency in your repositories.

Usage

For every resource in terraform_azurerm just remove the azurerm part of the module and use the name property of this output.

example for azurerm_resource_group you can use :

module "naming" {
  source  = "Azure/naming/azurerm"
  suffix = [ "test" ]
}
resource "azurerm_resource_group" "example" {
  name     = module.naming.resource_group.name
  location = "West Europe"
}

if you want this to be unique for this module and not shared with other instances of this module you can use name_unique

module "naming" {
  source  = "Azure/naming/azurerm"
  suffix = [ "test" ]
}
resource "azurerm_resource_group" "example" {
  name     = module.naming.resource_group.name_unique
  location = "West Europe"
}

Other advanced usages will be explained in the Advanced usage part of this docs.

Internals

Prerequisites and setup

  • Install tflint as suitable for your OS.

  • Run make install in the root directory of the repo.

Modifying resources

The resources are automatically generated using go to change the generation please change the file on the templates folder. To add a new resource, including its definition in the file resourceDefinition.json, and it will be automatically generated when main.go is run.

Current implementation

You can find a list bellow of all the resources that are currently implemented. To get a list of the ones that are missing implementation you can check at Missing resources the resources that have no documentation about their limitation on naming currently on Microsoft docs are on the Not defined list.

Advanced usage

Output

Each one of the resources emits the name of the resource and other properties:

Property Type Description
name string name of the resource including respective suffixes and prefixes applied
name_unique string same as the name but with random chars added for uniqueness
dashes bool if these resources support dashes
slug string letters to identify this resource among others
min_length integer Minimum length required for this resource name
max_length integer Maximum length allowed for this resource name
scope string scope which this name needs to be unique, such as resourcegroup or global
regex string Terraform compatible version of the regex

Example Output

Every resource will have an output with the following format:

postgresql_server = {
      name        = "pre-fix-psql-su-fix"
      name_unique = "pre-fix-psql-su-fix-asdfg"
      dashes      = true
      slug        = "psql"
      min_length  = 3
      max_length  = 63
      scope       = "global"
      regex       = "^[a-z0-9][a-zA-Z0-9-]+[a-z0-9]$"
    }

Requirements

Name Version
random >= 3.3.2

Providers

Name Version
random 3.3.2

Modules

No modules.

Resources

Name Type
random_string.first_letter resource
random_string.main resource

Inputs

Name Description Type Default Required
prefix It is not recommended that you use prefix by azure you should be using a suffix for your resources. list(string) [] no
suffix It is recommended that you specify a suffix for consistency. please use only lowercase characters when possible list(string) [] no
unique-include-numbers If you want to include numbers in the unique generation bool true no
unique-length Max length of the uniqueness suffix to be added number 4 no
unique-seed Custom value for the random characters to be used string "" no

Outputs

Name Description
analysis_services_server Analysis Services Server
api_management Api Management
app_configuration App Configuration
app_service App Service
app_service_plan App Service Plan
application_gateway Application Gateway
application_insights Application Insights
application_security_group Application Security Group
automation_account Automation Account
automation_certificate Automation Certificate
automation_credential Automation Credential
automation_runbook Automation Runbook
automation_schedule Automation Schedule
automation_variable Automation Variable
availability_set Availability Set
bastion_host Bastion Host
batch_account Batch Account
batch_application Batch Application
batch_certificate Batch Certificate
batch_pool Batch Pool
bot_channel_directline Bot Channel Directline
bot_channel_email Bot Channel Email
bot_channel_ms_teams Bot Channel Ms Teams
bot_channel_slack Bot Channel Slack
bot_channels_registration Bot Channels Registration
bot_connection Bot Connection
bot_web_app Bot Web App
cdn_endpoint Cdn Endpoint
cdn_profile Cdn Profile
cognitive_account Cognitive Account
container_group Container Group
container_registry Container Registry
container_registry_webhook Container Registry Webhook
cosmosdb_account Cosmosdb Account
custom_provider Custom Provider
dashboard Dashboard
data_factory Data Factory
data_factory_dataset_mysql Data Factory Dataset Mysql
data_factory_dataset_postgresql Data Factory Dataset Postgresql
data_factory_dataset_sql_server_table Data Factory Dataset Sql Server Table
data_factory_integration_runtime_managed Data Factory Integration Runtime Managed
data_factory_linked_service_data_lake_storage_gen2 Data Factory Linked Service Data Lake Storage Gen2
data_factory_linked_service_key_vault Data Factory Linked Service Key Vault
data_factory_linked_service_mysql Data Factory Linked Service Mysql
data_factory_linked_service_postgresql Data Factory Linked Service Postgresql
data_factory_linked_service_sql_server Data Factory Linked Service Sql Server
data_factory_pipeline Data Factory Pipeline
data_factory_trigger_schedule Data Factory Trigger Schedule
data_lake_analytics_account Data Lake Analytics Account
data_lake_analytics_firewall_rule Data Lake Analytics Firewall Rule
data_lake_store Data Lake Store
data_lake_store_firewall_rule Data Lake Store Firewall Rule
database_migration_project Database Migration Project
database_migration_service Database Migration Service
databricks_cluster Databricks Cluster
databricks_high_concurrency_cluster Databricks High Concurrency Cluster
databricks_standard_cluster Databricks Standard Cluster
databricks_workspace Databricks Workspace
dev_test_lab Dev Test Lab
dev_test_linux_virtual_machine Dev Test Linux Virtual Machine
dev_test_windows_virtual_machine Dev Test Windows Virtual Machine
disk_encryption_set Disk Encryption Set
dns_a_record Dns A Record
dns_aaaa_record Dns Aaaa Record
dns_caa_record Dns Caa Record
dns_cname_record Dns Cname Record
dns_mx_record Dns Mx Record
dns_ns_record Dns Ns Record
dns_ptr_record Dns Ptr Record
dns_txt_record Dns Txt Record
dns_zone Dns Zone
eventgrid_domain Eventgrid Domain
eventgrid_domain_topic Eventgrid Domain Topic
eventgrid_event_subscription Eventgrid Event Subscription
eventgrid_topic Eventgrid Topic
eventhub Eventhub
eventhub_authorization_rule Eventhub Authorization Rule
eventhub_consumer_group Eventhub Consumer Group
eventhub_namespace Eventhub Namespace
eventhub_namespace_authorization_rule Eventhub Namespace Authorization Rule
eventhub_namespace_disaster_recovery_config Eventhub Namespace Disaster Recovery Config
express_route_circuit Express Route Circuit
express_route_gateway Express Route Gateway
firewall Firewall
firewall_application_rule_collection Firewall Application Rule Collection
firewall_ip_configuration Firewall Ip Configuration
firewall_nat_rule_collection Firewall Nat Rule Collection
firewall_network_rule_collection Firewall Network Rule Collection
frontdoor Frontdoor
frontdoor_firewall_policy Frontdoor Firewall Policy
function_app Function App
hdinsight_hadoop_cluster Hdinsight Hadoop Cluster
hdinsight_hbase_cluster Hdinsight Hbase Cluster
hdinsight_interactive_query_cluster Hdinsight Interactive Query Cluster
hdinsight_kafka_cluster Hdinsight Kafka Cluster
hdinsight_ml_services_cluster Hdinsight Ml Services Cluster
hdinsight_rserver_cluster Hdinsight Rserver Cluster
hdinsight_spark_cluster Hdinsight Spark Cluster
hdinsight_storm_cluster Hdinsight Storm Cluster
image Image
iotcentral_application Iotcentral Application
iothub Iothub
iothub_consumer_group Iothub Consumer Group
iothub_dps Iothub Dps
iothub_dps_certificate Iothub Dps Certificate
key_vault Key Vault
key_vault_certificate Key Vault Certificate
key_vault_key Key Vault Key
key_vault_secret Key Vault Secret
kubernetes_cluster Kubernetes Cluster
kusto_cluster Kusto Cluster
kusto_database Kusto Database
kusto_eventhub_data_connection Kusto Eventhub Data Connection
lb Lb
lb_nat_rule Lb Nat Rule
linux_virtual_machine Linux Virtual Machine
linux_virtual_machine_scale_set Linux Virtual Machine Scale Set
local_network_gateway Local Network Gateway
log_analytics_workspace Log Analytics Workspace
logic_app_workflow Logic App Workflow
machine_learning_workspace Machine Learning Workspace
managed_disk Managed Disk
maps_account Maps Account
mariadb_database Mariadb Database
mariadb_firewall_rule Mariadb Firewall Rule
mariadb_server Mariadb Server
mariadb_virtual_network_rule Mariadb Virtual Network Rule
mssql_database Mssql Database
mssql_elasticpool Mssql Elasticpool
mssql_server Mssql Server
mysql_database Mysql Database
mysql_firewall_rule Mysql Firewall Rule
mysql_server Mysql Server
mysql_virtual_network_rule Mysql Virtual Network Rule
network_ddos_protection_plan Network Ddos Protection Plan
network_interface Network Interface
network_security_group Network Security Group
network_security_group_rule Network Security Group Rule
network_security_rule Network Security Rule
network_watcher Network Watcher
notification_hub Notification Hub
notification_hub_authorization_rule Notification Hub Authorization Rule
notification_hub_namespace Notification Hub Namespace
point_to_site_vpn_gateway Point To Site Vpn Gateway
postgresql_database Postgresql Database
postgresql_firewall_rule Postgresql Firewall Rule
postgresql_server Postgresql Server
postgresql_virtual_network_rule Postgresql Virtual Network Rule
powerbi_embedded Powerbi Embedded
private_dns_a_record Private Dns A Record
private_dns_aaaa_record Private Dns Aaaa Record
private_dns_cname_record Private Dns Cname Record
private_dns_mx_record Private Dns Mx Record
private_dns_ptr_record Private Dns Ptr Record
private_dns_srv_record Private Dns Srv Record
private_dns_txt_record Private Dns Txt Record
private_dns_zone Private Dns Zone
private_dns_zone_group Private Dns Zone Group
private_endpoint Private Endpoint
private_link_service Private Link Service
private_service_connection Private Service Connection
proximity_placement_group Proximity Placement Group
public_ip Public Ip
public_ip_prefix Public Ip Prefix
recovery_services_vault Recovery Services Vault
redis_cache Redis Cache
redis_firewall_rule Redis Firewall Rule
relay_hybrid_connection Relay Hybrid Connection
relay_namespace Relay Namespace
resource_group Resource Group
role_assignment Role Assignment
role_definition Role Definition
route Route
route_table Route Table
service_fabric_cluster Service Fabric Cluster
servicebus_namespace Servicebus Namespace
servicebus_namespace_authorization_rule Servicebus Namespace Authorization Rule
servicebus_queue Servicebus Queue
servicebus_queue_authorization_rule Servicebus Queue Authorization Rule
servicebus_subscription Servicebus Subscription
servicebus_subscription_rule Servicebus Subscription Rule
servicebus_topic Servicebus Topic
servicebus_topic_authorization_rule Servicebus Topic Authorization Rule
shared_image Shared Image
shared_image_gallery Shared Image Gallery
signalr_service Signalr Service
snapshots Snapshots
sql_elasticpool Sql Elasticpool
sql_failover_group Sql Failover Group
sql_firewall_rule Sql Firewall Rule
sql_server Sql Server
storage_account Storage Account
storage_blob Storage Blob
storage_container Storage Container
storage_data_lake_gen2_filesystem Storage Data Lake Gen2 Filesystem
storage_queue Storage Queue
storage_share Storage Share
storage_share_directory Storage Share Directory
storage_table Storage Table
stream_analytics_function_javascript_udf Stream Analytics Function Javascript Udf
stream_analytics_job Stream Analytics Job
stream_analytics_output_blob Stream Analytics Output Blob
stream_analytics_output_eventhub Stream Analytics Output Eventhub
stream_analytics_output_mssql Stream Analytics Output Mssql
stream_analytics_output_servicebus_queue Stream Analytics Output Servicebus Queue
stream_analytics_output_servicebus_topic Stream Analytics Output Servicebus Topic
stream_analytics_reference_input_blob Stream Analytics Reference Input Blob
stream_analytics_stream_input_blob Stream Analytics Stream Input Blob
stream_analytics_stream_input_eventhub Stream Analytics Stream Input Eventhub
stream_analytics_stream_input_iothub Stream Analytics Stream Input Iothub
subnet Subnet
template_deployment Template Deployment
traffic_manager_profile Traffic Manager Profile
unique-seed n/a
user_assigned_identity User Assigned Identity
validation n/a
virtual_machine Virtual Machine
virtual_machine_extension Virtual Machine Extension
virtual_machine_scale_set Virtual Machine Scale Set
virtual_machine_scale_set_extension Virtual Machine Scale Set Extension
virtual_network Virtual Network
virtual_network_gateway Virtual Network Gateway
virtual_network_peering Virtual Network Peering
virtual_wan Virtual Wan
windows_virtual_machine Windows Virtual Machine
windows_virtual_machine_scale_set Windows Virtual Machine Scale Set

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HCL 98.1%
  • Go 1.1%
  • Other 0.8%