Cómo crear y administrar una red

Cuándo usar este procedimiento

Utilice este procedimiento cuando las máquinas virtuales necesiten una red nueva con su propia subred para un entorno independiente o para aislar un proyecto. Esta guía lo acompaña desde la creación de la red hasta su eliminación.

La asignación de direcciones a una máquina concreta y la exclusión de direcciones del pool se tratan por separado. Consulte Pool de direcciones y direccionamiento de las VM.

Requisitos previos

• El rol Cluster master para redes de cualquier tipo, incluidas Routed y Q-in-Q.
• El rol vDC admin o superior para Isolated y GENEVE; Routed y Q-in-Q no están disponibles para este rol.
• Una subred elegida de antemano: IPv4 con un prefijo de /16 a /29.
• Para Q-in-Q, ambas etiquetas VLAN: la externa y la interna.
• vStack Center versión 3.0.4.

Creación de una red

Una red se crea como un objeto completo: el tipo, la subred, la puerta de enlace, la MTU y las etiquetas VLAN se definen en un solo formulario y no pueden modificarse después de la creación. Más adelante solo se puede cambiar el nombre.

1. Abra Provider Data Center → All Networks.

2. Haga clic en Add, encima de la tabla, para abrir el formulario de creación de red.

   

3. Complete el formulario:

   Campo	Valor que debe introducir
   Type	Tipo de red: Isolated (seleccionado de forma predeterminada), Routed o Q-in-Q
   Name	Nombre de la red
   CIDR	Subred IPv4 con un prefijo de /16 a /29
   Gateway	Puerta de enlace predeterminada: una dirección dentro de la subred indicada en CIDR. Este campo es opcional: si se deja vacío, la dirección se completa automáticamente
   MTU	1500 de forma predeterminada. La indicación junto al campo muestra los límites del clúster; no se aceptan valores inferiores a 1000 ni superiores a 9180
   VLAN ID	Este campo aparece para los tipos Routed y Q-in-Q. Para Q-in-Q, es la etiqueta externa (S-VLAN)
   C-VLAN	Este campo aparece solo para Q-in-Q: la etiqueta interna

4. Haga clic en Create a Network. El botón permanece deshabilitado hasta que se completen todos los campos obligatorios y sus valores superen la validación.

5. Espere a que la red aparezca en la tabla All Networks. La creación es asíncrona: el despachador del clúster acepta la solicitud y la transfiere al agente de red, por lo que el registro no aparece de inmediato. Mientras la red no esté confirmada, todavía no se puede asignar a un VDC ni conectar máquinas a ella.

6. Asigne la red a un centro de datos virtual (VDC): abra el VDC → Networks, pestaña Primary, busque la fila de la red y active el interruptor de la columna Assign. Sin la asignación, las máquinas del VDC no pueden ver la red.

El formulario de creación genera una red con una subred IPv4. Una red con una subred IPv6 o una red de doble pila (dual-stack), en la que las máquinas reciben direcciones de ambas familias, se crea mediante programación. Los métodos se enumeran al final de esta página.

Si la red no se creó

Código	Causa	Acción
-606 "Bad type value"	No se reconoció el tipo de red	Seleccione un tipo de la lista Type
-403 "Access denied"	El rol no tiene permiso para crear este tipo de red	Solo Cluster master puede crear redes Routed y Q-in-Q; solicítelo a un usuario con este rol
-647 "Empty cidr param value"	El campo CIDR está vacío	Especifique una subred
-644 "Bad cidr param value"	El valor de CIDR no puede interpretarse como una subred	Compruebe el formato: dirección de red y prefijo separados por una barra
-646 "You've asked too wide network"	El prefijo en CIDR es más corto que /16	Reduzca la subred; el mensaje indica el número de bits
-643 "You've asked too narrow network"	El prefijo en CIDR es más largo que /29 y no deja direcciones para las máquinas	Amplíe la subred
-680 "default_gw param is NULL"	La puerta de enlace se envió como un valor vacío	Introduzca una dirección en Gateway o deje el campo sin completar
-681 "default_gw param has bad value"	El valor de Gateway no puede interpretarse como una dirección IPv4	Corrija la dirección de la puerta de enlace
-682 "default_gw value is out of cidr block"	La dirección en Gateway está fuera de la subred indicada en CIDR	Elija una dirección dentro de la subred
-628 "mtu param value is out of acceptable range (1000-9180)"	El valor de MTU está fuera del rango permitido	Establezca un valor de 1000 a 9180
-629 "mtu param value exceeds maximal"	MTU supera el máximo del clúster	Reduzca el valor al máximo que se muestra en la indicación junto al campo
-609 "Bad mixup of network type and params"	Para una red Routed, el campo VLAN ID está vacío	Complete VLAN ID
-602 "Bad param value for vlan_id"	El número en VLAN ID está fuera del rango que acepta el clúster	Acuerde el número de VLAN con el administrador de red
-610 "Bad param qinq_id", -611 "qinq_id param value is out of acceptable range"	El valor de C-VLAN no puede interpretarse o está fuera del rango	Corrija la etiqueta interna
-612 "qinq_id param is required for Q-in-Q network type"	No se estableció la etiqueta interna para el tipo Q-in-Q	Complete C-VLAN
-613 "qinq_id is not allowed for this network type"	Se estableció la etiqueta interna para un tipo que no la admite	Cambie el tipo a Q-in-Q o elimine la etiqueta interna
-636 "Bad backend param value"	El backend de red se estableció en un número negativo; esto solo ocurre en solicitudes realizadas mediante programación	Mantenga el valor predeterminado
-659 "Failed to obtain cluster status while creating network"	El estado del clúster no está disponible en el momento de la solicitud	Compruebe el estado del clúster y vuelva a intentarlo
-617 "Network creation failed"	Los parámetros se aceptaron, pero la creación no finalizó	Vuelva a intentarlo; si no se resuelve, revise los registros del clúster
-12 "Failed to create network"	El formulario se aceptó, pero el agente de red no aplicó la configuración en los nodos	Compruebe el estado de los nodos y los registros del clúster y, a continuación, vuelva a crear la red

