在 AWS TNB 中更新网络实例 - AWS 电信网络生成器
注意事项您可以更新的参数更新网络实例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 AWS TNB 中更新网络实例

实例化网络实例后，您可能需要更新基础设施或应用程序。为此，您需要更新网络实例的网络包和参数值，然后部署更新操作以应用更改。

注意事项

  • 您可以更新处于Instantiated或Updated状态的网络实例。

  • 更新网络实例时，UpdateSolNetworkServiceAPI 使用新的网络包和参数值来更新网络实例的拓扑。

  • AWS TNB 验证网络实例中 NSD 和 VNFD 参数的数量是否不超过 200。强制执行此限制是为了防止不良行为者通过错误或庞大的有效载荷来影响服务。

您可以更新的参数

更新实例化的网络实例时，您可以更新以下参数：

参数 描述 示例：之前 示例：之后

亚马逊 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"

亚马逊 EKS 工作节点

您可以更新EKSManagedNode kubernetes_version参数的值以将您的节点组升级到较新的 Amazon EKS 版本，也可以更新ami_id参数以将您的节点组升级到最新 EKS 优化的 AMI。

您可以更新的 AMI ID EKSSelfManagedNode。AMI 的 Amazon EKS 版本必须与亚马逊 EKS 集群版本相同或最多低两个版本。例如，如果亚马逊 EKS 集群版本为 1.31，则亚马逊 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"

亚马逊 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

亚马逊 EBS CSI 插件属性

您可以在亚马逊 EKS 集群上启用或禁用 Amazon EBS CSI 插件。您也可以更改插件版本。

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

根卷大小

您可以添加、移除或更新 EKSManaged节点和 EKSSelf ManagedNode 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 所指示uuid的vnf包之后vnf1.SampleVNF1运行。

 
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. 打开 AWS TNB 控制台，网址为https://console.aws.amazon.com/tnb/。

  2. 在导航窗格中，选择网络。

  3. 选择网络实例。只有当网络实例的状态为Instantiated或时，您才能对其进行更新Updated。

  4. 选择 “操作” 和 “更新”。

    将出现 “更新实例” 页面，其中包含当前基础设施中的网络详细信息和参数列表。

  5. 选择新的网络套餐。

    新网络包中的参数显示在 “更新的参数” 部分中。

  6. （可选）更新已更新的参数部分中的参数值。有关您可以更新的参数值列表，请参阅您可以更新的参数。

  7. 选择 “更新网络”。

    AWS TNB 验证请求并开始部署。此时将出现 “部署状态” 页面。

  8. 使用刷新图标跟踪您的网络实例的部署状态。您也可以在 “部署任务” 部分启用自动刷新，以跟踪每个任务的进度。

    当部署状态更改为时Completed，网络实例即会更新。

    • 如果验证失败，则网络实例将与您请求更新之前的状态保持不变，可以是Instantiated或Updated。

    • 如果更新失败，则会显示网络实例状态Update failed。为每项失败的任务选择链接以确定原因。

    • 如果更新成功，则会显示Updated网络实例状态。

AWS CLI
使用 CLI 更新网络实例

使用带有UPDATE_NS更新类型的update-sol-network-instance命令来更新网络实例。

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