

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Actualice una instancia de red en AWS TNB
<a name="update-network-instance"></a>

Después de crear una instancia de red, es posible que necesite actualizar la infraestructura o la aplicación. Para ello, debe actualizar el paquete de red y los valores de los parámetros de la instancia de red e implementar la operación de actualización para aplicar los cambios.

## Consideraciones
<a name="update-considerations"></a>
+ Puede actualizar una instancia de red que esté en el `Updated` estado `Instantiated` o.
+ Al actualizar una instancia de red, la `UpdateSolNetworkService` API usa el nuevo paquete de red y los valores de los parámetros para actualizar la topología de la instancia de red.
+ AWS TNB comprueba que el número de parámetros NSD y VNFD de la instancia de red no supere los 200. Este límite se aplica para evitar que personas malintencionadas transmitan cargas erróneas o enormes que afecten al servicio.

## Parámetros que puede actualizar
<a name="update-parameters"></a>

Puede actualizar los siguientes parámetros al actualizar una instancia de red instanciada:


| Parámetro | Description (Descripción) | Ejemplo: antes | Ejemplo: Después | 
| --- | --- | --- | --- | 
| Versión de clúster de Amazon EKS | Puede actualizar el valor del `version` parámetro del plano de control del clúster de Amazon EKS a la siguiente versión secundaria. No puede cambiar la versión a una versión inferior. |  <pre>EKSCluster:<br />    type: tosca.nodes.AWS.Compute.EKS<br />    properties:<br />      version: "{{1.28}}"</pre> |  <pre>EKSCluster:<br />    type: tosca.nodes.AWS.Compute.EKS<br />    properties:<br />      version: "{{1.29}}"</pre> | 
| Nodos de trabajo de Amazon EKS | Puede actualizar el valor del `EKSManagedNode kubernetes_version` parámetro para actualizar el grupo de nodos a una versión más reciente de Amazon EKS, o puede actualizar el `ami_id` parámetro para actualizar el grupo de nodos a la última AMI optimizada para EKS.<br />Puede actualizar el ID de AMI de`EKSSelfManagedNode`. La versión de Amazon EKS de la AMI debe ser igual o tener hasta 2 versiones anteriores a la versión de clúster de Amazon EKS. Por ejemplo, si la versión del clúster de Amazon EKS es 1.31, la versión de la AMI de Amazon EKS debe ser 1.31, 1.30 o 1.29. |  <pre>EKSManagedNodeGroup01:<br />    ...<br />    properties:<br />      kubernetes_version: "{{1.28}}"<br />    EKSSelfManagedNode01:<br />      compute:<br />        compute:<br />          properties:<br />            ami_id: "{{ami-123123OLD}}"</pre> |  <pre>EKSManagedNodeGroup01:<br />    ...<br />    properties:<br />      kubernetes_version: "{{1.29}}"<br />    EKSSelfManagedNode01:<br />      compute:<br />        compute:<br />          properties:<br />            ami_id: "{{ami-123123NEW}}"</pre> | 
| Grupos de nodos de Amazon EKS | Puede añadir o eliminar grupos de nodos según sus necesidades informáticas.<br />Al eliminar grupos de nodos existentes y añadir otros nuevos, asegúrese de que los nuevos grupos de nodos IDs sean diferentes de los grupos de nodos eliminados; de lo contrario, la operación se considerará una modificación del grupo de nodos en lugar de una eliminación y adición. Tenga en cuenta que, en el caso de los grupos de nodos existentes, solo se puede actualizar un conjunto limitado de parámetros. Desplázate por esta tabla para ver qué parámetros puedes actualizar. |  <pre>Free5GCEKSNode01:<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />{{Free5GCEKSNode02}}: # Deleted Nodegroup<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />{{Free5GCEKSNode03}}: # Deleted Nodegroup  <br />  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...</pre> | <pre>Free5GCEKSNode01:<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />{{Free5GCEKSNode04}}: # New Nodegroup<br />  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />{{Free5GCEKSNode05}}: # New Nodegroup  <br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...</pre> | 
| Propiedades de escalado | Puede actualizar las propiedades de escalado de los nodos TOSCA `EKSManagedNode` y de los nodos `EKSSelfManagedNode` TOSCA. |  <pre>EKSNodeGroup01:<br />    ...<br />    scaling:<br />        properties:<br />            desired_size: {{1}}<br />            min_size: {{1}}<br />            max_size: {{1}}</pre>  |  <pre>EKSNodeGroup01:<br />    ...<br />    scaling:<br />        properties:<br />            desired_size: {{2}}<br />            min_size: {{0}}<br />            max_size: {{2}}</pre>  | 
| Propiedades del complemento CSI de Amazon EBS | Puede activar o desactivar el complemento CSI de Amazon EBS en sus clústeres de Amazon EKS. También puede cambiar la versión del complemento. |  <pre>EKSCluster:<br />  capabilities:<br />   ...<br />    ebs_csi:<br />      properties:<br />        enabled: {{false}}</pre>  |  <pre>EKSCluster:<br />  capabilities:<br />   ...<br />    ebs_csi:<br />      properties:<br />        enabled: {{true}}<br />        version: "{{v1.30.0-eksbuild.1}}"</pre>  | 
| Tamaño del volumen raíz | Puede añadir, eliminar o actualizar la propiedad de tamaño del volumen raíz de los EKSManaged nodos Node y EKSSelf ManagedNode TOSCA. |  <pre>Free5GCEKSNode01:<br />      ...<br />      capabilities:        <br />        compute:<br />          properties:<br />            root_volume_size: {{50}}</pre>  |  <pre>Free5GCEKSNode01:<br />      ...<br />      capabilities:<br />        compute:<br />          properties:            <br />            root_volume_size: {{100}}</pre>  | 
| VNF | Puede hacer referencia a ellos VNFs en el NSD e implementarlos en el clúster creado en el NSD mediante el nodo TOSCA. VNFDeployment Como parte de la actualización, podrás añadir, actualizar y eliminar VNFs elementos de la red. |  <pre>vnfds:<br />  - descriptor_id: "{{43c012fa-2616-41a8-a833-0dfd4c5a049e}}"<br />    namespace: "{{vnf1}}"<br />  - descriptor_id: "{{64222f98-ecd6-4871-bf94-7354b53f3ee5}}"<br />    namespace: "{{vnf2}}" // Deleted VNF<br />...<br />SampleVNF1HelmDeploy:<br />      type: tosca.nodes.AWS.Deployment.VNFDeployment<br />      requirements:<br />        cluster: EKSCluster<br />        vnfs:<br />          - {{vnf1.SampleVNF1}}<br />          - {{vnf2.SampleVNF2}}</pre>  |  <pre>vnfds:<br />  - descriptor_id: "{{59f77222-79e9-4dc1-be53-5712ad06e31b}}"<br />    namespace: "{{vnf1}}" // Updated VNF<br />  - descriptor_id: "{{b7e072dc-839d-4fac-916c-561a166da1fc}}"<br />    namespace: "{{vnf3}}" // Added VNFn<br />....<br />SampleVNF1HelmDeploy:<br />      type: tosca.nodes.AWS.Deployment.VNFDeployment<br />      requirements:<br />        cluster: EKSCluster<br />        vnfs:<br />          - {{vnf1.SampleVNF1}}<br />          - {{vnf3.SampleVNF3}}</pre>  | 
| Enlaces | Para ejecutar las operaciones del ciclo de vida antes y después de crear una función de red, añada los `post_create` ganchos `pre_create` y al `VNFDeployment` nodo.<br />En este ejemplo, el `PreCreateHook` gancho se ejecutará antes de crear `vnf3.SampleVNF3` una instancia y se ejecutará después de crearla`vnf3.SampleVNF3`. `PostCreateHook` |  <pre>vnfds:<br />  - descriptor_id: "{{43c012fa-2616-41a8-a833-0dfd4c5a049e}}"<br />    namespace: "{{vnf1}}"<br />  - descriptor_id: "{{64222f98-ecd6-4871-bf94-7354b53f3ee5}}"<br />    namespace: "{{vnf2}}"<br />...<br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - {{vnf1.SampleVNF1}}<br />      - {{vnf2.SampleVNF2}} // Removed during update</pre>  |  <pre>vnfds:<br />  - descriptor_id: "{{43c012fa-2616-41a8-a833-0dfd4c5a049e}}"<br />    namespace: "{{vnf1}}"<br />  - descriptor_id: "{{b7e072dc-839d-4fac-916c-561a166da1fc}}"<br />    namespace: "{{vnf3}}"<br />....<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - {{vnf1.SampleVNF1}} // No change to this function, as the namespace and uuid remain the same<br />      - {{vnf3.SampleVNF3}} // New VNF as the namespace, vnf3, was not previously present<br />  interfaces:<br />    Hook:<br />      post_create: {{PostCreateHook}}<br />      pre_create: {{PreCreateHook}}</pre>  | 
| Enlaces | Para ejecutar las operaciones del ciclo de vida antes y después de actualizar una función de red, puede añadir el `pre_update` gancho y el `post_update` gancho al nodo. `VNFDeployment`<br />En este ejemplo, `PreUpdateHook` se ejecutará antes de la actualización y `vnf1.SampleVNF1` se `PostUpdateHook` ejecutará después de que `vnf1.SampleVNF1` se actualice en el `vnf` paquete indicado por la actualización `uuid` para el espacio de nombres vnf1. |  <pre>vnfds:<br />  - descriptor_id: "{{43c012fa-2616-41a8-a833-0dfd4c5a049e}}"<br />    namespace: "{{vnf1}}"<br />  - descriptor_id: "{{64222f98-ecd6-4871-bf94-7354b53f3ee5}}"<br />    namespace: "{{vnf2}}"<br />...<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - {{vnf1.SampleVNF1}}<br />      - {{vnf2.SampleVNF2 }}<br /></pre>  |  <pre>vnfds:<br />  - descriptor_id: "{{0ebe4e95-bd87-44bd-b8a1-918466606a14}}"<br />    namespace: "{{vnf1}}"<br />  - descriptor_id: "{{64222f98-ecd6-4871-bf94-7354b53f3ee5}}"<br />    namespace: "{{vnf2}}"<br /><br />...<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - {{vnf1.SampleVNF1}} // A VNF update as the uuid changed for namespace "vnf1"<br />      - {{vnf2.SampleVNF2}} // No change to this function as namespace and uuid remain the same<br />  interfaces:<br />    Hook:<br />      pre_update: {{PreUpdateHook}}<br />      post_update: {{PostUpdateHook}}</pre>  | 
| Subredes | Puede agregar y eliminar subredes de la red. Antes de eliminar una subred, compruebe que ningún recurso de la red utilice la subred. |  <pre>{{Free5GCSubnet01}}: #Deleted Subnet<br />  type: tosca.nodes.AWS.Networking.Subnet<br />  properties:<br />    type: "PUBLIC"<br />    availability_zone: { get_input: subnet_01_az }<br />    cidr_block: { get_input: subnet_01_cidr_block }<br />  requirements:<br />    route_table: Free5GCRouteTable<br />    vpc: Free5GCVPC</pre>  |  <pre>{{Free5GCSubnet02}}: #New Subnet<br />  type: tosca.nodes.AWS.Networking.Subnet<br />  properties:<br />    type: "PUBLIC"<br />    availability_zone: { get_input: subnet_02_az }<br />    cidr_block: { get_input: subnet_02_cidr_block }<br />  requirements:<br />    route_table: Free5GCRouteTable<br />    vpc: Free5GCVPC</pre>  | 
| Grupos de seguridad | Puede agregar y eliminar grupos de seguridad de la red. Antes de eliminar un grupo de seguridad, compruebe que ningún recurso de la red lo utilice. |  <pre>{{Free5GCSecurityGroup01}}: #Deleted Security Group<br />  type: tosca.nodes.AWS.Networking.SecurityGroup<br />  properties:<br />    description: "SecurityGroup for Free5GC cluster"<br />    name: "Free5GCSecurityGroup01"<br />    tags:<br />      - "Name=Free5GCEKSAdditionalSecurityGroup"<br />  requirements:<br />    vpc: Free5GCVPC<br /><br />{{Free5GCSecurityGroupEgressRule01}}: #Deleted Security Group Egress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Egress Rule for free5GC cluster"<br />    cidr_ip : "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup01<br /><br />{{Free5GCSecurityGroupIngressRule01}}: #Deleted Security Group Ingress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Ingress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup01</pre>  |  <pre>{{Free5GCSecurityGroup02}}: #New Security Group<br />  type: tosca.nodes.AWS.Networking.SecurityGroup<br />  properties:<br />    description: "SecurityGroup for Free5GC cluster"<br />    name: "Free5GCSecurityGroup02"<br />    tags:<br />      - "Name=Free5GCEKSAdditionalSecurityGroup"<br />  requirements:<br />    vpc: Free5GCVPC<br />   <br />{{Free5GCSecurityGroupEgressRule02}}: #New Security Group Egress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Egress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup02<br />   <br />{{Free5GCSecurityGroupIngressRule02}}: #New Security Group Ingress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Ingress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup02</pre>  | 
| Interfaces de red | Puede agregarlo, modificarlo y eliminarlo ENIs de la red. |  <pre>Free5GCENI01: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 2<br />  requirements:<br />    subnet: {{Free5GCENISubnet01}}<br />    security_groups:<br />      - Free5GCSecurityGroup01<br /><br />Free5GCENI02: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br /><br />{{Free5GCENI04}}: #Deleted ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 4<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br /></pre>  |  <pre>Free5GCENI01: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 2<br />  requirements:<br />    subnet: {{Free5GCENISubnet02}}<br />    security_groups:<br />      - Free5GCSecurityGroup01<br /><br />Free5GCENI02: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br />    {{security_groups:}}<br />      {{- Free5GCSecurityGroup01}}<br /><br />{{Free5GCENI03}}: #New ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />  requirements:<br />    subnet: Free5GCSubnet01<br />    security_groups:<br />      - Free5GCSecurityGroup01</pre>  | 

