Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Changes to adapt to R2 cluster configurations #11

Merged
merged 5 commits into from
Dec 19, 2023
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 90 additions & 1 deletion workloads/oai/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,98 @@
# OAI Packages

Packages for deploying the following are stored here
Packages for deploying the following are stored in the folder

- OAI RAN custom controller
- OAI CU-CP
- OAI CU-UP
- OAI DU
- OAI UE SIM
- Network for RAN and Core deployments
- Workload cluster for RAN and Core deployments

PackageVariant and PackageVariantSets for deploying OAI RAN are also stored in this folder.

# Steps to deploy OAI RAN on Nephio

## Step 0: Prerequisite

1. Nephio should be installed.
2. Verify Network required for OAI RAN and Core should should be installed.
Perform the following to verify in the Nephio management cluster.
3. Catalog repository need to be registered.
Since the OAI RAN packages are in workloads/oai of https://github.com/josephthaliath/catalog.git repository,
josephthaliath marked this conversation as resolved.
Show resolved Hide resolved
we need to register the repository with --directory option

e.g. kpt alpha repo register --namespace default https://github.com/josephthaliath/catalog.git --directory=workloads/oai

Also the following tags need to be created for upstream repository(https://github.com/josephthaliath/catalog.git) used:
1. workloads/oai/oai-ran-operator/v1
2. workloads/oai/pkg-example-cucp-bp/v1
3. workloads/oai/pkg-example-cuup-bp/v1
4. workloads/oai/pkg-example-du-bp/v1
5. workloads/oai/pkg-example-ue-bp/v1

```bash
kubectl get networks
```
Verify output as shown below.

```console
NAME REPO_STATUS
vpc-cu-e1-srl True
vpc-cudu-f1-srl True
vpc-internal-srl True
vpc-internet-srl True
vpc-ran-srl True
```
3. OAI core components should be deployed before deploying OAI RAN.
Steps are mentioned here: https://github.com/OPENAIRINTERFACE/oai-packages/blob/r2/README.md


## Step 2: Deploy OAI RAN NF operator

Execute the command as shown below in Nephio Management cluster

```bash
kubectl apply -f package-variants/oai-ran-operator.yaml
```
Check OAI RAN operators pods are in running state in all clusters.

```bash
kubectl get pods -n oai-ran-operators
```

## Step 3: Deploy OAI RAN NFs

Deploy OAI CU CP using the below command in Nephio Management cluster

```bash
kubectl apply -f package-variants/oai-cucp.yaml
```
Check OAI CU CP pod is in running state in regional cluster.

```bash
kubectl get pods -n oai-ran-cucp
```
Deploy OAI CU UP using the below command in Nephio Management cluster

```bash
kubectl apply -f package-variants/oai-cuup.yaml
```

Check OAI CU UP pod is in running state in edge cluster.

```bash
kubectl get pods -n oai-ran-cuup
```
Deploy OAI DU using the below command in Nephio Management cluster

```bash
kubectl apply -f package-variants/oai-du.yaml
```

Check OAI DU pod is in running state in edge cluster.

```bash
kubectl get pods -n oai-ran-du
```
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
apiVersion: config.porch.kpt.dev/v1alpha1
kind: PackageVariant
metadata:
name: edge-oai-cucp
name: regional-oai-cucp
spec:
upstream:
repo: catalog
package: pkg-example-cucp-bp
revision: v1
downstream:
repo: edge02
repo: regional
package: oai-ran-cucp
annotations:
approval.nephio.org/policy: initial
injectors:
- name: edge02
- name: regional
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ spec:
package: pkg-example-cuup-bp
revision: v1
downstream:
repo: edge01
repo: edge
package: oai-ran-cuup
annotations:
approval.nephio.org/policy: initial
injectors:
- name: edge01
- name: edge
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ spec:
package: pkg-example-du-bp
revision: v1
downstream:
repo: edge01
repo: edge
package: oai-ran-du
annotations:
approval.nephio.org/policy: initial
injectors:
- name: edge01
- name: edge
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ spec:
package: pkg-example-ue-bp
revision: v1
downstream:
repo: edge01
repo: edge
package: oai-ran-ue
annotations:
approval.nephio.org/policy: initial
injectors:
- name: edge01
- name: edge
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,6 @@ replacements:
kind: Interface
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Dependency
fieldPaths:
Expand Down
14 changes: 0 additions & 14 deletions workloads/oai/pkg-example-cucp-bp/apply-replacements-owner.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,6 @@ replacements:
options:
delimiter: '-'
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have found apply-replacements with delimiters to be very fragile, I would avoid them if possible (maybe a future update, or eventually I would hope these become unnecessary with the implementation of CEL for function inputs)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure @johnbelamaric , we will consider it in the next updates.

index: 1
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: Dependency
fieldPaths:
Expand Down
8 changes: 4 additions & 4 deletions workloads/oai/pkg-example-cucp-bp/config_ran_nf.yaml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
apiVersion: workload.nephio.org/v1alpha1
kind: NFConfig
metadata:
name: cucp-nf-config-edge01
name: cucp-nf-config
namespace: example
spec:
configRefs:
- apiVersion: workload.nephio.org/v1alpha1
kind: RANConfig
metadata:
name: ranconfig-edge01
name: ranconfig
namespace: default
spec:
cellIdentity: 12345678L
Expand All @@ -23,7 +23,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: PLMN
metadata:
name: plmn-edge01
name: plmn
namespace: default
spec:
PLMNInfo:
Expand All @@ -37,7 +37,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: OAIConfig
metadata:
name: oai-nf-config-edge01
name: oai-nf-config
namespace: default
spec:
image: "docker.io/oaisoftwarealliance/oai-gnb:2023.w19"
4 changes: 1 addition & 3 deletions workloads/oai/pkg-example-cucp-bp/cucpdeployment.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,7 @@ metadata:
spec:
provider: cucp.openairinterface.org
capacity:
maxDownlinkThroughput: 100M
maxUplinkThroughput: 1M
parametersRefs:
- apiVersion: workload.nephio.org/v1alpha1
kind: NFConfig
name: cucp-nf-config-edge01
name: cucp-nf-config
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,6 @@ replacements:
kind: Interface
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Dependency
fieldPaths:
Expand Down
14 changes: 0 additions & 14 deletions workloads/oai/pkg-example-cuup-bp/apply-replacements-owner.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,6 @@ replacements:
options:
delimiter: '-'
index: 1
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: Dependency
fieldPaths:
Expand Down
8 changes: 4 additions & 4 deletions workloads/oai/pkg-example-cuup-bp/config_ran_nf.yaml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
apiVersion: workload.nephio.org/v1alpha1
kind: NFConfig
metadata:
name: cuup-nf-config-edge01
name: cuup-nf-config
namespace: example
spec:
configRefs:
- apiVersion: workload.nephio.org/v1alpha1
kind: RANConfig
metadata:
name: ranconfig-edge01
name: ranconfig
namespace: default
spec:
cellIdentity: 12345678L
Expand All @@ -23,7 +23,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: PLMN
metadata:
name: plmn-edge01
name: plmn
namespace: default
spec:
PLMNInfo:
Expand All @@ -37,7 +37,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: OAIConfig
metadata:
name: oai-nf-config-edge01
name: oai-nf-config
namespace: default
spec:
image: "docker.io/oaisoftwarealliance/oai-nr-cuup:2023.w19"
5 changes: 1 addition & 4 deletions workloads/oai/pkg-example-cuup-bp/cuupdeployment.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,7 @@ metadata:
namespace: example
spec:
provider: cuup.openairinterface.org
capacity:
maxDownlinkThroughput: 100M
maxUplinkThroughput: 1M
parametersRefs:
- apiVersion: workload.nephio.org/v1alpha1
kind: NFConfig
name: cuup-nf-config-edge01
name: cuup-nf-config
Original file line number Diff line number Diff line change
Expand Up @@ -29,14 +29,6 @@ replacements:
kind: Interface
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/namespace]
- select:
kind: Dependency
fieldPaths:
Expand Down
14 changes: 0 additions & 14 deletions workloads/oai/pkg-example-du-bp/apply-replacements-owner.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,6 @@ replacements:
options:
delimiter: '-'
index: 1
- select:
kind: Capacity
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: DataNetwork
fieldPaths:
- metadata.annotations.[specializer.nephio.org/owner]
options:
delimiter: '-'
index: 1
- select:
kind: Dependency
fieldPaths:
Expand Down
8 changes: 4 additions & 4 deletions workloads/oai/pkg-example-du-bp/config_ran_nf.yaml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
apiVersion: workload.nephio.org/v1alpha1
kind: NFConfig
metadata:
name: du-nf-config-edge01
name: du-nf-config
namespace: example
spec:
configRefs:
- apiVersion: workload.nephio.org/v1alpha1
kind: RANConfig
metadata:
name: ranconfig-edge01
name: ranconfig
namespace: default
spec:
cellIdentity: 12345678L
Expand All @@ -23,7 +23,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: PLMN
metadata:
name: plmn-edge01
name: plmn
namespace: default
spec:
PLMNInfo:
Expand All @@ -37,7 +37,7 @@ spec:
- apiVersion: workload.nephio.org/v1alpha1
kind: OAIConfig
metadata:
name: oai-nf-config-edge01
name: oai-nf-config
namespace: default
spec:
image: "docker.io/oaisoftwarealliance/oai-gnb:2023.w19"
Loading