Skip to content

Commit

Permalink
docs: update the supported matrix between harbor and dragonfly
Browse files Browse the repository at this point in the history
Signed-off-by: suhan.zcy <[email protected]>
  • Loading branch information
suhan.zcy committed Oct 15, 2024
1 parent 9d4c286 commit b34b350
Showing 1 changed file with 22 additions and 9 deletions.
31 changes: 22 additions & 9 deletions docs/administration/p2p-preheat/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,39 @@ weight: 30
P2P preheating integrates key P2P distribution capabilities of CNCF projects like [Dragonfly](https://github.com/dragonflyoss/Dragonfly) (v1.0.5+)
and Uber [Kraken](https://github.com/uber/kraken) (v0.1.3+) into Harbor and allow users to define policies around this action.

Before preheating images from Harbor, you must first install a P2P engine in your environment. Refer to your P2P
Before preheating images from Harbor, you must first install a P2P engine in your environment. Refer to your P2P
distribution engine's installation guide for specific configuration steps.

{{< note >}}
Due to the limitations of the Kraken preheat API, there are extra configurations steps needed. Follow the
Kraken [configuration guide](https://github.com/uber/kraken/blob/master/docs/INTEGRATEWITHHARBOR.md) for more
Due to the limitations of the Kraken preheat API, there are extra configurations steps needed. Follow the
Kraken [configuration guide](https://github.com/uber/kraken/blob/master/docs/INTEGRATEWITHHARBOR.md) for more
information on integrating Kraken and Harbor.
{{< /note >}}

The system admin can create P2P preheat provider instances by providing preheat API endpoint of the selected vendor
(Dragonfly or Kraken) and related credential if necessary. The created preheat provider instances can be used across
The system admin can create P2P preheat provider instances by providing preheat API endpoint of the selected vendor
(Dragonfly or Kraken) and related credential if necessary. The created preheat provider instances can be used across
all the projects.

The project admin can create multiple preheat policies under the specified project by setting the resource filters and
preheat criteria (including: content trust and vulnerability situation) and choosing the P2P preheat provider instance
The project admin can create multiple preheat policies under the specified project by setting the resource filters and
preheat criteria (including: content trust and vulnerability situation) and choosing the P2P preheat provider instance
added by the system administrator. The preheating policy can be triggered to start by manual, on a scheduled basis, or event-based ways.
When the preheating policy is executing, all the images that match the criteria defined in the policy will be distributed to
When the preheating policy is executing, all the images that match the criteria defined in the policy will be distributed to
and cached in the target P2P engine for future pulling requests.

Harbor records each time a preheating policy is executed. You can check the details of preheating executions and the
Harbor records each time a preheating policy is executed. You can check the details of preheating executions and the
related logs from the Project's page.


{{< note >}}
Please note that due to some historical reasons, there are two versions of Dragonfly,
[v1](https://github.com/dragonflyoss/Dragonfly) and [v2](https://github.com/dragonflyoss/Dragonfly2),
and v1 has been archived and is no longer maintained, and v2 has a complete refactoring of v1, so v2 is not compatible with v1,
the following is the version-compatible relationship between Harbor and Dragonfly, and it is recommended that you upgrade to the latest version of Dragonfly.
{{< /note >}}

{{< table caption="Harbor and Dragonfly version-compatible supported matrix" >}}
Harbor Version | Dragonfly Version |
:---------|:------------|
`>=v2.12.0` |`>=v2.1.59` |
`<v2.12.0` |`>=v1.0.5, <v2.1.59` |
{{< /table >}}

0 comments on commit b34b350

Please sign in to comment.