빠른 시작: 프라이빗 모바일 네트워크 및 사이트 배포 - Azure CLI
Azure Private 5G Core는 엔터프라이즈용 온-프레미스 프라이빗 모바일 네트워크의 일부로 Azure Stack Edge 디바이스에서 5G 코어 네트워크 기능을 배포하고 관리하기 위한 Azure 클라우드 서비스입니다. 이 빠른 시작에서는 Azure CLI를 사용하여 미국 동부 Azure 지역에 다음 리소스를 배포하는 방법을 설명합니다. Azure Private 5G Core를 사용할 수 있는 Azure 지역에 대해서는 지역별 사용할 수 있는 제품을 참조하세요.
- 프라이빗 모바일 네트워크.
- 사이트.
- 기본 서비스 및 모든 SIM 허용 정책(기본 서비스 및 모든 SIM 허용 정책에 설명된 대로).
- 필요에 따라 하나 이상의 SIM 및 SIM 그룹이 있습니다.
Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
필수 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비
- 프라이빗 모바일 네트워크 배포를 위한 필수 구성 요소 작업 및 AKS 클러스터 커미션을 완료합니다.
- 프라이빗 모바일 네트워크 배포를 위한 필수 구성 요소 작업 완료에서 식별한 활성 구독에 대한 액세스 권한이 있는 계정을 사용하여 Azure Portal에 로그인할 수 있는지 확인합니다. 이 계정에는 구독 범위에서 기본 제공 기여자 또는 소유자 역할이 있어야 합니다.
- 프라이빗 모바일 네트워크를 배포하는 데 필요한 정보 수집합니다. SIM을 프로비전하려면 SIM 프로비저닝을 위한 JSON 파일 형식에 설명된 대로 SIM 정보가 포함된 JSON 파일을 준비해야 합니다.
- 사이트에서 Azure Stack Edge Pro 디바이스의 포트 5 및 6에 해당하는 인터페이스의 이름을 식별합니다.
- 사이트에 필요한 정보 수집
- 현재 버전의 패킷 코어에 대한 릴리스 정보 및 ASE(Azure Stack Edge)가 현재 실행 중인 버전에서 지원되는지 여부를 참조하세요. ASE 버전이 최신 패킷 코어와 호환되지 않는 경우 Azure Stack Edge Pro GPU를 업데이트합니다.
이 문서에서 사용되는 Azure CLI 명령
- az mobile-network create
- az mobile-network site create
- az mobile-network pccp create
- az mobile-network pcdp create
- az mobile-network data-network create
- az mobile-network sim group create
- az mobile-network slice create
- az mobile-network service create
- az mobile-network sim policy create
- az mobile network sim create
- az mobile-network attached-data-network create
Azure Cloud Shell 시작
Azure Cloud Shell은 이 항목의 단계를 실행하는 데 무료로 사용할 수 있는 대화형 셸입니다. 공용 Azure 도구가 사전 설치되어 계정에서 사용하도록 구성되어 있습니다.
Cloud Shell을 열려면 코드 블록의 오른쪽 위 모서리에 있는 사용해 보세요를 선택하기만 하면 됩니다. 또한 https://shell.azure.com 로 이동하여 별도의 브라우저 탭에서 Cloud Shell을 시작할 수 있습니다.
Cloud Shell이 열리면 환경에 대해 Bash가 선택되어 있는지 확인합니다. 후속 세션은 Bash 환경에서 Azure CLI를 사용합니다. 복사를 선택하여 코드 블록을 복사하고 Cloud Shell에 붙여넣고 Enter 키를 눌러 실행합니다.
Azure에 로그인
Cloud Shell은 로그인한 초기 계정에서 자동으로 인증됩니다. 다음 스크립트를 통해 다른 구독을 사용하여 로그인하고 <Subscription ID>를 Azure 구독 ID로 바꿉니다. Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
자세한 내용은 활성 구독 설정 또는 대화형으로 로그인을 참조하세요.
프라이빗 모바일 네트워크, 사이트 및 SIM 배포
프라이빗 모바일 네트워크, 사이트 및 SIM을 성공적으로 배포하려면 다음 단계를 완료해야 합니다. 다음 단계로 진행하기 전에 각 단계를 완전히 완료해야 합니다.
모바일 네트워크 리소스 만들기
az mobile-network create를 사용하여 새 모바일 네트워크 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<MOBILENETWORK> |
프라이빗 모바일 네트워크의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
az mobile-network create --location eastus -n <MOBILENETWORK> -g <RESOURCEGROUP> --identifier mcc=001 mnc=01
사이트 리소스 만들기
az mobile-network site를 사용하여 새 사이트 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<MOBILENETWORK> |
만든 개인 모바일 네트워크의 이름을 입력합니다. |
<SITE> |
사이트 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
az mobile-network site create --mobile-network-name <MOBILENETWORK> -n <SITE> -g <RESOURCEGROUP>
패킷 코어 컨트롤 플레인 리소스 만들기
az mobile-network pccp create를 사용하여 새 패킷 코어 컨트롤 플레인 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<ASE> |
ASE의 이름을 입력합니다. |
<CUSTOMLOCATION> |
사용자 지정 위치의 이름을 입력합니다. |
<MOBILENETWORK> |
모바일 네트워크의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
<CONTROLPLANE> |
패킷 코어 컨트롤 플레인의 이름을 입력합니다. |
<SITE> |
사이트의 이름을 입력합니다. |
<IPV4ADDRESS> |
사이트의 IPv4 주소를 입력합니다. |
ASE ID를 가져와 변수에 할당합니다.
ASE_ID=$(databoxedge device show --device-name <ASE> -g <RESOURCEGROUP> --query "id")
사용자 지정 위치 ID를 가져와 변수에 할당합니다.
CUSTOM_LOCATION_ID=$(customlocation show --name <CUSTOMLOCATION> -g <RESOURCEGROUP> --query "id")
사이트 ID를 가져와 변수에 할당합니다.
SITE_ID=$(mobile-network site show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SITE> --query "id")
패킷 코어 컨트롤 플레인을 만듭니다.
az mobile-network pccp create -n <CONTROLPLANE> -g <RESOURCEGROUP> --access-interface name=N2 ipv4Address=<IPV4ADDRESS> --local-diagnostics authentication-type=Password --platform type=AKS-HCI azure-stack-edge-device="{id:$ASE_ID}" customLocation="{id:$CUSTOM_LOCATION_ID}" --sites "[{id:$SITE_ID}]" --sku G0 --location eastus
Packet Core Data Plane 리소스 만들기
az mobile-network pcdp create를 사용하여 새 패킷 코어 데이터 플레인 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<DATAPLANE> |
데이터 평면의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
<CONTROLPLANE> |
패킷 코어 컨트롤 플레인의 이름을 입력합니다. |
az mobile-network pcdp create -n <DATAPLANE> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --access-interface name=N3
데이터 네트워크 만들기
az mobile-network data-network create를 사용하여 새 데이터 네트워크 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<DATANETWORK> |
데이터 네트워크의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
<MOBILENETWORK> |
개인 모바일 네트워크의 이름을 입력합니다. |
az mobile-network data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --location eastus
SIM 그룹 만들기
az mobile-network sim group create를 사용하여 새 패킷 코어 데이터 플레인 리소스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
''을 사용하여 새 SIM 그룹을 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 변수 | 자리 표시자 | 값 |
|---|---|---|
<MOBILENETWORK> |
개인 모바일 네트워크의 이름을 입력합니다. | |
<SIMGROUP> |
SIM 그룹의 이름입니다. | |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
모바일 네트워크 ID를 가져와 변수에 할당합니다.
NETWORK_ID=$(mobile-network show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
SIM 그룹을 만듭니다.
az mobile-network sim group create -n <SIMGROUP> -g <RESOURCEGROUP> --mobile-network "{id:$NETWORK_ID}"
슬라이스 만들기
az mobile-network slice create를 사용하여 새 슬라이스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<MOBILENETWORK> |
프라이빗 모바일 네트워크의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
<SLICE> |
슬라이스의 이름을 입력합니다. |
az mobile-network slice create --mobile-network-name <MOBILENETWORK> -n <SLICE> -g <RESOURCEGROUP> --snssai "{sst:1,sd:123abc}"
서비스 만들기
az mobile-network service create를 사용하여 새 서비스를 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<SERVICE> |
서비스의 이름을 입력합니다. |
<MOBILENETWORK> |
프라이빗 모바일 네트워크의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
az mobile-network service create -n <SERVICE> -g <RESOURCEGROUP> --mobile-network-name <MOBILENETWORK> --pcc-rules "[{ruleName:default-rule,rulePrecedence:10,serviceDataFlowTemplates:[{templateName:IP-to-server,direction:Uplink,protocol:[ip],remoteIpList:[10.3.4.0/24]}]}]" --service-precedence 10
SIM 정책 만들기
az mobile-network sim policy create를 사용하여 새 SIM 정책을 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<SLICE> |
슬라이스의 이름을 입력합니다. |
<DATANETWORK> |
데이터 네트워크의 이름을 입력합니다. |
<SERVICE> |
서비스의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
<SIMPOLICY> |
SIM 정책의 이름을 입력합니다. |
<MOBILENETWORK> |
프라이빗 모바일 네트워크의 이름을 입력합니다. |
사이트 ID를 가져와 변수에 할당합니다.
SLICE_ID=$(mobile-network slice show --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> -n <SLICE> --query "id")
데이터 네트워크 ID를 가져와 변수에 할당합니다.
DATANETWORK_ID=$(mobile-network data-network show -n <DATANETWORK> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
서비스 ID를 가져와 변수에 할당합니다.
SERVICE_ID=$(mobile-network service show -n <SERVICE> --mobile-network-name <MOBILENETWORK> -g <RESOURCEGROUP> --query "id")
SIM 정책을 만듭니다.
az mobile-network sim policy create -g <RESOURCEGROUP> -n <SIMPOLICY> --mobile-network-name <MOBILENETWORK> --default-slice '{id:$SLICE_ID}' --slice-config "[{slice:{id:$SLICE_ID},defaultDataNetwork:{id:$DATANETWORK_ID},dataNetworkConfigurations:[{dataNetwork:{id:$DATANETWORK_ID},allowedServices:[{id:$SERVICE_ID}],sessionAmbr:{uplink:'500 Mbps',downlink:'1 Gbps'}}]}]" --ue-ambr "{uplink:'500 Mbps',downlink:'1 Gbps'}" --location eastus
SIM 만들기
az mobile-network sim create을 사용하여 새 SIM을 만듭니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<SIMGROUP> |
SIM 그룹의 이름을 입력합니다. |
<SIM> |
SIM의 이름입니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
az mobile-network sim create -g <RESOURCEGROUP> --sim-group-name <SIMGROUP> -n <SIM> --international-msi 0000000000 --operator-key-code 00000000000000000000000000000000 --authentication-key 00000000000000000000000000000000
데이터 네트워크 연결
az mobile-network attached-data-network create를 사용하여 앞서 만든 데이터 네트워크를 연결합니다. 예제 명령은 다음 자리 표시자 값을 사용하여 필수 구성 요소: 프라이빗 모바일 네트워크 및 사이트 배포 준비에서 수집한 정보로 바꿉니다.
| 자리 표시자 | 값 |
|---|---|
<DATANETWORK> |
데이터 네트워크의 이름을 입력합니다. |
<CONTROLPLANE> |
패킷 코어 컨트롤 플레인의 이름을 입력합니다. |
<DATAPLANE> |
패킷 코어 데이터 플레인의 이름을 입력합니다. |
<RESOURCEGROUP> |
리소스 그룹의 이름을 입력합니다. |
az mobile-network attached-data-network create -n <DATANETWORK> -g <RESOURCEGROUP> --pccp-name <CONTROLPLANE> --pcdp-name <DATAPLANE> --dns-addresses "[1.1.1.1]" --data-interface name=N6 --address-pool 192.168.1.0/24
리소스 정리
배포를 유지하지 않으려면 리소스 그룹을 삭제합니다.
다음 단계
배포를 유지했다면 프라이빗 모바일 네트워크에서 트래픽을 처리하는 방법을 결정하기 위해 정책 제어 설계를 시작하거나 프라이빗 모바일 네트워크에 사이트 추가할 수 있습니다.