Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mettre à jour une instance réseau dans AWS TNB
<a name="update-network-instance"></a>

Après l'instanciation d'une instance réseau, vous devrez peut-être mettre à jour l'infrastructure ou l'application. Pour ce faire, vous devez mettre à jour le package réseau et les valeurs des paramètres de l'instance réseau et déployer l'opération de mise à jour pour appliquer les modifications.

## Considérations
<a name="update-considerations"></a>
+ Vous pouvez mettre à jour une instance réseau à l'`Updated`état `Instantiated` ou.
+ Lorsque vous mettez à jour une instance réseau, l'`UpdateSolNetworkService`API utilise le nouveau package réseau et les nouvelles valeurs de paramètres pour mettre à jour la topologie de l'instance réseau.
+ AWS TNB vérifie que le nombre de paramètres NSD et VNFD dans l'instance réseau ne dépasse pas 200. Cette limite est appliquée pour empêcher les acteurs malveillants de transmettre des charges utiles erronées ou énormes qui affectent le service.

## Paramètres que vous pouvez mettre à jour
<a name="update-parameters"></a>

Vous pouvez mettre à jour les paramètres suivants lorsque vous mettez à jour une instance réseau instanciée :


| Paramètre | Description | Exemple : Avant | Exemple : Après | 
| --- | --- | --- | --- | 
| Version du cluster Amazon EKS | Vous pouvez mettre à jour la valeur du `version` paramètre du plan de contrôle du cluster Amazon EKS vers la version mineure suivante. Vous ne pouvez pas rétrograder la version. |  <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> | 
| Nœuds de travail Amazon EKS | Vous pouvez mettre à jour la valeur du `EKSManagedNode kubernetes_version` paramètre pour mettre à niveau votre groupe de nœuds vers une version plus récente d'Amazon EKS, ou vous pouvez mettre à jour le `ami_id` paramètre pour mettre à niveau votre groupe de nœuds vers la dernière AMI optimisée pour EKS.<br />Vous pouvez mettre à jour l'ID AMI pour`EKSSelfManagedNode`. La version Amazon EKS de l'AMI doit être identique ou inférieure à 2 versions au maximum à la version du cluster Amazon EKS. Par exemple, si la version du cluster Amazon EKS est 1.31, la version de l'AMI Amazon EKS doit être 1.31, 1.30 ou 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> | 
| Groupes de nœuds Amazon EKS | Vous pouvez ajouter ou supprimer des groupes de nœuds en fonction de vos besoins informatiques.<br />Lorsque vous supprimez des groupes de nœuds existants et que vous en ajoutez de nouveaux, assurez-vous que les nouveaux groupes de nœuds sont différents IDs des groupes de nœuds supprimés, sinon l'opération sera traitée comme une modification de groupe de nœuds plutôt que comme une suppression et un ajout. Notez que pour les groupes de nœuds existants, seul un ensemble limité de paramètres peut être mis à jour. Parcourez ce tableau pour voir quels paramètres vous pouvez mettre à jour. |  <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> | 
| Propriétés de dimensionnement | Vous pouvez mettre à jour les propriétés de mise à l'échelle des `EKSManagedNode` nœuds et `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>  | 
| Propriétés du plugin Amazon EBS CSI | Vous pouvez activer ou désactiver le plug-in Amazon EBS CSI sur vos clusters Amazon EKS. Vous pouvez également modifier la version du plugin. |  <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>  | 
| Taille du volume racine | Vous pouvez ajouter, supprimer ou mettre à jour la propriété de taille du volume racine des EKSManaged nœuds Node et 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 | Vous pouvez les référencer VNFs dans le NSD et les déployer sur le cluster créé dans le NSD à l'aide du nœud VNFDeployment TOSCA. Dans le cadre de la mise à jour, vous serez en mesure d'ajouter, de mettre à jour et de VNFs supprimer des informations sur le réseau. |  <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>  | 
| Crochets | Pour exécuter des opérations de cycle de vie avant et après la création d'une fonction réseau, ajoutez les `post_create` crochets `pre_create` et au `VNFDeployment` nœud.<br />Dans cet exemple, le `PreCreateHook` hook s'exécutera avant d'être instancié et le `PostCreateHook` hook `vnf3.SampleVNF3` s'exécutera après `vnf3.SampleVNF3` l'instanciation. |  <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>  | 
| Crochets | Pour exécuter des opérations de cycle de vie avant et après la mise à jour d'une fonction réseau, vous pouvez ajouter le `pre_update` `post_update` hook et le hook au `VNFDeployment` nœud.<br />Dans cet exemple, `PreUpdateHook` sera exécuté avant `vnf1.SampleVNF1` la mise à jour et s'`PostUpdateHook`exécutera après `vnf1.SampleVNF1` la mise à jour vers le `vnf` package indiqué par la mise à jour `uuid` pour l'espace de noms 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>  | 
| Subnets | Vous pouvez ajouter et supprimer des sous-réseaux sur le réseau. Avant de supprimer un sous-réseau, vérifiez qu'il n'est utilisé par aucune ressource du réseau. |  <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>  | 
| Groupes de sécurité | Vous pouvez ajouter et supprimer des groupes de sécurité sur le réseau. Avant de supprimer un groupe de sécurité, vérifiez qu'il n'est utilisé par aucune ressource du réseau. |  <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 réseau | Vous pouvez ajouter, modifier et supprimer ENIs du réseau. |  <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>  | 

## Mettre à jour une instance réseau
<a name="update-network-instance-steps"></a>

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

**Pour mettre à jour une instance réseau à l'aide de la console**

1. Ouvrez la console AWS TNB à [https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)l'adresse.

1. Dans le volet de navigation, sélectionnez **Networks**.

1. Sélectionnez l'instance réseau. Vous ne pouvez mettre à jour une instance réseau que si son état est `Instantiated` ou`Updated`.

1. Choisissez **Actions** et **Mettre à jour**.

   La page **Mettre à jour l'instance** apparaît avec les détails du réseau et une liste des paramètres de l'infrastructure actuelle.

1. Choisissez un nouveau package réseau.

   Les paramètres du nouveau package réseau apparaissent dans la section **Paramètres mis à jour**.

1. Vous pouvez éventuellement mettre à jour les valeurs des paramètres dans la section **Paramètres mis à jour**. Pour la liste des valeurs de paramètres que vous pouvez mettre à jour, consultez[Paramètres que vous pouvez mettre à jour](#update-parameters).

1. Choisissez **Mettre à jour le réseau**.

   AWS TNB valide la demande et lance le déploiement. La page **État du déploiement** apparaît.

1. Utilisez l'icône **Actualiser** pour suivre l'état de déploiement de votre instance réseau. Vous pouvez également activer l'**actualisation automatique** dans la section **Tâches de déploiement** pour suivre la progression de chaque tâche.

   Lorsque l'état du déploiement passe à`Completed`, l'instance réseau est mise à jour.

1. 
   + Si la validation échoue, l'instance réseau reste dans le même état qu'avant que vous ne demandiez la mise à jour, `Instantiated` soit`Updated`.
   + Si la mise à jour échoue, l'état de l'instance réseau s'affiche`Update failed`. Choisissez le lien correspondant à chaque tâche ayant échoué pour en déterminer la raison.
   + Si la mise à jour réussit, l'état de l'instance réseau s'affiche`Updated`.

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

**Utiliser la CLI pour mettre à jour une instance réseau**  
Utilisez la [update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)commande avec le type de `UPDATE_NS` mise à jour pour mettre à jour une instance réseau.

```
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}}\"}}"
```

------