在 AWS TNB 中更新網路執行個體 - AWS 電信網路建置器
考量事項您可以更新的參數更新網路執行個體

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 AWS TNB 中更新網路執行個體

執行個體化網路執行個體之後，您可能需要更新基礎設施或應用程式。若要這樣做，請更新網路執行個體的網路套件和參數值，並部署更新操作以套用變更。

考量事項

  • 您可以更新處於 Instantiated或 Updated 狀態的網路執行個體。

  • 當您更新網路執行個體時，UpdateSolNetworkServiceAPI 會使用新的網路套件和參數值來更新網路執行個體的拓撲。

  • AWS TNB 會驗證網路執行個體中的 NSD 和 VNFD 參數數量不超過 200。強制執行此限制，以防止惡意人士傳遞影響服務的錯誤或巨型承載。

您可以更新的參數

您可以在更新執行個體化網路執行個體時更新下列參數：

參數 描述 範例：之前 範例： 之後

Amazon EKS 叢集版本

您可以將 Amazon EKS 叢集控制平面version參數的值更新為下一個次要版本。您無法降級版本。

 
EKSCluster:
    type: tosca.nodes.AWS.Compute.EKS
    properties:
      version: "1.28"
 
EKSCluster:
    type: tosca.nodes.AWS.Compute.EKS
    properties:
      version: "1.29"

Amazon EKS 工作者節點

您可以更新 EKSManagedNode kubernetes_version 參數的值，將節點群組升級至較新的 Amazon EKS 版本，或更新 ami_id 參數，將節點群組升級至最新的 EKS 最佳化 AMI。

您可以更新 的 AMI IDEKSSelfManagedNode。AMI 的 Amazon EKS 版本必須與 Amazon EKS 叢集版本相同或低於 2 個版本。例如，如果 Amazon EKS 叢集版本為 1.31，則 Amazon EKS AMI 版本必須為 1.31、1.30 或 1.29。

 
EKSManagedNodeGroup01:
    ...
    properties:
      kubernetes_version: "1.28"
    EKSSelfManagedNode01:
      compute:
        compute:
          properties:
            ami_id: "ami-123123OLD"
 
EKSManagedNodeGroup01:
    ...
    properties:
      kubernetes_version: "1.29"
    EKSSelfManagedNode01:
      compute:
        compute:
          properties:
            ami_id: "ami-123123NEW"

Amazon EKS 節點群組

您可以根據您的運算需求新增或移除節點群組。

刪除現有節點群組並新增節點群組時，請確保新節點群組的 IDs 與已刪除節點群組不同，否則操作會被視為節點群組修改，而不是刪除和新增。請注意，對於現有的節點群組，只能更新一組有限的參數。捲動此資料表以查看您可以更新的參數。

 
Free5GCEKSNode01:
  type: tosca.nodes.AWS.Compute.EKSManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...
Free5GCEKSNode02: # Deleted Nodegroup
  type: tosca.nodes.AWS.Compute.EKSManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...
Free5GCEKSNode03: # Deleted Nodegroup  
  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...
 
Free5GCEKSNode01:
  type: tosca.nodes.AWS.Compute.EKSManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...
Free5GCEKSNode04: # New Nodegroup
  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...
Free5GCEKSNode05: # New Nodegroup  
  type: tosca.nodes.AWS.Compute.EKSManagedNode
  ...
    scaling:
      properties:
        desired_size: 1
        min_size: 1
        max_size: 1
  ...

擴展屬性

您可以更新 EKSManagedNode和 EKSSelfManagedNode TOSCA 節點的擴展屬性。

 
EKSNodeGroup01:
    ...
    scaling:
        properties:
            desired_size: 1
            min_size: 1
            max_size: 1
 
EKSNodeGroup01:
    ...
    scaling:
        properties:
            desired_size: 2
            min_size: 0
            max_size: 2

Amazon EBS CSI 外掛程式屬性

您可以在 Amazon EKS 叢集上啟用或停用 Amazon EBS CSI 外掛程式。您也可以變更外掛程式版本。

 
EKSCluster:
  capabilities:
   ...
    ebs_csi:
      properties:
        enabled: false
 
EKSCluster:
  capabilities:
   ...
    ebs_csi:
      properties:
        enabled: true
        version: "v1.30.0-eksbuild.1"

根磁碟區大小

您可以新增、移除或更新 EKSManagedNode 和 EKSSelfManagedNode TOSCA 節點的根磁碟區大小屬性。

 
Free5GCEKSNode01:
      ...
      capabilities:        
        compute:
          properties:
            root_volume_size: 50
 
Free5GCEKSNode01:
      ...
      capabilities:
        compute:
          properties:            
            root_volume_size: 100

VNF

