Added brief body text as a demo overview and moved the demo section into the installing via UI section as the demo primarily uses the Rancher UI to accomplish tasks.

Signed-off-by: Sunil Singh <sunil.singh@suse.com>
This commit is contained in:
Sunil Singh
2024-04-08 10:25:37 -07:00
parent 2056cce401
commit f6ecdab010
3 changed files with 18 additions and 36 deletions
@@ -31,14 +31,6 @@ If you already have the Cluster API (CAPI) Operator installed in your cluster, y
::: :::
:::info prerequisite
Before installing Rancher Turtles in your Rancher environment, you must disable Rancher's `embedded-cluster-api` functionality. This also includes cleaning up Rancher-specific webhooks that otherwise would conflict with CAPI ones.
To simplify setting up Rancher for installing Rancher Turtles, the official Rancher Turtles Helm chart includes a `pre-install` hook that removes the following:
- Disables the `embedded-cluster-api` feature in Rancher.
- Deletes the `mutating-webhook-configuration` and `validating-webhook-configuration` webhooks, as they are no longer needed.
:::
### Installing via the Rancher UI ### Installing via the Rancher UI
By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension. By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension.
@@ -63,6 +55,12 @@ The installation may take a few minutes and after completing you can see the fol
- `rancher-turtles-system/rancher-turtles-cluster-api-operator` - `rancher-turtles-system/rancher-turtles-cluster-api-operator`
- `capi-system/capi-controller-manager` - `capi-system/capi-controller-manager`
#### Demo
This demo illustrates how to use the Rancher UI to install Rancher Turtles, create/import a CAPI cluster, and install monitoring on the cluster:
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
### Installing via Helm ### Installing via Helm
There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency: There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency:
@@ -215,10 +213,6 @@ spec:
kubectl apply -f feature.yaml kubectl apply -f feature.yaml
``` ```
## Demo
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
## Security ## Security
[SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package. [SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package.
@@ -31,14 +31,6 @@ If you already have the Cluster API (CAPI) Operator installed in your cluster, y
::: :::
:::info prerequisite
Before installing Rancher Turtles in your Rancher environment, you must disable Rancher's `embedded-cluster-api` functionality. This also includes cleaning up Rancher-specific webhooks that otherwise would conflict with CAPI ones.
To simplify setting up Rancher for installing Rancher Turtles, the official Rancher Turtles Helm chart includes a `pre-install` hook that removes the following:
- Disables the `embedded-cluster-api` feature in Rancher.
- Deletes the `mutating-webhook-configuration` and `validating-webhook-configuration` webhooks, as they are no longer needed.
:::
### Installing via the Rancher UI ### Installing via the Rancher UI
By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension. By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension.
@@ -63,6 +55,12 @@ The installation may take a few minutes and after completing you can see the fol
- `rancher-turtles-system/rancher-turtles-cluster-api-operator` - `rancher-turtles-system/rancher-turtles-cluster-api-operator`
- `capi-system/capi-controller-manager` - `capi-system/capi-controller-manager`
#### Demo
This demo illustrates how to use the Rancher UI to install Rancher Turtles, create/import a CAPI cluster, and install monitoring on the cluster:
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
### Installing via Helm ### Installing via Helm
There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency: There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency:
@@ -215,10 +213,6 @@ spec:
kubectl apply -f feature.yaml kubectl apply -f feature.yaml
``` ```
## Demo
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
## Security ## Security
[SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package. [SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package.
@@ -31,14 +31,6 @@ If you already have the Cluster API (CAPI) Operator installed in your cluster, y
::: :::
:::info prerequisite
Before installing Rancher Turtles in your Rancher environment, you must disable Rancher's `embedded-cluster-api` functionality. This also includes cleaning up Rancher-specific webhooks that otherwise would conflict with CAPI ones.
To simplify setting up Rancher for installing Rancher Turtles, the official Rancher Turtles Helm chart includes a `pre-install` hook that removes the following:
- Disables the `embedded-cluster-api` feature in Rancher.
- Deletes the `mutating-webhook-configuration` and `validating-webhook-configuration` webhooks, as they are no longer needed.
:::
### Installing via the Rancher UI ### Installing via the Rancher UI
By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension. By adding the Turtles repository via the Rancher UI, Rancher can process the installation and configuration of the CAPI Extension.
@@ -63,6 +55,12 @@ The installation may take a few minutes and after completing you can see the fol
- `rancher-turtles-system/rancher-turtles-cluster-api-operator` - `rancher-turtles-system/rancher-turtles-cluster-api-operator`
- `capi-system/capi-controller-manager` - `capi-system/capi-controller-manager`
#### Demo
This demo illustrates how to use the Rancher UI to install Rancher Turtles, create/import a CAPI cluster, and install monitoring on the cluster:
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
### Installing via Helm ### Installing via Helm
There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency: There are two ways to install Rancher Turtles with Helm, depending on whether you include the CAPI operator as a dependency:
@@ -215,10 +213,6 @@ spec:
kubectl apply -f feature.yaml kubectl apply -f feature.yaml
``` ```
## Demo
<iframe width="560" height="315" src="https://www.youtube.com/embed/lGsr7KfBjgU?si=ORkzuAJjcdXUXMxh" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
## Security ## Security
[SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package. [SLSA](https://slsa.dev/spec/v1.0/about) is a set of incrementally adoptable guidelines for supply chain security, established by industry consensus. The specification set by SLSA is useful for both software producers and consumers: producers can follow SLSA’s guidelines to make their software supply chain more secure, and consumers can use SLSA to make decisions about whether to trust a software package.