Adding install guide

config.toml

@@ -85,6 +85,17 @@ archived_version = false
 
 version = "latest"
 
+# The version of the latest code build
+latestTag = "1.5.4"
+
+# latest tested versions
+version_docker = "v28.1.1"
+version_go = "v1.25.3"
+version_git = "v2.51.2"
+version_kind = "v0.30.0"
+version_kube = "v1.34.2"
+version_kpt = "v1.0.0-beta.59"
+
 # A link to latest version of the docs. Used in the "version-banner" partial to
 # point people to the main doc site.
 

content/en/docs/neo-porch/3_getting_started/_index.md

@@ -2,9 +2,19 @@
 title: "Getting Started"
 type: docs
 weight: 3
-description: Getting Started with Porch
+description: "A set of guides for installing Porch prerequisites, the porchctl CLI, and deploying Porch components on a Kubernetes cluster." 
 ---
 
-## Lorem Ipsum
+## Prerequisites
 
-Lorem Ipsum
+1. A supported OS (Linux/MacOS)
+2. [git](https://git-scm.com/) ({{< params "version_git" >}})
+3. [Docker](https://www.docker.com/get-started/) - either Docker Desktop or Docker Engine ({{< params "version_docker" >}})
+4. [kubectl](https://kubernetes.io/docs/reference/kubectl/) - make sure that [kubectl context](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/) configured with your cluster ({{< params "version_kube" >}})
+5. [kpt](https://kpt.dev/installation/kpt-cli/) ({{< params "version_kpt" >}})
+6. [The go programming language](https://go.dev/) ({{< params "version_go" >}})
+7. A Kubernetes Cluster
+
+{{% alert color="primary" title="Note:" %}}
+The versions above relate to the latest tested versions confirmed to work and are **NOT** the only compatible versions.
+{{% /alert %}}

content/en/docs/neo-porch/3_getting_started/installing-porch.md

@@ -1,14 +1,62 @@
 ---
 title: "Installing Porch"
 type: docs
-weight: 1
-description: Installing Porch
+weight: 2
+description: Install guide for the porch system on a Kubernetes cluster.
 ---
 
-## Prerequisites
+## Deploying Porch on a cluster
 
-list of prerequisites for script to run and porch to be deployed. e.g. kubectl, kind cluster etc
+Create a new directory for the kpt package and path inside of it
 
-## install script
+```bash
+mkdir porch-{{% params "latestTag" %}} && cd porch-{{% params "latestTag" %}}
+```
 
-we should have a simple installing porch script which deploys porch similar to the (./scripts/setup-dev-env.sh + make run-in-kind + setting up an example-repository) with a small description for exactly what this script does for those who want more information but does not impede those who simply want to deploy porch
+Download the latest Porch kpt package blueprint
+
+```bash
+curl -LO "https://github.com/nephio-project/porch/releases/download/v{{% params "latestTag" %}}/porch_blueprint.tar.gz"
+```
+
+Extract the Porch kpt package contents
+
+```bash
+tar -xzf porch_blueprint.tar.gz
+```
+
+Initialize and apply the Porch kpt package
+
+```bash
+kpt live init && kpt live apply
+```
+
+You can check that porch is up and running by doing
+
+```bash
+kubectl get all -n porch-system
+```
+
+A healthy porch install should look as such
+
+```bash
+NAME                                   READY   STATUS    RESTARTS   AGE
+pod/function-runner-567ddc76d-7k8sj    1/1     Running   0          4m3s
+pod/function-runner-567ddc76d-x75lv    1/1     Running   0          4m3s
+pod/porch-controllers-d8dfccb4-8lc6j   1/1     Running   0          4m3s
+pod/porch-server-7dc5d7cd4f-smhf5      1/1     Running   0          4m3s
+
+NAME                      TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)            AGE
+service/api               ClusterIP   10.96.108.221   <none>        443/TCP,8443/TCP   4m3s
+service/function-runner   ClusterIP   10.96.237.108   <none>        9445/TCP           4m3s
+
+NAME                                READY   UP-TO-DATE   AVAILABLE   AGE
+deployment.apps/function-runner     2/2     2            2           4m3s
+deployment.apps/porch-controllers   1/1     1            1           4m3s
+deployment.apps/porch-server        1/1     1            1           4m3s
+
+NAME                                         DESIRED   CURRENT   READY   AGE
+replicaset.apps/function-runner-567ddc76d    2         2         2       4m3s
+replicaset.apps/porch-controllers-d8dfccb4   1         1         1       4m3s
+replicaset.apps/porch-server-7dc5d7cd4f      1         1         1       4m3s
+```

content/en/docs/neo-porch/3_getting_started/installing-porchctl.md

@@ -0,0 +1,116 @@
+---
+title: "Installing Porchctl CLI"
+type: docs
+weight: 1
+description: Install guide for the Porchctl CLI.
+---
+
+## Installing the porchctl CLI
+
+The porchctl CLI can be obtained through the following means:
+
+### Download the latest porchctl binary
+
+<!-- markdownlint-disable MD034 -->
+{{< tabpane lang="bash" >}}
+{{< tab header="Linux AMD64" >}}
+curl -LO 'https://github.com/nephio-project/porch/releases/download/v{{<params"latestTag">}}/porchctl_{{<params"latestTag">}}_linux_amd64.tar.gz'
+{{< /tab >}}
+{{< tab header="Linux ARM64" >}}
+curl -LO 'https://github.com/nephio-project/porch/releases/download/v{{<params"latestTag">}}/porchctl_{{<params"latestTag">}}_linux_arm64.tar.gz'
+{{< /tab >}}
+{{< tab header="macOS AMD64" >}}
+curl -LO https://github.com/nephio-project/porch/releases/download/v{{<params"latestTag">}}/porchctl_{{<params"latestTag">}}_darwin_amd64.tar.gz
+{{< /tab >}}
+{{< tab header="macOS ARM64" >}}
+curl -LO 'https://github.com/nephio-project/porch/releases/download/v{{<params"latestTag">}}/porchctl_{{<params"latestTag">}}_darwin_arm64.tar.gz'
+{{< /tab >}}
+{{< /tabpane >}}
+<!-- markdownlint-enable MD034 -->
+
+{{% alert color="primary" title="Note:" %}}
+To download a specific version of porch and its porchctl binary you can do so by replacing the version number and machine type its for in the curl link above.
+
+For example, to download the **[1.5.0](https://github.com/nephio-project/porch/releases/tag/v1.5.0)** release version of porch on **macOS AMD64** the URL would be:
+
+```bash
+curl -LO "https://github.com/nephio-project/porch/releases/download/v1.5.0/porchctl_1.5.0_darwin_amd64.tar.gz"
+```
+
+{{% /alert %}}
+
+### Install the porchctl binary
+
+This extracts the tar file containting the binary executable and installs it into the root binary directory of the machine.
+
+{{% alert color="primary" title="Note:" %}}
+That this requires **root** permissions on the host machine.
+{{% /alert %}}
+
+```bash
+tar -xzf porchctl_{{% params "latestTag" %}}_linux_amd64.tar.gz | sudo install -o root -g root -m 0755 porchctl /usr/local/bin/
+```
+
+{{% alert color="primary" title="Note:" %}}
+If you do not have root access on the target system, you can still install porchctl to the `~/.local/bin` directory:
+{{% /alert %}}
+
+```bash
+tar -xzf porchctl_{{% params "latestTag" %}}_linux_amd64.tar.gz
+chmod +x ./porchctl
+mkdir -p ~/.local/bin
+mv ./porchctl ~/.local/bin/porchctl
+# and then append (or prepend) ~/.local/bin to $PATH
+```
+
+You can test that the CLI has been installed correctly by doing `porchctl version` in your terminal and you should be prompted with a printout that looks similar to this.
+
+```bash
+Version: {{% params "latestTag" %}}
+Git commit: cddc13bdcd569141142e2b632f09eb7a3e4988c9 (dirty)
+```
+
+### Enable porchctl autocompletion (optional)
+
+Create the completions directory (if it doesn’t already exist):
+
+```bash
+mkdir -p ~/.local/share/bash-completion/completions
+```
+
+{{% alert color="primary" title="Note:" %}}
+This is the auto-completion directory for Ubuntu 24.04 LTS and a few other distributions.
+Please do your due diligence and use/create the directory for your appropriate OS/distribution.
+{{% /alert %}}
+
+Generate and install the completion script:
+
+```bash
+porchctl completion bash > ~/.local/share/bash-completion/completions/porchctl
+```
+
+Reload your shell:
+
+```bash
+exec bash
+```
+
+{{% alert color="primary" title="Note:" %}}
+You can just reload/refresh your terminal manually without the command by just closing the terminal and starting a new one. Either works as intended.
+{{% /alert %}}
+
+Test that the auto-completion works with the following command and pressing the auto-complete key usually `<TAB>` twice.
+
+```bash
+porchctl
+```
+
+If auto-completion is working as correctly this should return a similar output to the one below
+
+```bash
+completion  (Generate the autocompletion script for the specified shell)
+help        (Help about any command)
+repo        (Manage package repositories.)
+rpkg        (Manage packages.)
+version     (Print the version number of porchctl)
+```

layouts/shortcodes/params.html

@@ -0,0 +1 @@
+{{ index .Site.Params (.Get 0) }}