【6G 开发】NV NGC

news2025/7/14 3:07:25

配置

在这里插入图片描述

生成密钥 API Keys

生成您自己的 API 密钥，以便通过 Docker 客户端或通过 NGC CLI 使用 Secrets Manager、NGC Catalog 和 Private Registry 的 NGC 服务
在这里插入图片描述
以下个人 API 密钥已成功生成，可供此组织使用。这是唯一一次显示您的密钥。
请妥善保管您的个人密钥。请勿将其与他人共享，也不要将其存储在他人可见或复制的地方。

NGC API 密钥
使用 NCG CLI、Docker CLI 或 API 通信对 NGC 服务进行身份验证时，需要 NVIDIA NGC API 密钥。NVIDIA NGC 支持两种类型的 API 密钥。

个人 API 密钥
任何 NGC 组织成员用户都可以生成个人 API 密钥。这些密钥与用户在 NGC 组织内的生命周期绑定，最多可以访问分配给用户的权限和服务。在密钥生成步骤中，用户可以配置 API 密钥可以访问哪些 NGC 服务，以及密钥的有效期（从 1 小时到“永不过期”）。

旧版 API 密钥
这是 NGC 自诞生以来提供的原始 API 密钥类型。此类型允许您一次只创建一个“API 密钥”。生成新密钥会自动撤销旧密钥，因为它们无法轮换。创建新密钥后，活动密钥将立即失效。

对于尚未过渡到下一代 API 密钥的服务，NVIDIA 将继续支持此密钥类型。但是，我们鼓励客户在可能的情况下迁移到我们的下一代 API 密钥。

NGC API Keys
NVIDIA NGC API keys are required to authenticate to NGC services using NCG CLI, Docker CLI, or API communication. NVIDIA NGC supports two types of API keys.

Personal API Key
Any user who is a member of an NGC org can generate Personal API Keys. These keys are tied to the user’s lifecycle within the NGC org and can access up to the permissions and services assigned to the user. During the key generation steps, users can configure which NGC services are accessible by the API key and the time-to-live from one hour to ‘never expires’.

NGC CLI

ngc config set

运行结果：

Enter CLI output format type [ascii]. Choices: ['ascii', 'csv', 'json']: ascii
Enter org [no-org]. Choices: ['esee5uzbruax']: esee5uzbruax
Enter team [no-team]. Choices: ['no-team']: no-team
Enter ace [no-ace]. Choices: ['no-ace']: no-ace
Validating configuration...
Successfully validated configuration.
Saving configuration...
Successfully saved NGC configuration to C:\Users\fs\.ngc\config

Docker

For the username, enter ‘$oauthtoken’ exactly as shown. It is a special authentication key for all users.

docker login nvcr.io


Username: $oauthtoken
Password: <Your Key>

运行结果：

Username: $oauthtoken
Password:
Login Succeeded

什么是 NVIDIA Aerial™ CUDA-Accelerated RAN？

NVIDIA Aerial™ CUDA-Accelerated RAN是一个用于构建商用级、软件定义、GPU 加速、云原生 5G/6G 网络的应用程序框架。它支持完全云原生的虚拟 5G RAN 解决方案，可使用商用现货 (COTS) 服务器支持各种下一代边缘 AI 和 RAN 服务。

该平台支持 5G/6G 协议栈第一层 (cuPHY) 的全内联 GPU 加速和第二层 (cuMAC) 的 GPU 加速功能。它支持 gNB 集成 L2/L3（MAC、RLC、PDCP）的全栈框架，以及可管理性和编排功能。空中 CUDA 加速 RAN 还支持非 5G 信号处理用例。

NVIDIA Aerial™ CUDA-Accelerated RAN 套件简化了使用带有 NVIDIA GPU 的 COTS 服务器构建可编程和可扩展的软件定义 5G vRAN 的过程，并且已在商业和研究网络中部署。

这个容器里有什么？

NVIDIA Aerial™ CUDA-Accelerated RAN 容器包括源代码和一个 Docker 容器，该容器由以下部分组成：

Aerial cuPHY： Aerial cuPHY 是一个云原生、软件定义的平台，经过优化可在 NVIDIA DPU/NIC 和 GPU 硬件上运行与 5G/6G 兼容的 gNB 物理层 (L1/PHY) 工作负载。
Aerial cuMAC： Aerial cuMAC 是一个第 2 层 MAC 调度器加速库，通过在 RAN 协议栈的第 2 层中引入具有增强算法的多小区调度器来提高频谱效率。
pyAerial： pyAerial 是一个物理层组件的 Python 库，可用作将设计从模拟到实时操作的工作流程的一部分。
Aerial Data Lake：航空数据湖可与 NVIDIA pyAerial 库结合使用，为基于神经网络构建的第 1 层管道生成训练数据。
Aerial TestMac： Aerial TestMAC 充当 L2/L1 接口，根据预定义的发射模式调度数据包。
Aerial RU Emulator：空中RU模拟器是ORAN FH接口的基本实现。其功能包括验证FH数据包的时序、检查DL IQ样本的完整性以及调度UL IQ样本的传输。
Aerial RAN CoLab Over-the-Air (ARC-OTA)： NVIDIA 空中 RAN CoLab 无线是一个功能齐全的平台，面向下一代无线演进，可简化开发人员的入职和实时网络中的算法开发。

先决条件

CUDA 12.8 driver (570.124.06)
GDRCopy 2.4.1
Nvidia container toolkit:
https://github.com/NVIDIA/nvidia-docker
Docker:
https://docs.docker.com/install/linux/docker-ce/ubuntu/

支持的 GPU 和 NIC 组合：Grace Hopper MGX + BF3

获取容器

使用 docker 登录

sudo docker login nvcr.io

使用以下命令拉取 cuBB 容器：

sudo docker pull nvcr.io/nvidia/aerial/aerial-cuda-accelerated-ran:25-1-cubb

运行容器

使用以下命令运行 cuBB 容器：

sudo docker run --restart unless-stopped -dP --gpus all --network host --shm-size=4096m --privileged -it --device=/dev/gdrdrv:/dev/gdrdrv -v /lib/modules:/lib/modules -v /dev/hugepages:/dev/hugepages -v ~/share:/opt/cuBB/share --userns=host --ipc=host -v /var/log/aerial:/var/log/aerial --name cuBB nvcr.io/nvidia/aerial/aerial-cuda-accelerated-ran:25-1-cubb

sudo docker exec -it cuBB /bin/bash

请注意，–gpus 选项需要 docker 19.03 或更高版本。使用以下命令检查 docker 版本