Verificación de que la red apareció

1. Abra Provider Data Center → All Networks. La nueva red aparece en la tabla con sus valores de ID, Type, Name, VLAN ID, MTU, CIDR, Used IP Addresses y Free IP Addresses. El campo Search in table acota una lista larga y el botón CSV exporta la lista completa.

   

2. Abra la ficha de la red y expanda la sección General properties. Compare CIDR, Gateway, MTU y VLAN ID con los valores que introdujo: estos campos son de solo lectura. La fila Latest changes: muestra cuándo se modificó la red por última vez.

3. Compruebe la asignación: en el VDC → sección Networks, en la pestaña Primary, la red tiene activado el interruptor Assign. La lista de redes del VDC muestra solo las redes asignadas a él, según los permisos del usuario.

El creador de la red puede modificarla y eliminarla, mientras que Cluster master puede modificar y eliminar cualquier red, independientemente de quién la haya creado.

Cambio de nombre de una red

El nombre es el único parámetro de la red que se puede cambiar. El cambio es síncrono: la confirmación llega de inmediato.

1. Abra Provider Data Center → All Networks y vaya a la ficha de la red.

2. En la sección General properties, introduzca un nuevo nombre en el campo Name. Los demás campos, CIDR, Gateway, MTU, VLAN ID y los contadores de direcciones, son de solo lectura.

3. Haga clic en Save changes. El botón está deshabilitado hasta que cambie el nombre.

4. Compruebe que el nuevo nombre aparece en el encabezado de la ficha y en la tabla All Networks.

El nombre puede estar vacío; en ese caso, la red se identifica por su ID.

Si no se pudo cambiar el nombre

Código	Causa	Acción
-47301 "No param id"	No se identificó la red: la solicitud se envió sin un ID	Vuelva a All Networks y abra de nuevo la ficha de la red
-47305 "No params has been provided"	La solicitud de guardado se envió sin campos modificados	Introduzca un nuevo nombre y, a continuación, guarde
-403 "Access denied"	La red está asignada a otro VDC y la creó otro usuario	Cámbiele el nombre como Cluster master
-47306 "Network unknown"	La red con este ID ya no existe; es posible que se haya eliminado desde otra sesión	Actualice la lista All Networks
-78 "Database error"	Error de la base de datos	Vuelva a intentarlo; si no se resuelve, póngase en contacto con el soporte técnico

Eliminación de una red

La eliminación es asíncrona: el comando se envía al agente de red y el resultado llega más tarde. Cluster master puede eliminar cualquier red; vDC admin solo puede eliminar las redes que creó.

1. Desconecte de la red a todos sus consumidores: las interfaces de red de las máquinas virtuales y los routers definidos por software (Edge). Mientras la red esté en uso, la eliminación se rechaza.

2. Abra la ficha de la red, haga clic en Actions y seleccione Delete Network. La misma acción está disponible en la fila de la red en la lista All Networks.

3. Lea la advertencia del cuadro de diálogo: la eliminación puede afectar no solo al VDC actual, sino a todo el clúster. Confirme con el botón Delete o cierre el cuadro de diálogo con Cancel.

4. Espere a que el registro desaparezca de la tabla All Networks. Si la red sigue en la lista, vuelva a actualizarla: la eliminación la confirma el agente de red, no el propio cuadro de diálogo.

Si no se pudo eliminar la red

Código	Causa	Acción
La acción Delete Network no aparece en el menú Actions	Usted no es el creador de la red ni Cluster master, o la red tiene un error de ciclo de vida o de asignación	Actúe como Cluster master; resuelva el error de ciclo de vida antes de la eliminación
-707 "Network is used still so can't be deleted"	Hay máquinas o Edge conectados a la red	Desconecte a los consumidores y vuelva a intentarlo
-403 "Access denied"	La red está asignada a otro VDC y la creó otro usuario	Elimínela como Cluster master
-659 "Failed to obtain cluster status while creating network"	El estado del clúster no está disponible en el momento de la solicitud	Compruebe el estado del clúster y vuelva a intentarlo
-722 "Internal database error"	Error de la base de datos	Vuelva a intentarlo; si no se resuelve, póngase en contacto con el soporte técnico
-12 "Failed to delete network"	El agente no completó la eliminación; es posible que la red siga en la configuración de los nodos	Compruebe el estado de los nodos y los registros del clúster y, a continuación, vuelva a intentar la eliminación

Consulte también

• Redes del clúster: tipos, doble pila y pools de direcciones: estructura de las redes y límites de los parámetros.
• Pool de direcciones y direccionamiento de las VM: qué hacer después de crear una red.

Métodos de la API

Las operaciones de la API que se tratan en esta página son nets-create, net-list, net-set, nets-delete, vdc-assign-network y vdc-deassign-network. Consulte la referencia de la API.