Skip to content

Commit

Permalink
Converted references to md format
Browse files Browse the repository at this point in the history
  • Loading branch information
liamfallon committed Feb 1, 2024
1 parent dc1ed0c commit ef683af
Show file tree
Hide file tree
Showing 11 changed files with 32 additions and 30 deletions.
2 changes: 1 addition & 1 deletion content/en/docs/guides/contributor-guides/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,5 @@ This developer guide is for for people who want to write code for the Nephio pro
extension of the [Kubernetes Developer Guides](https://github.com/kubernetes/community/tree/master/contributors/devel#the-process-of-developing-and-contributing-code-to-the-kubernetes-project)
and therefore covers topics that are specific to Nephio development.

* How to set up a [Minimal Development Environment](minimal-environment.md) defines common terminology
* How to set up a [Minimal Development Environment](content/en/docs/guides/contributor-guides/minimal-environment.md) defines common terminology
used in the Nephio project.
8 changes: 4 additions & 4 deletions content/en/docs/guides/install-guides/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,7 @@ ssh <user>@<vm-address>

## Next Steps

* Step through the [Free5GC](../user-guides/exercise-1-free5gc.md) and [OAI](../user-guides/exercise-2-oai.md) exercises
* Learn more about the [Nephio demo sandbox](explore-sandbox.md)
* Dig into the [user guide](../user-guides#nephio-r1-user-guide)
* Create a [Bring-Your-Own-Cluster](install-on-byoc.md) Nephio Installation
* Step through the [Free5GC](content/en/docs/guides/user-guides/exercise-1-free5gc.md) and [OAI](content/en/docs/guides/user-guides/exercise-2-oai.md) exercises
* Learn more about the [Nephio demo sandbox](content/en/docs/guides/install-guides/explore-sandbox.md)
* Dig into the [user guide](content/en/docs/guides/user-guides#nephio-r1-user-guide)
* Create a [Bring-Your-Own-Cluster](content/en/docs/guides/install-guides/install-on-byoc.md) Nephio Installation
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ description: >
weight: 6
---

Concepts as [Operator](../../glossary.md#operator) and
[Controller](../../glossary.md#controller) and
[CR](../../glossary.md#custom-resource) have already been explained here.
Concepts as [Operator](content/en/docs/glossary.md#operator) and
[Controller](content/en/docs/glossary.md#controller) and
[CR](content/en/docs/glossary.md#custom-resource) have already been explained here.

# Deploy the operator to the cluster

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/guides/install-guides/explore-sandbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ weight: 5
---


You have installed the Nephio single VM [using the installation instructions](install-on-single-vm.md).
You have installed the Nephio single VM [using the installation instructions](content/en/docs/guides/install-guides/install-on-single-vm.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](/images/install-guides/ManagementCluster.png)
Expand Down
10 changes: 5 additions & 5 deletions content/en/docs/guides/install-guides/install-on-byoc.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,9 +67,9 @@ options, if you wish to assemble your own set of components.

| Environment | Description |
| ----------- | ---------------------------------------------------------- |
| [Single VM](install-on-single-vm.md) | The single VM demo environment, set up "the hard way" - without using the included provisioning script. This creates a complete Nephio-in-a-VM, just like the R1 demo environment. These instructions cover both Ubuntu and Fedora. |
| [Google Cloud Platform](install-on-gcp.md) | Nephio running in GCP. A GKE cluster is used as the management cluster, with Anthos Config Controller for GCP infrastructure provisioning, Gitea as the Git provider, and Web UI authentication and authorization via Google OAuth 2.0 |
| [OpenShift](install-on-openshift.md) | Nephio running in OpenShift, with Cluster API as the cluster provisioner, Gitea as the Git provider and Web UI authentication backed by Open Shift OIDC. |
| [Single VM](content/en/docs/guides/install-guides/install-on-single-vm.md) | The single VM demo environment, set up "the hard way" - without using the included provisioning script. This creates a complete Nephio-in-a-VM, just like the R1 demo environment. These instructions cover both Ubuntu and Fedora. |
| [Google Cloud Platform](content/en/docs/guides/install-guides/install-on-gcp.md) | Nephio running in GCP. A GKE cluster is used as the management cluster, with Anthos Config Controller for GCP infrastructure provisioning, Gitea as the Git provider, and Web UI authentication and authorization via Google OAuth 2.0 |
| [OpenShift](content/en/docs/guides/install-guides/install-on-openshift.md) | Nephio running in OpenShift, with Cluster API as the cluster provisioner, Gitea as the Git provider and Web UI authentication backed by Open Shift OIDC. |

## A La Carte Installation

Expand Down Expand Up @@ -146,8 +146,8 @@ development it must not be exposed on the internet (for example, via a
LoadBalancer service, Ingress, or Route).

The WebUI currently supports the following options:
- [Google OAuth or OIDC](webui-auth-gcp.md)
- [OIDC with Okta](webui-auth-okta.md)
- [Google OAuth or OIDC](content/en/docs/guides/install-guides/webui-auth-gcp.md)
- [OIDC with Okta](content/en/docs/guides/install-guides/webui-auth-okta.md)

### Nephio Stock Repositories

Expand Down
8 changes: 4 additions & 4 deletions content/en/docs/guides/install-guides/install-on-gce.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,7 +174,7 @@ ssh <user>@<vm-address>
## Next Steps

* Step through the exercises
* [Free5GC Testbed Deployment and E2E testing with UERANSIM](../user-guides/exercise-1-free5gc.md)
* [OAI Core and RAN Testbed Deployment and E2E testing](../user-guides/exercise-2-oai.md)
* Learn more about the [Nephio demo sandbox](explore-sandbox.md)
* Dig into the [user guide](../user-guides/_index.md)
* [Free5GC Testbed Deployment and E2E testing with UERANSIM](content/en/docs/guides/content/en/docs/guides/install-guides/user-guides/exercise-1-free5gc.md)
* [OAI Core and RAN Testbed Deployment and E2E testing](content/en/docs/guides/user-guides/exercise-2-oai.md)
* Learn more about the [Nephio demo sandbox](content/en/docs/guides/install-guides/explore-sandbox.md)
* Dig into the [user guide](content/en/docs/guides/user-guides/_index.md)
11 changes: 6 additions & 5 deletions content/en/docs/guides/install-guides/install-on-gcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -1022,9 +1022,9 @@ git commit -m "Initial checking of nephio-mgmt"
**Prior to deploying the package, we need to manually setup the secret for the
WebUI.**

See [Google OAuth 2.0 or OIDC](webui-auth-gcp.md) for details on how to
set up OAuth. In particular you need to [create the client ID](webui-auth-gcp.md#creating-an-oauth-20-client-id)
and the [secret](webui-auth-gcp.md#create-the-secret-in-the-cluster)
See [Google OAuth 2.0 or OIDC](content/en/docs/guides/install-guides/webui-auth-gcp.md) for details on how to
set up OAuth. In particular you need to [create the client ID](content/en/docs/guides/install-guides/webui-auth-gcp.md#creating-an-oauth-20-client-id)
and the [secret](content/en/docs/guides/install-guides/webui-auth-gcp.md#create-the-secret-in-the-cluster)
manually.

The `nephio-webui` subpackage in `nephio-mgmt` is already set up for
Expand Down Expand Up @@ -1384,5 +1384,6 @@ Note that the exercises using free5gc rely on Multus and on the gtp5g kernel mod
GKE nodes. Therefore, the free5gc workloads cannot be run on this installation. You will need to alter the exercises to\
use workloads that do not rely on that functionality in order to experiment with Nephio features.
* Step through the [Free5GC](../user-guides/exercise-1-free5gc.md) and [OAI](../user-guides/exercise-2-oai.md) exercises
* Dig into the [user guide](../user-guides/_index.md)
* Step through the [Free5GC](content/en/docs/guides/user-guides/exercise-1-free5gc.md) and
[OAI](content/en/docs/guides/user-guides/exercise-2-oai.md) exercises
* Dig into the [user guide](content/en/docs/guides/user-guides/_index.md)
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,8 @@ Application:
oc apply -f https://raw.githubusercontent.com/openshift-telco/blueprints-nephio-openshift/v1.0.1/nephio-mgnt/app-of-apps.yaml
```

This will take care of applying the [common dependencies](common-dependencies.md) and the [common components](common-components.md)
This will take care of applying the [common dependencies](content/en/docs/guides/install-guides/common-dependencies.md)
and the [common components](content/en/docs/guides/install-guides/common-components.md)

### Access the Nephio

Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/guides/install-guides/install-on-single-vm.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,12 +65,12 @@ kpt live apply gitea --reconcile-timeout 15m --output=table

There are a few dependencies that are common across most installations, and do not require any installation-specific
setup. You should install these next, as described in the
[common dependencies documentation](common-dependencies.md).
[common dependencies documentation](content/en/docs/guides/install-guides/common-dependencies.md).

## Common Components

With the necessary dependencies now installed, you can now install the essential Nephio components. This is documented
in the [common components documentation](common-components.md).
in the [common components documentation](content/en/docs/guides/install-guides/common-components.md).

## Provisioning Cluster API

Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/guides/install-guides/webui.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,8 +54,8 @@ service).
Configuring authentication for the WebUI is very specific to the particular cluster environment. Guides for different
environments are below:

- [Google OAuth or OIDC](webui-auth-gcp.md)
- [OIDC with Okta](webui-auth-okta.md)
- [Google OAuth or OIDC](content/en/docs/guides/install-guides/webui-auth-gcp.md)
- [OIDC with Okta](content/en/docs/guides/install-guides/webui-auth-okta.md)

Once that configuration is updated, you can proceed with the installation (note, this uses `inventory-policy=adopt`,
since in the previous steps we may have created the namespace already).
Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/guides/user-guides/helm/flux-helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ Then, we can utilize the flux Custom Resources defined in another test kpt packa

* [Nephio R1 sandbox](content/en/docs/guides/install-guides/install-guides/_index.md): Set up the Nephio sandbox environment.
* [Access to the Nephio Web UI](content/en/docs/guides/install-guides/_index.md#access-to-the-user-interfaces)
* [Nephio R1 sandbox workload clusters](content/en/docs/guidesuser-guides/exercise-1-free5gc.md):
* [Nephio R1 sandbox workload clusters](content/en/docs/guides/user-guides/exercise-1-free5gc.md):
Create/Deploy the predefined set of workload clusters by completing the Free5GC Core quick start exercises up to and including
[Step 3](../exercise-1-free5gc.md#step-3-deploy-two-edge-clusters).
[Step 3](content/en/docs/guides/user-guides/exercise-1-free5gc.md#step-3-deploy-two-edge-clusters).

### Deploying the flux-helm-controllers pkg

Expand Down

0 comments on commit ef683af

Please sign in to comment.