您可以在 NSD 中參考 VNFs並使用 VNFDeployment TOSCA 節點將其部署至在 NSD 中建立的叢集。在更新過程中，您將能夠新增、更新和刪除網路的 VNFs。

 
vnfds:
  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"
    namespace: "vnf1"
  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"
    namespace: "vnf2" // Deleted VNF
...
SampleVNF1HelmDeploy:
      type: tosca.nodes.AWS.Deployment.VNFDeployment
      requirements:
        cluster: EKSCluster
        vnfs:
          - vnf1.SampleVNF1
          - vnf2.SampleVNF2
 
vnfds:
  - descriptor_id: "59f77222-79e9-4dc1-be53-5712ad06e31b"
    namespace: "vnf1" // Updated VNF
  - descriptor_id: "b7e072dc-839d-4fac-916c-561a166da1fc"
    namespace: "vnf3" // Added VNFn
....
SampleVNF1HelmDeploy:
      type: tosca.nodes.AWS.Deployment.VNFDeployment
      requirements:
        cluster: EKSCluster
        vnfs:
          - vnf1.SampleVNF1
          - vnf3.SampleVNF3

勾點

若要在建立網路函數之前和之後執行生命週期操作，請將 pre_create和 post_create掛鉤新增至VNFDeployment節點。

在此範例中，勾PreCreateHook點會在 vnf3.SampleVNF3 執行個體化之前執行，而PostCreateHook勾點會在 vnf3.SampleVNF3 執行個體化之後執行。

 
vnfds:
  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"
    namespace: "vnf1"
  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"
    namespace: "vnf2"
...
SampleVNF1HelmDeploy:
  type: tosca.nodes.AWS.Deployment.VNFDeployment
  requirements:
    cluster: EKSCluster
    vnfs:
      - vnf1.SampleVNF1
      - vnf2.SampleVNF2 // Removed during update
 
vnfds:
  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"
    namespace: "vnf1"
  - descriptor_id: "b7e072dc-839d-4fac-916c-561a166da1fc"
    namespace: "vnf3"
....

SampleVNF1HelmDeploy:
  type: tosca.nodes.AWS.Deployment.VNFDeployment
  requirements:
    cluster: EKSCluster
    vnfs:
      - vnf1.SampleVNF1 // No change to this function, as the namespace and uuid remain the same
      - vnf3.SampleVNF3 // New VNF as the namespace, vnf3, was not previously present
  interfaces:
    Hook:
      post_create: PostCreateHook
      pre_create: PreCreateHook

勾點

若要在更新網路函數之前和之後執行生命週期操作，您可以將pre_update勾點和post_update勾點新增至VNFDeployment節點。

在此範例中， PreUpdateHook將在 vnf1.SampleVNF1 更新前執行，PostUpdateHook並在 vnf1.SampleVNF1 更新至命名空間 vnf1 更新 所指示uuid的vnf套件後執行。

 
vnfds:
  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"
    namespace: "vnf1"
  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"
    namespace: "vnf2"
...

SampleVNF1HelmDeploy:
  type: tosca.nodes.AWS.Deployment.VNFDeployment
  requirements:
    cluster: EKSCluster
    vnfs:
      - vnf1.SampleVNF1
      - vnf2.SampleVNF2 

vnfds:
  - descriptor_id: "0ebe4e95-bd87-44bd-b8a1-918466606a14"
    namespace: "vnf1"
  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"
    namespace: "vnf2"

...

SampleVNF1HelmDeploy:
  type: tosca.nodes.AWS.Deployment.VNFDeployment
  requirements:
    cluster: EKSCluster
    vnfs:
      - vnf1.SampleVNF1 // A VNF update as the uuid changed for namespace "vnf1"
      - vnf2.SampleVNF2 // No change to this function as namespace and uuid remain the same
  interfaces:
    Hook:
      pre_update: PreUpdateHook
      post_update: PostUpdateHook

子網路

您可以從網路新增和刪除子網路。刪除子網路之前，請確認網路中的任何資源都不會使用該子網路。

 
Free5GCSubnet01: #Deleted Subnet
  type: tosca.nodes.AWS.Networking.Subnet
  properties:
    type: "PUBLIC"
    availability_zone: { get_input: subnet_01_az }
    cidr_block: { get_input: subnet_01_cidr_block }
  requirements:
    route_table: Free5GCRouteTable
    vpc: Free5GCVPC
 
Free5GCSubnet02: #New Subnet
  type: tosca.nodes.AWS.Networking.Subnet
  properties:
    type: "PUBLIC"
    availability_zone: { get_input: subnet_02_az }
    cidr_block: { get_input: subnet_02_cidr_block }
  requirements:
    route_table: Free5GCRouteTable
    vpc: Free5GCVPC

安全群組

