

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Perbarui instance jaringan di AWS TNB
<a name="update-network-instance"></a>

Setelah instance jaringan dipakai, Anda mungkin perlu memperbarui infrastruktur atau aplikasi. Untuk melakukannya, Anda memperbarui paket jaringan dan nilai parameter untuk instance jaringan dan menerapkan operasi pembaruan untuk menerapkan perubahan.

## Pertimbangan-pertimbangan
<a name="update-considerations"></a>
+ Anda dapat memperbarui instance jaringan yang ada di `Updated` negara bagian `Instantiated` atau.
+ Saat Anda memperbarui instance jaringan, `UpdateSolNetworkService` API menggunakan paket jaringan baru dan nilai parameter untuk memperbarui topologi instance jaringan.
+ AWS TNB memverifikasi bahwa jumlah parameter NSD dan VNFD dalam instance jaringan tidak melebihi 200. Batas ini diberlakukan untuk melindungi dari pelaku jahat yang melewati muatan yang salah atau besar yang memengaruhi layanan.

## Parameter yang dapat Anda perbarui
<a name="update-parameters"></a>

Anda dapat memperbarui parameter berikut saat memperbarui instance jaringan yang dipakai:


| Parameter | Deskripsi | Contoh: Sebelum | Contoh: Setelah | 
| --- | --- | --- | --- | 
| Versi kluster Amazon EKS | Anda dapat memperbarui nilai untuk `version` parameter bidang kontrol cluster Amazon EKS ke versi minor berikutnya. Anda tidak dapat menurunkan versi. |  <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> | 
| Node pekerja Amazon EKS | Anda dapat memperbarui nilai `EKSManagedNode kubernetes_version` parameter untuk memutakhirkan grup node Anda ke versi Amazon EKS yang lebih baru, atau Anda dapat memperbarui `ami_id` parameter untuk memutakhirkan grup node Anda ke AMI terbaru yang dioptimalkan EKS.<br />Anda dapat memperbarui ID AMI untuk`EKSSelfManagedNode`. Versi Amazon EKS dari AMI harus sama dengan atau hingga 2 versi lebih rendah dari versi cluster Amazon EKS. Misalnya jika versi cluster Amazon EKS adalah 1.31, maka versi Amazon EKS AMI harus 1.31, 1.30, atau 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> | 
| Grup simpul Amazon EKS | Anda dapat menambah atau menghapus grup node sesuai kebutuhan komputasi Anda.<br />Saat menghapus grup node yang ada dan menambahkan yang baru, pastikan bahwa grup node baru berbeda IDs dari grup node yang dihapus, jika tidak operasi akan diperlakukan sebagai modifikasi grup node alih-alih penghapusan dan penambahan. Perhatikan bahwa untuk grup node yang ada, hanya satu set parameter terbatas yang dapat diperbarui. Gulir tabel ini untuk melihat parameter mana yang dapat Anda perbarui. |  <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> | 
| Properti penskalaan | Anda dapat memperbarui properti penskalaan node `EKSManagedNode` dan `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>  | 
| Properti plugin Amazon EBS CSI | Anda dapat mengaktifkan atau menonaktifkan plugin Amazon EBS CSI di kluster Amazon EKS Anda. Anda juga dapat mengubah versi 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>  | 
| Ukuran volume akar | Anda dapat menambahkan, menghapus, atau memperbarui properti ukuran volume root dari EKSManaged node Node dan 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 | Anda dapat mereferensikan VNFs di NSD dan menerapkannya ke cluster yang dibuat di NSD menggunakan VNFDeployment node TOSCA. Sebagai bagian dari pembaruan, Anda akan dapat menambahkan, memperbarui, dan menghapus VNFs ke jaringan. |  <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>  | 
| Hook | Untuk menjalankan operasi siklus hidup sebelum dan sesudah Anda membuat fungsi jaringan, tambahkan `pre_create` dan `post_create` kait ke `VNFDeployment` node.<br />Dalam contoh ini, `PreCreateHook` hook akan berjalan sebelum `vnf3.SampleVNF3` dipakai dan `PostCreateHook` hook akan berjalan setelah `vnf3.SampleVNF3` dipakai. |  <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>  | 
| Hook | Untuk menjalankan operasi siklus hidup sebelum dan sesudah Anda memperbarui fungsi jaringan, Anda dapat menambahkan `pre_update` hook dan `post_update` hook ke `VNFDeployment` node.<br />Dalam contoh ini, `PreUpdateHook` akan berjalan sebelum `vnf1.SampleVNF1` diperbarui dan `PostUpdateHook` akan berjalan setelah `vnf1.SampleVNF1` diperbarui ke `vnf` paket yang ditunjukkan oleh diperbarui `uuid` untuk namespace 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>  | 
| Subnet | Anda dapat menambah dan menghapus subnet dari jaringan. Sebelum menghapus subnet, verifikasi bahwa subnet tidak digunakan oleh sumber daya apa pun di jaringan. |  <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>  | 
| Grup keamanan | Anda dapat menambah dan menghapus grup keamanan dari jaringan. Sebelum menghapus grup keamanan, verifikasi bahwa grup keamanan tidak digunakan oleh sumber daya apa pun di jaringan. |  <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>  | 
| Antarmuka jaringan | Anda dapat menambahkan, memodifikasi, dan menghapus ENIs dari jaringan. |  <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>  | 

## Memperbarui instance jaringan
<a name="update-network-instance-steps"></a>

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

**Untuk memperbarui instance jaringan menggunakan konsol**

1. Buka konsol AWS TNB di [https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/).

1. Di panel navigasi, pilih **Jaringan**.

1. Pilih contoh jaringan. Anda dapat memperbarui instance jaringan hanya jika statusnya adalah `Instantiated` atau`Updated`.

1. Pilih **Tindakan** dan **Perbarui**.

   Halaman **instans Update** muncul dengan rincian jaringan dan daftar parameter dalam infrastruktur saat ini.

1. Pilih paket jaringan baru.

   Parameter dalam paket jaringan baru muncul di bagian **Parameter yang diperbarui**.

1. Secara opsional, perbarui nilai parameter di bagian **Parameter yang diperbarui**. Untuk daftar nilai parameter yang dapat Anda perbarui, lihat[Parameter yang dapat Anda perbarui](#update-parameters).

1. Pilih **Perbarui jaringan**.

   AWS TNB memvalidasi permintaan dan memulai penerapan. Halaman **status Deployment** muncul.

1. Gunakan ikon **Refresh** untuk melacak status penerapan instance jaringan Anda. Anda juga dapat mengaktifkan **Auto refresh** di bagian **tugas Deployment** untuk melacak kemajuan setiap tugas.

   Ketika status penerapan berubah`Completed`, instance jaringan diperbarui.

1. 
   + Jika validasi gagal, instance jaringan tetap dalam keadaan yang sama seperti sebelum Anda meminta pembaruan - baik `Instantiated` atau`Updated`.
   + Jika pembaruan gagal, status instance jaringan akan ditampilkan`Update failed`. Pilih tautan untuk setiap tugas yang gagal untuk menentukan alasannya.
   + Jika pembaruan berhasil, status instance jaringan akan ditampilkan`Updated`.

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

**Gunakan CLI untuk memperbarui instance jaringan**  
Gunakan [update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)perintah dengan jenis `UPDATE_NS` pembaruan untuk memperbarui instance jaringan.

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

------