## Actualizar una instancia de red
<a name="update-network-instance-steps"></a>

------
#### [ Console ]

**Para actualizar una instancia de red mediante la consola**

1. Abra la consola AWS TNB en [https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/).

1. En el panel de navegación, elija **Redes**.

1. Seleccione la instancia de red. Puede actualizar una instancia de red solo si su estado es `Instantiated` o`Updated`.

1. Seleccione **Acciones** y **Actualizar**.

   Aparece la página de **actualización de la instancia** con los detalles de la red y una lista de parámetros de la infraestructura actual.

1. Elige un paquete de red nuevo.

   Los parámetros del nuevo paquete de red aparecen en la sección **Parámetros actualizados**.

1. Si lo desea, actualice los valores de los parámetros en la sección **Parámetros actualizados**. Para ver la lista de valores de parámetros que puede actualizar, consulte[Parámetros que puede actualizar](#update-parameters).

1. Seleccione **Actualizar red**.

   AWS TNB valida la solicitud e inicia el despliegue. Aparece la página **de estado del despliegue**.

1. Utilice el icono de **actualización** para realizar un seguimiento del estado de despliegue de la instancia de red. También puede activar la **actualización automática** en la sección **Tareas de despliegue** para realizar un seguimiento del progreso de cada tarea.

   Cuando el estado de la implementación cambia a`Completed`, la instancia de red se actualiza.

1. 
   + Si se produce un error en la validación, la instancia de red permanece en el mismo estado en el que estaba antes de solicitar la actualización, ya sea `Instantiated` o no`Updated`.
   + Si se produce un error en la actualización, se muestra el estado de la instancia de red`Update failed`. Elija el enlace de cada tarea fallida para determinar el motivo.
   + Si la actualización se realiza correctamente, se muestra `Updated` el estado de la instancia de red.

------
#### [ AWS CLI ]

**Utilice la CLI para actualizar una instancia de red**  
Use el [update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)comando con el tipo de `UPDATE_NS` actualización para actualizar una instancia de red.

```
aws tnb update-sol-network-instance --ns-instance-id {{^ni-[a-f0-9]{17}$}} --update-type UPDATE_NS --update-ns "{\"nsdInfoId\":\"{{^np-[a-f0-9]{17}$}}\", \"additionalParamsForNs\": {\"{{param1}}\": \"{{value1}}\"}}"
```

------