Definición de la convención de nomenclatura
Un buen nombre para un recurso le ayuda a identificar rápidamente su tipo, su carga de trabajo asociada, su entorno y la región de Azure donde se ejecuta. Para ello, los nombres deben seguir un formato coherente (una convención de nomenclatura de ) que se compone de información importante sobre cada recurso. La información de los nombres incluye idealmente lo que necesite para identificar instancias específicas de recursos. Por ejemplo, una dirección IP pública (PIP) para una carga de trabajo de Producción de SharePoint en la región Oeste de EE. UU. podría ser pip-sharepoint-prod-westus-001
.
Diagrama 1: Ejemplo de componentes en un nombre de recurso de Azure.
Nota
Tenga en cuenta que no todos los recursos de Azure pueden seguir los mismos patrones. Asegúrese de comprender las limitaciones de los tipos de recursos con los que está trabajando.
Para más información, consulte Reglas y restricciones de nomenclatura de recursos de Azure.
Componentes de nomenclatura recomendados
Al construir la convención de nomenclatura, identifique los fragmentos clave de información que desea capturar en un nombre de recurso. La información diferente es relevante para los distintos tipos de recursos y no todos los componentes de nomenclatura establecidos se pueden usar para cada tipo de recurso. Establezca una convención de nomenclatura estándar para su entorno que sea fácil de seguir, concisa y útil para reconocer información relevante para el recurso implementado.
En la lista siguiente se proporcionan ejemplos de componentes de nomenclatura que son útiles al construir nombres de recursos:
Componente de nomenclatura | Descripción |
---|---|
Organización | Nombre de nivel superior de la organización, normalmente se usa como grupo de administración superior o, en organizaciones más pequeñas, como parte de la convención de nomenclatura. Ejemplo: contoso |
unidad de negocio o departamento | División de nivel superior de la empresa propietaria de la suscripción o de la carga de trabajo a la que pertenece el recurso. En organizaciones más pequeñas, este componente podría representar un único elemento organizativo corporativo y de nivel superior. Ejemplos: fin , mktg , product , it , corp |
Tipo de recurso | Abreviatura que representa el tipo de recurso o activo de Azure. Este componente suele ser un prefijo o sufijo en el nombre. Para más información, consulte abreviaturas recomendadas para los tipos de recursos de Azure. Ejemplos: rg , vm |
carga de trabajo, aplicación o proyecto | Nombre de una carga de trabajo, aplicación o proyecto del que forma parte el recurso. Ejemplos: navigator , emissions , sharepoint , hadoop |
Entorno | La fase del ciclo de vida de desarrollo de la carga de trabajo que soporta el recurso. Ejemplos: prod , dev , qa , stage , test |
Región | Región o proveedor de nube donde se implementa el recurso. Ejemplos: westus , eastus2 , westeu , usva , ustx |
Instancia | Recuento de instancias de un recurso específico, para diferenciarlo de otros recursos que tienen la misma convención de nomenclatura y componentes de nomenclatura. Ejemplos, 01 , 001 |
Consideraciones de nomenclatura
Además de definir los componentes de nomenclatura, también debe tener en cuenta el orden en el que se enumeran los componentes de nomenclatura y qué tipo de delimitadores (si los hay) deben aparecer entre los componentes. Tenga en cuenta también las distintas reglas de nomenclatura asociadas a los tipos de recursos.
Alcance
Todos los tipos de recursos de Azure tienen un ámbito que define el nivel de ese recurso. Además, un recurso debe tener un nombre único dentro de su ámbito.
Niveles de ámbito para los nombres de recursos de Azure:
Global: único en todo Azure.
Ejemplo: nombre de los recursos de PaaS con puntos de conexión IP públicos en todo Azure, ya que ese nombre es el nombre DNS público predeterminado.
grupo de recursos: único dentro del grupo de recursos.
ejemplo: todas las redes virtuales de un grupo de recursos deben tener un nombre único para el enrutamiento dentro de ese grupo de recursos.
Recurso: único dentro del recurso padre.
ejemplo: todas las subredes de una red virtual deben tener nombres únicos para evitar superposición de segmentos.
Diagrama 2: Niveles de ámbito para los nombres de recursos de Azure.
Por ejemplo, una red virtual tiene el ámbito de un grupo de recursos, lo que significa que solo puede haber una red denominada vnet-prod-westus-001
en un grupo de recursos específico. Otros grupos de recursos también pueden tener redes virtuales denominadas vnet-prod-westus-001
, pero cada grupo de recursos solo puede tener uno con ese nombre. Las subredes se limitan a las redes virtuales, por lo que cada subred dentro de una red virtual debe tener un nombre distinto.
Algunos nombres de recursos tienen un ámbito global, como un nombre para una plataforma como servicio (PaaS) que tiene un punto de conexión público o una etiqueta DNS de máquina virtual. Un recurso de un ámbito global debe tener un nombre único en toda la plataforma azure.
Reglas de nomenclatura de Azure
Las reglas de nomenclatura de Azure varían en función del tipo de recurso. Es importante comprender las reglas de nomenclatura de cada tipo de recurso para evitar confusiones y retrasos.
Por ejemplo, los nombres de recursos para distintos tipos de recursos pueden tener límites de longitud diferentes. Se recomienda mantener la longitud de los componentes de nomenclatura cortos o abreviados para evitar que se superen los límites de longitud del nombre de recurso.
Al construir la convención de nomenclatura, identifique los fragmentos clave de información que desea reflejar en un nombre de recurso. La información diferente es relevante para los distintos tipos de recursos.
Recomendaciones:
- Comprender las reglas de nomenclatura y las restricciones: equilibrar el contexto de un nombre con su ámbito y límite de longitud es importante al desarrollar las convenciones de nomenclatura. Para más información, consulte Reglas y restricciones de nomenclatura de recursos de Azure.
- Usar abreviaturas de recursos recomendadas: las abreviaturas pueden ayudarle a mantener los nombres de recursos dentro de los límites de longitud y facilitar su lectura. Para más información, consulte abreviaturas recomendadas para los tipos de recursos de Azure.
- Considere la posibilidad de asignar coherencia de nombres a las máquinas virtuales: si está trabajando con máquinas virtuales en Azure, se recomienda mantener los nombres coherentes aunque los nombres de máquina virtual de Azure puedan ser más largos que el nombre NetBIOS permitido de la máquina virtual. Para obtener más información y otras restricciones, consulte Convenciones de nomenclatura en Active Directory para equipos, dominios, sitios y unidades organizativas - nombres de equipos.
- Use the Azure Naming Tool: Azure Naming Tool es una herramienta que le ayuda a generar nombres para los recursos de Azure en función de una convención de nomenclatura. Para más información, consulte la Herramienta de Nombrado de Azure .
Nombres de ejemplo
Tenga en cuenta estos ejemplos al definir la convención de nomenclatura. Los ejemplos se basan en los componentes de nomenclatura y las consideraciones que se describen en este artículo.
Los ejemplos siguientes están diseñados para proporcionar visualización de una convención de nomenclatura, pero las convenciones reales varían según la organización. Para obtener más ejemplos, consulte Azure Naming Tool.
Nombres de ejemplo: General
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
Grupo de administración | Unidad de negocio y/o medio ambiente |
mg-<unidad de negocio>[-<entorno>] mg-mktg mg-hr mg-corp-prod mg-fin-client |
Suscripción | Cuenta o contrato de empresa | <unidad de negocio>- propósito de suscripción<-><###> mktg-prod-001 corp-shared-001 fin-client-001 |
Grupos de recursos | Suscripción | rg-<nombre de aplicación o servicio>:>de propósito de suscripción<:<###> rg-mktgsharepoint-prod-001 rg-acctlookupsvc-shared-001 rg-ad-dir-services-shared-001 |
Instancia del servicio API Management | Global | apim-<nombre de aplicación o servicio> apim-navigator-prod |
Identidad administrada | Grupo de recursos | id-<nombre de la aplicación o el servicio>-<entorno>-<nombre de la región>-<###> id-appcn-keda-prod-eastus2-001 |
Nombres de ejemplo: Redes
Tipo de activo | Alcance | Formato y ejemplos |
---|---|---|
Red virtual | Grupo de recursos | vnet-<propósito de la suscripción>-<región>-<###> vnet-shared-eastus2-001 vnet-prod-westus-001 vnet-client-eastus2-001 |
Subred | Red virtual | snet-<propósito de la suscripción>-<región>-<###> snet-shared-eastus2-001 snet-prod-westus-001 snet-client-eastus2-001 |
Interfaz de red (NIC) | Grupo de recursos | nic-<##>-<nombre de la VM>-<propósito de la suscripción>-<###> nic-01-dc1-shared-001 nic-02-vmhadoop1-prod-001 nic-02-vmtest1-client-001 |
dirección IP pública | Grupo de recursos | pip-<nombre de la VM o de la aplicación>-<entorno>-<región>-<###> pip-dc1-shared-eastus2-001 pip-hadoop-prod-westus-001 |
equilibrador de carga (externo) | Grupo de recursos | lbe-<nombre de la aplicación o rol>-<entorno>-<###> lbe-navigator-prod-001 lbe-sharepoint-dev-001 |
Grupo de seguridad de red (NSG) | Subred o NIC | nsg-<nombre de directiva o nombre de aplicación>:<###> nsg-weballow-001 nsg-rdpallow-001 nsg-sqlallow-001 nsg-dnsblocked-001 |
puerta de enlace de red local | Puerta de enlace virtual | lgw-<propósito de la suscripción>-<región>-<###> lgw-shared-eastus2-001 lgw-prod-westus-001 lgw-client-eastus2-001 |
Puerta de enlace de red virtual | Red virtual | vgw-<propósito de la suscripción>-<región>-<###> vgw-shared-eastus2-001 vgw-prod-westus-001 vgw-client-eastus2-001 |
Conexión VPN | Grupo de recursos | vcn-<propósito de la suscripción1>>-<región1>-to-<propósito de la suscripción2>>-<región2>- vcn-shared-eastus2-to-shared-westus vcn-prod-eastus2-to-prod-westus |
tabla de rutas | Grupo de recursos | rt-<nombre de la tabla de rutas> rt-navigator rt-sharepoint |
Etiqueta DNS | Global | <Registro D de DNS para la VM>.<región>.cloudapp.azure.com dc1.westus.cloudapp.azure.com web1.eastus2.cloudapp.azure.com |
Nombres de ejemplo: Computación y web
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
máquina virtual | Grupo de recursos | vm-<carga de trabajo, aplicación o proyecto>-<entorno>-<###> vm-sql-test-001 vm-hadoop-prod-001 vm-sharepoint-dev-001 |
Aplicación web | Global | aplicación-<carga de trabajo, aplicación o proyecto>-<entorno>-<###>.azurewebsites.net app-navigator-prod-001.azurewebsites.net app-accountlookup-dev-001.azurewebsites.net |
Aplicación de funciones | Global | func-<carga de trabajo, aplicación o proyecto>-<entorno>-<###>.azurewebsites.net func-navigator-prod-001.azurewebsites.net func-accountlookup-dev-001.azurewebsites.net |
Nombres de ejemplo: Bases de datos
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
base de datos SQL de Azure | Azure SQL Server | sqldb-<carga de trabajo, aplicación o proyecto>,<entorno> sqldb-users-prod sqldb-users-dev |
Base de datos de Azure Cosmos DB | Global | cosmos-<carga de trabajo, aplicación o proyecto>-<entorno> cosmos-navigator-prod cosmos-emissions-dev |
Instancia de Azure Cache for Redis | Global | redis-<carga de trabajo, aplicación o proyecto>-<entorno> redis-navigator-prod redis-emissions-dev |
Nombres de ejemplo: Almacenamiento
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
cuenta de almacenamiento (uso general) | Global | <carga de trabajo, aplicación o proyecto><###> stnavigatordata001 stemissionsoutput001 |
Azure StorSimple | Global | ssimp<carga de trabajo, aplicación o proyecto><entorno> ssimpnavigatorprod ssimpemissionsdev |
Azure Container Registry | Global | cr<carga de trabajo, aplicación o proyecto><entorno><###> crnavigatorprod001 |
Nombres de ejemplo: inteligencia artificial y aprendizaje automático
Tipo de activo | Alcance | Formato y ejemplos |
---|---|---|
Búsqueda de Azure AI | Global | srch-<carga de trabajo, aplicación o proyecto>-<entorno> srch-navigator-prod srch-emissions-dev |
Azure OpenAI Service | Grupo de recursos | oai-<carga de trabajo, aplicación o proyecto>- entorno<> oai-navigator-prod oai-emissions-dev |
Área de trabajo de Azure Machine Learning | Grupo de recursos | mlw-<carga de trabajo, aplicación o proyecto>-<entorno> mlw-navigator-prod mlw-emissions-dev |
Nombres de ejemplo: Analytics e IoT
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
Azure Analysis Services | Global | como nombre de aplicación<><entorno> asnavigatorprod asemissionsdev |
Azure Data Factory | Global | adf-<carga de trabajo, aplicación o proyecto>-<entorno> adf-navigator-prod adf-emissions-dev |
áreas de trabajo de Azure Synapse Analytics | Grupo de recursos | synw-<carga de trabajo, aplicación o proyecto>-<entorno> synw-navigator-prod synw-emissions-dev |
Cuenta de Data Lake Storage | Global | dls<carga de trabajo, aplicación o proyecto><entorno> dlsnavigatorprod dlsemissionsdev |
IoT Hub | Global | iot-<carga de trabajo, aplicación o proyecto>-<entorno> iot-navigator-prod iot-emissions-dev |
Nombres de ejemplo: Integración
Tipo de recurso | Alcance | Formato y ejemplos |
---|---|---|
Espacio de nombres de Service Bus | Global | sbns-<carga de trabajo, aplicación o proyecto>- entorno<>.servicebus.windows.net sbns-navigator-prod.servicebus.windows.net sbns-emissions-dev.servicebus.windows.net |
Cola de Service Bus | Bus de Servicios | sbq-<carga de trabajo, aplicación o proyecto> sbq-navigator |
Tema de Service Bus | Bus de Servicio | sbt-<carga de trabajo, aplicación o proyecto> sbt-navigator |
Paso siguiente
Un buen paso siguiente es examinar las abreviaturas recomendadas para los recursos de Azure. Las abreviaturas pueden ayudarle a mantener los nombres de recursos dentro de los límites de longitud y facilitar su lectura.