Skip to content

Commit

Permalink
Apply suggestions from code review
Browse files Browse the repository at this point in the history
include feedback from Jillian

Co-authored-by: Jillian <67180770+jillian-maroket@users.noreply.github.com>
  • Loading branch information
ibrokethecloud and jillian-maroket authored Jun 13, 2024
1 parent b1699be commit cd79b52
Showing 1 changed file with 34 additions and 22 deletions.
56 changes: 34 additions & 22 deletions docs/rancher/rancher-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,36 +116,48 @@ With this feature enabled, your Harvester cluster does not appear on the **Conti

:::

## Rancher fleet support (experimental)
## Fleet Support (Experimental)

_Available as of Harvester v1.3.0 + Rancher v2.7.9_

:::note
Needs Rancher Feature `harvester-baremetal-container-workload` to be enabled
Starting with Rancher v2.7.9, you can leverage [Fleet](https://fleet.rancher.io/) for managing container workloads and configuring Harvester with a GitOps-based approach.

:::info
The Rancher feature `harvester-baremetal-container-workload` must be enabled.
:::
1. On the Rancher UI, go to **** > **Continuous Delivery**.

![](/img/v1.3/rancher/continuous-delivery-overview.png)

1. (Optional) On the **Clusters** tab, edit the Fleet cluster config to add labels that can be used to group Harvester clusters.

In this example, the label `location=private-dc` was added.

![](/img/v1.3/rancher/fleet-cluster-config.png)

![](/img/v1.3/rancher/fleet-additional-labels.png)

1. (Optional) On the **Cluster Groups** tab, create a cluster group.

In this example, the cluster group `private-dc-clusters` is created with a cluster selector rule that matches the label key/value pair of `location=private-dc`.

![](/img/v1.3/rancher/create-cluster-group.png)

1. On the **Git Repos** tab, create a Git repo named `harvester-config` that points to the [harvester-fleet-examples repo](https://github.com/harvester/harvester-fleet-examples), with the branch defined as `main`. You must define the following paths:

Starting with Rancher v2.7.9, users can leverage [Rancher Fleet](https://fleet.rancher.io/) for managing container workloads and / or configuring Harvester via a gitops based approach.
- `keypair`
- `vmimage`
- `vmnetwork`
- `cloudint`

To get started, follow these steps:
1. Click Continuous Delivery from left navigation panel in Rancher.
![](/img/v1.3/rancher/continuous-delivery-overview.png)
![](/img/v1.3/rancher/gitrepo-definition.png)

2. Optional: Edit fleet cluster config to add additional labels, which can be used to group Harvester clusters into a Cluster Group. In our example we have added an additional label `location=private-dc`
![](/img/v1.3/rancher/fleet-cluster-config.png)
![](/img/v1.3/rancher/fleet-additional-labels.png)
1. Click **Next**, and then define the Git repo targets. You can select all clusters, an individual cluster, or a group of clusters.

3. Optional: Create a Cluster Group, `private-dc-clusters` with `Cluster Selectors` defined to match the label key/value pair of `location=private-dc`
![](/img/v1.3/rancher/create-cluster-group.png)
In this example, the cluster group named `private-dc-clusters` is used.

4. Create a `GitRepo` name `harvester-config`, pointing to the [harvester-fleet-examples repo](https://github.com/harvester/harvester-fleet-examples), with branch defined as `main`. Define the following paths:
* keypair
* vmimage
* vmnetwork
* cloudint
![](/img/v1.3/rancher/gitrepo-definition.png)
![](/img/v1.3/rancher/gitrepo-targets.png)

On the next page define the `GitRepo` targets. This can be all clusters, an individual cluster or a group of clusters. For this example we will be using the optional `ClusterGroup` named `private-dc-clusters`
![](/img/v1.3/rancher/gitrepo-targets.png)
1. Click **Save**. It may take a few seconds for the resources to be rolled out to the target clusters.

5. Once `GitRepo` is saved, it can take a few seconds for the resources to be rolled out to the target clusters
![](/img/v1.3/rancher/gitrepo-synced.png)
![](/img/v1.3/rancher/gitrepo-synced.png)

0 comments on commit cd79b52

Please sign in to comment.