Skip to content

Commit

Permalink
Fix formatting
Browse files Browse the repository at this point in the history
  • Loading branch information
johnbelamaric committed Aug 22, 2023
1 parent ce03f52 commit 47eea05
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 16 deletions.
22 changes: 15 additions & 7 deletions install-guide/demo-vagrant-windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,13 @@

## Networking

The Vagrant networking will not work on Windows to allow access to the Nephio Web UI and Gitea Web UI due the [Hyper-V limitation](https://developer.hashicorp.com/vagrant/docs/providers/hyperv/limitations#limited-networking).
Meanwhile, for [VirtualBox](https://developer.hashicorp.com/vagrant/docs/providers/virtualbox/networking#virtualbox-nic-type) (used here), we can create an internal network by adding the following line to the Vagrant.configure:
The Vagrant networking will not work on Windows to allow access to the Nephio
Web UI and Gitea Web UI due the [Hyper-V
limitation](https://developer.hashicorp.com/vagrant/docs/providers/hyperv/limitations#limited-networking).
Meanwhile, for
[VirtualBox](https://developer.hashicorp.com/vagrant/docs/providers/virtualbox/networking#virtualbox-nic-type)
(used here), we can create an internal network by adding the following line to
the Vagrant.configure:

`config.vm.network "private_network", ip: "192.168.50.4", virtualbox__intnet: true`

Expand All @@ -28,10 +33,13 @@ But the easiest way is to force the port-forwarding as shown before:

## Notes

**Warning**: For low-end machines (less then 8T32GB), you will need to modify the Vagrant file. This is not recommended!
**Warning**: For low-end machines (less then 8T32GB), you will need to modify
the Vagrant file. This is not recommended!

- In the Vagrant file "./Vagrantfile", there are *CPUS & RAM* parameters in `config.vm.provider`, it's possible to override them at runtime:
- In the Vagrant file "./Vagrantfile", there are *CPUS & RAM* parameters in
`config.vm.provider`, it's possible to override them at runtime:
- On Linux, or the Git Bash on Windows we can use a one-liner command `CPUS=16
MEMORY=32768 vagrant up`

-On Linux, or the Git Bash on Windows we can use a one-liner command `CPUS=16 MEMORY=32768 vagrant up`

- In the Ansible "./playbooks/roles/bootstrap/tasks/prechecks.yml" file, there are the checks for *CPUS & RAM*
- In the Ansible "./playbooks/roles/bootstrap/tasks/prechecks.yml" file, there
are the checks for *CPUS & RAM*
38 changes: 29 additions & 9 deletions install-guide/explore-sandbox.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
Exploring the Nephio Sandbox
============================

You have installed the Nephio sandbox on your VM
[using the installation instructions](https://github.com/nephio-project/test-infra/blob/main/e2e/provision/README.md). The installation has done a good job of installing a complex software stack without any fuss. Let's take a look around.
You have installed the Nephio sandbox on your VM [using the installation
instructions](https://github.com/nephio-project/test-infra/blob/main/e2e/provision/README.md).
The installation has done a good job of installing a complex software stack
without any fuss. Let's take a look around.

![Software Installed by the Nephio Sandbox Installation](ExploreSandbox-diagrams/ManagementCluster.png)

Expand All @@ -19,15 +21,28 @@ The following components are installed on the VM itself. These components are in
| cni | Used to implement the k8s network model for the KinD clusters |
| gtp5g | A Linux module that supports the 3GPP GPRS tunneling protocol (required by free5gc NFs) |

The Ansible install scripts use kind to create the Management cluster. Once the Management KinD cluster is created, the install uses kpt packages to install the remainder of the software.
The Ansible install scripts use kind to create the Management cluster. Once the
Management KinD cluster is created, the install uses kpt packages to install the
remainder of the software.

# Components Installed on the Management KinD cluster

Everything is installed on the Management KinD cluster by Ansible scripts using kpt packages.
Everything is installed on the Management KinD cluster by Ansible scripts using
kpt packages.

The install unpacks each kpt package in the */tmp* directory. It then applies the kpt functions to the packages and applies the packages to the Management KinD cluster. This allows the user to check the status of the kpt packages in the cluster using the *kpt live status* command on the unpacked packages in the */tmp* directory.
The install unpacks each kpt package in the */tmp* directory. It then applies
the kpt functions to the packages and applies the packages to the Management
KinD cluster. This allows the user to check the status of the kpt packages in
the cluster using the *kpt live status* command on the unpacked packages in the
*/tmp* directory.

The rendered kpt packages containing components are unpacked in the */tmp/kpt-pkg* directory. The rendered kpt packages that create the *mgmt* and *mgmt-staging* repositories are unpacked in the */tmp/repository* directory. The rendered kpt package containing the rootsync configuration for the *mgmt* repository is unpacked in the */tmp/rootsync* directory. You can examine the contents of any rendered kpt packager by examining the contents of these directories.
The rendered kpt packages containing components are unpacked in the
*/tmp/kpt-pkg* directory. The rendered kpt packages that create the *mgmt* and
*mgmt-staging* repositories are unpacked in the */tmp/repository* directory. The
rendered kpt package containing the rootsync configuration for the *mgmt*
repository is unpacked in the */tmp/rootsync* directory. You can examine the
contents of any rendered kpt packager by examining the contents of these
directories.

```
/tmp/kpt-pkg/ /tmp/repository /tmp/rootsync/
Expand Down Expand Up @@ -90,7 +105,10 @@ inventory-38069595/namespace//nephio-system is Current: Resource is current

## Base Components

The following base components are installed on the Management cluster. Base components are the infrastructure components that are needed for the Nephio sandbox, which Nephio uses out of the box. In real world installations, alternative components that provide the same functionality may be used.
The following base components are installed on the Management cluster. Base
components are the infrastructure components that are needed for the Nephio
sandbox, which Nephio uses out of the box. In real world installations,
alternative components that provide the same functionality may be used.

| Component | Purpose |
| ------------ | -------------------------------------------------------------------|
Expand All @@ -104,8 +122,10 @@ The following base components are installed on the Management cluster. Base comp

## Specific Components

The following specific components are installed on the Management cluster. The specific components are Nephio components and components from
[Google Container Tools](https://github.com/GoogleContainerTools) that Nephio uses heavily and interacts closely with.
The following specific components are installed on the Management cluster. The
specific components are Nephio components and components from [Google Container
Tools](https://github.com/GoogleContainerTools) that Nephio uses heavily and
interacts closely with.

| Component | Purpose |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------|
Expand Down

0 comments on commit 47eea05

Please sign in to comment.