您可以從網路新增和刪除安全群組。刪除安全群組之前，請確認網路中的任何資源都不會使用該安全群組。

 
Free5GCSecurityGroup01: #Deleted Security Group
  type: tosca.nodes.AWS.Networking.SecurityGroup
  properties:
    description: "SecurityGroup for Free5GC cluster"
    name: "Free5GCSecurityGroup01"
    tags:
      - "Name=Free5GCEKSAdditionalSecurityGroup"
  requirements:
    vpc: Free5GCVPC

Free5GCSecurityGroupEgressRule01: #Deleted Security Group Egress Node
  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule
  properties:
    ip_protocol: "tcp"
    from_port: 8000
    to_port: 9000
    description: "Egress Rule for free5GC cluster"
    cidr_ip : "172.10.10.1/24"
  requirements:
    security_group: Free5GCSecurityGroup01

Free5GCSecurityGroupIngressRule01: #Deleted Security Group Ingress Node
  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule
  properties:
    ip_protocol: "tcp"
    from_port: 8000
    to_port: 9000
    description: "Ingress Rule for free5GC cluster"
    cidr_ip: "172.10.10.1/24"
  requirements:
    security_group: Free5GCSecurityGroup01
 
Free5GCSecurityGroup02: #New Security Group
  type: tosca.nodes.AWS.Networking.SecurityGroup
  properties:
    description: "SecurityGroup for Free5GC cluster"
    name: "Free5GCSecurityGroup02"
    tags:
      - "Name=Free5GCEKSAdditionalSecurityGroup"
  requirements:
    vpc: Free5GCVPC
   
Free5GCSecurityGroupEgressRule02: #New Security Group Egress Node
  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule
  properties:
    ip_protocol: "tcp"
    from_port: 8000
    to_port: 9000
    description: "Egress Rule for free5GC cluster"
    cidr_ip: "172.10.10.1/24"
  requirements:
    security_group: Free5GCSecurityGroup02
   
Free5GCSecurityGroupIngressRule02: #New Security Group Ingress Node
  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule
  properties:
    ip_protocol: "tcp"
    from_port: 8000
    to_port: 9000
    description: "Ingress Rule for free5GC cluster"
    cidr_ip: "172.10.10.1/24"
  requirements:
    security_group: Free5GCSecurityGroup02

網路介面

您可以從網路新增、修改和刪除 ENIs。

 
Free5GCENI01: #Modified ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 2
  requirements:
    subnet: Free5GCENISubnet01
    security_groups:
      - Free5GCSecurityGroup01

Free5GCENI02: #Modified ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 3
    source_dest_check: true
  requirements:
    subnet: Free5GCENISubnet01

Free5GCENI04: #Deleted ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 4
    source_dest_check: true
  requirements:
    subnet: Free5GCENISubnet01

Free5GCENI01: #Modified ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 2
  requirements:
    subnet: Free5GCENISubnet02
    security_groups:
      - Free5GCSecurityGroup01

Free5GCENI02: #Modified ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 3
    source_dest_check: true
  requirements:
    subnet: Free5GCENISubnet01
    security_groups:
      - Free5GCSecurityGroup01

Free5GCENI03: #New ENI
  type: tosca.nodes.AWS.Networking.ENI
  properties:
    device_index: 3
  requirements:
    subnet: Free5GCSubnet01
    security_groups:
      - Free5GCSecurityGroup01

更新網路執行個體

Console
使用主控台更新網路執行個體

  1. 在 https：//https://console.aws.amazon.com/tnb/ 開啟 AWS TNB 主控台。

  2. 在導覽窗格中，選擇網路。

  3. 選取網路執行個體。只有在網路執行個體的狀態為 Instantiated或 時，您才能更新網路執行個體Updated。

  4. 選擇動作和更新。

    更新執行個體頁面會顯示網路詳細資訊，以及目前基礎設施中的參數清單。

  5. 選擇新的網路套件。

    新網路套件中的參數會出現在更新參數區段中。

  6. 或者，更新更新參數區段中的參數值。如需您可以更新的參數值清單，請參閱 您可以更新的參數。

  7. 選擇更新網路。

    AWS TNB 會驗證請求並啟動部署。部署狀態頁面隨即出現。

  8. 使用重新整理圖示來追蹤網路執行個體的部署狀態。您也可以在部署任務區段中啟用自動重新整理，以追蹤每個任務的進度。

    當部署狀態變更為 時Completed，網路執行個體會更新。

    • 如果驗證失敗，網路執行個體會保持與請求更新之前相同的狀態 - Instantiated或 Updated。

    • 如果更新失敗，網路執行個體狀態會顯示 Update failed。選擇每個失敗任務的連結，以判斷原因。

    • 如果更新成功，網路執行個體狀態會顯示 Updated。

AWS CLI
使用 CLI 更新網路執行個體

使用 update-sol-network-instance 命令搭配UPDATE_NS更新類型來更新網路執行個體。

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