本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS TNB 的网络实例
网络实例是在 AWS TNB 中创建的可以部署的单个网络。
**Topics**
+ [网络实例的生命周期操作](network-life-cycle.md)
+ [使用 AWS TNB 创建网络实例](create-network-instance.md)
+ [使用 TNB 实例化网络实例 AWS](instantiate-network-instance.md)
+ [在 AWS TNB 中更新函数实例](update-function-instance.md)
+ [在 AWS TNB 中更新网络实例](update-network-instance.md)
+ [在 AWS TNB 中查看网络实例](view-network-instance.md)
+ [终止并从 AWS TNB 中删除网络实例](terminate-network-instance.md)
# 网络实例的生命周期操作
AWS TNB允许您使用符合ETSI的标准化管理操作轻松管理网络，以及 SOL003 . SOL005 您可以执行以下生命周期操作：
+ 创建网络
+ 实例化网络
+ 更新网络功能
+ 更新网络实例
+ 查看网络详情和状态
+ 终止网络
下图显示了网络管理操作：
![\[显示网络实例生命周期操作和顺序。\]](http://docs.aws.amazon.com/zh_cn/tnb/latest/ug/images/tnb-ns_state_transitions.png)
# 使用 AWS TNB 创建网络实例
网络实例需在创建了网络包之后创建。创建网络实例后，对其进行实例化。
------
#### [ Console ]
**使用控制台创建网络实例**
1. 打开 AWS TNB 控制台，网址为[https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络**。
1. 选择**创建网络实例**。
1. 为实例输入名称和描述，然后选择**下一步**。
1. 选择网络包，验证详细信息，然后选择**下一步**。
1. 选择**创建网络实例**。
新的网络实例将显示在 “**网络**” 页面上。接下来，实例化这个网络实例。
------
#### [ AWS CLI ]
**要使用创建网络实例 AWS CLI**
+ 使用[create-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/create-sol-network-instance.html)命令创建网络实例。
```
aws tnb create-sol-network-instance --nsd-info-id ^np-[a-f0-9]{17}$ --ns-name "SampleNs" --ns-description "Sample"
```
接下来，实例化这个网络实例。
------
# 使用 TNB 实例化网络实例 AWS
创建网络实例后，必须对其进行实例化。当您实例化网络实例时， AWS TNB 会配置必要的 AWS 基础架构，部署容器化网络功能，并配置网络和访问管理以创建全面运行的网络服务。
------
#### [ Console ]
**使用控制台实例化网络实例**
1. 打开 AWS TNB 控制台，网址为[https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络**。
1. 选择要实例化的网络实例。
1. 选择 “**操作**”，然后选择 “**实例化**”。
1. 在**实例化网络**页面上，查看详细信息，也可以更新参数值。
对参数值的更新仅适用于此网络实例。NSD 和 VNFD 软件包中的参数不会改变。
1. 选择**实例化网络**。
此时将出现 “**部署状态**” 页面。
1. 使用**刷新**图标跟踪您的网络实例的部署状态。您也可以在 “**部署任务**” 部分启用**自动刷新**，以跟踪每个任务的进度。
当部署状态更改为时`Completed`，网络实例即被实例化。
------
#### [ AWS CLI ]
**要使用实例化网络实例 AWS CLI**
1. 使用[instantiate-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/instantiate-sol-network-instance.html)命令实例化网络实例。
```
aws tnb instantiate-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$ --additional-params-for-ns "{\"param1\": \"value1\", \"param2\": \"value2\"}"
```
1. 接下来，查看网络运行状态。
------
# 在 AWS TNB 中更新函数实例
实例化网络实例后，您可以更新网络实例中的函数包。
------
#### [ Console ]
**使用控制台更新函数实例**
1. 打开 AWS TNB 控制台，网址为[https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络**。
1. 选择网络实例。只有当网络实例的状态为时，您才能对其进行更新`Instantiated`。
将显示网络实例页面。
1. 从 “**函数**” 选项卡中，选择要更新的函数实例。
1. 选择**更新**。
1. 输入您的更新优先选项。
1. 选择**更新**。
------
#### [ AWS CLI ]
**使用 CLI 更新函数实例**
使用`MODIFY_VNF_INFORMATION`更新类型的[update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)命令来更新网络实例中的函数实例。
```
aws tnb update-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$ --update-type MODIFY_VNF_INFORMATION --modify-vnf-info ...
```
------
# 在 AWS TNB 中更新网络实例
实例化网络实例后，您可能需要更新基础设施或应用程序。为此，您需要更新网络实例的网络包和参数值，然后部署更新操作以应用更改。
## 注意事项
+ 您可以更新处于`Instantiated`或`Updated`状态的网络实例。
+ 更新网络实例时，`UpdateSolNetworkService`API 使用新的网络包和参数值来更新网络实例的拓扑。
+ 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"
|
| Amazon EKS Worker 节点 | 您可以更新`EKSManagedNode kubernetes_version`参数的值以将您的节点组升级到较新的 Amazon EKS 版本，也可以更新`ami_id`参数以将您的节点组升级到最新 EKS 优化的 AMI。 您可以更新的 AMI ID `EKSSelfManagedNode`。AMI 的 Amazon EKS 版本必须与亚马逊 EKS 集群版本相同或最多低于 2 个版本。例如，如果亚马逊 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 Node 和 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/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络**。
1. 选择网络实例。只有当网络实例的状态为`Instantiated`或时，您才能对其进行更新`Updated`。
1. 选择 “**操作**” 和 “**更新”**。
将出现 “**更新实例**” 页面，其中包含当前基础设施中的网络详细信息和参数列表。
1. 选择新的网络套餐。
新网络包中的参数显示在 “**更新的参数**” 部分中。
1. （可选）在 “**已更新的参数” 部分中更新参数**值。有关您可以更新的参数值列表，请参阅[您可以更新的参数](#update-parameters)。
1. 选择 “**更新网络**”。
AWS TNB 验证请求并开始部署。此时将出现 “**部署状态**” 页面。
1. 使用**刷新**图标跟踪您的网络实例的部署状态。您也可以在 “**部署任务**” 部分启用**自动刷新**，以跟踪每个任务的进度。
当部署状态更改为时`Completed`，网络实例即会更新。
1.
+ 如果验证失败，则网络实例将保持与您请求更新之前相同的状态——可以是`Instantiated`或`Updated`。
+ 如果更新失败，则会显示网络实例状态`Update failed`。为每项失败的任务选择链接以确定原因。
+ 如果更新成功，则会显示`Updated`网络实例状态。
------
#### [ AWS CLI ]
**使用 CLI 更新网络实例**
使用带有`UPDATE_NS`更新类型的[update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)命令来更新网络实例。
```
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\"}}"
```
------
# 在 AWS TNB 中查看网络实例
了解如何查看网络实例。
------
#### [ Console ]
**使用控制台查看网络实例**
1. 打开 AWS TNB 控制台，网址为[https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络实例**。
1. 使用搜索框找到网络实例。
------
#### [ AWS CLI ]
**要查看网络实例，请使用 AWS CLI**
1. 使用[list-sol-network-instances](https://docs.aws.amazon.com/cli/latest/reference/tnb/list-sol-network-instances.html)命令列出您的网络实例。
```
aws tnb list-sol-network-instances
```
1. 使用[get-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/get-sol-network-instance.html)命令查看有关特定网络实例的详细信息。
```
aws tnb get-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$
```
------
# 终止并从 AWS TNB 中删除网络实例
要删除网络实例，实例必须处于已终止状态。
------
#### [ Console ]
**使用控制台终止和删除网络实例**
1. 打开 AWS TNB 控制台，网址为[https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/)。
1. 在导航窗格中，选择**网络**。
1. 选择网络实例的 ID。
1. 选择**终止**。
1. 提示进行确认时，输入 ID，然后选择**终止**。
1. 刷新以跟踪网络实例的状态。
1. （可选）选择网络实例并选择**删除**。
------
#### [ AWS CLI ]
**要终止和删除网络实例，请使用 AWS CLI**
1. 使用[terminate-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/terminate-sol-network-instance.html)命令终止网络实例。
```
aws tnb terminate-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$
```
1. （可选）使用[delete-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/delete-sol-network-instance.html)命令删除网络实例。
```
aws tnb delete-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$
```
------