---
tags: 套件部署, 5G O-RAN
GA: UA-79596126-4
title: <5G O-RAN 筆記3> xApp 部署/刪除/重新部署
---
{%hackmd BJrTq20hE %}
###### 作者: 史啜林
###### 撰寫日期：2021/11/24
# <5G O-RAN 筆記3> xApp 部署/刪除/重新部署

xApp 是部署於 Near-RT RIC 的一種應用，這邊就基於之前說的來進行部署
### 事前確認
首先確認port 32080是否已被service 「r4-infrastructure-kong-proxy」使用

$ kubectl get service -A | grep 32080


此時，請先確認TCP port 32080 是否也同時被「kube-proxy」使用

$ netstat -anp | grep 32080


以下提供兩種解法，選擇好後才繼續進行下一步：
1. 將官方指令中「$(hostname)」修改為「r4-infrastructure-kong-proxy」的 Cluster ip 地址(以下指令僅為示範差異，不要執行)

# 修改前
$ curl --location --request POST "http://$(hostname):32080/onboard/api/v1/onboard/download"  --header 'Content-Type: application/json' --data-binary "@./onboard.hw.url"

# 修改後
$ curl --location --request POST "http://10.97.175.213:32080/onboard/api/v1/onboard/download"  --header 'Content-Type: application/json' --data-binary "@./onboard.hw.url"

2. 設定port-forwarding功能

# 確認pod名稱
$ kubectl get pods -A | grep kong
ricplt        r4-infrastructure-kong-646b68bd88-tljzz                      2/2     Running     1          4h20m

# 設定port-forwarding (該視窗不可關閉，可於背景執行)
$ kubectl port-forward r4-infrastructure-kong-646b68bd88-tljzz 32088:32080 -n ricplt

當有資料進來時，便可以看到Handling的訊息出現

接著後續指令便可透過「localhost」的方式進行(以下指令僅為示範差異，不要執行)

# 修改前
$ curl --location --request POST "http://$(hostname):32080/onboard/api/v1/onboard/download"  --header 'Content-Type: application/json' --data-binary "@./onboard.hw.url"

# 修改後
$ curl --location --request POST "http://localhost:32088/onboard/api/v1/onboard/download"  --header 'Content-Type: application/json' --data-binary "@./onboard.hw.url"

---
### 部署xApp
取得「Helloworld xApp」設定訊息拉下來，並存成url檔

$ echo '{ "config-file.json_url": "https://gerrit.o-ran-sc.org/r/gitweb?p=ric-app/hw.git;a=blob_plain;f=init/config-file.json;hb=HEAD" }' > onboard.hw.url

On-boarding xApp (這裡示範第二個解法)

$ curl --location --request POST "http://localhost:32088/onboard/api/v1/onboard/download"  --header 'Content-Type: application/json' --data-binary "@./onboard.hw.url"


驗證helm charts

$ curl --location --request GET "http://localhost:32088/onboard/api/v1/charts"


啟動xApp pod

$ curl --location --request POST "http://localhost:32088/appmgr/ric/v1/xapps"  --header 'Content-Type: application/json'  --data-raw '{"xappName": "hwxapp"}'
$ kubectl get pods -n ricxapp  # 要等待一下才會啟動


至此 xApp 部署已完成

---
### 刪除 xApp
首先中斷 xApp 的運行

$ kubectl get all -n ricxapp
$ kubectl delete deployment.apps/ricxapp-hwxapp -n ricxapp


找到運行管理 xApp 的 pod (appmgr)以及其 container

$ kubectl get pods -A | grep appmgr
$ docker container list | grep appmgr


接著進入 appmgr container 中，確認目前 appmr 所管理的 xApp 列表

$ docker exec -it 3c71f53defa4 sh
> pwd
> which helm
> helm list


從```helm list```可以發現即使 xApp 的服務已經刪除，然而原本的 xApp 仍然還存在 appmgr 的儲存列表中
因此，若要完全刪除此 xApp，需進入 appmgr 進行刪除

> helm delete --purge hwxapp
> helm list


至此一個 xApp 完整被刪除

---
### 重新部署 xApp
首先確認 helm server 是正在運行的

$ helm serve


接著進入 appmgr container 中刪除 stable 選項，否則重新部署時會有超時(timeout)的問題

$ docker exec -it 3c71f53defa4 sh
> helm repo list
> helm repo remove stable
> helm repo list


接著重新執行部署 xApp 的流程
一樣先取得 url (若已經有了，則略過此步驟)，將 xApp 上傳至 helm 儲存庫，最後部署 xApp