Merge pull request #472 from viccuad/main

Add reference/artifacts page
kubewarden · Dec 6, 2024 · a1fda6e · a1fda6e
2 parents 6bb7e43 + 23264d7
commit a1fda6e
Show file tree

Hide file tree

Showing 2 changed files with 40 additions and 1 deletion.
diff --git a/docs/howtos/airgap/02-install.md b/docs/howtos/airgap/02-install.md
@@ -17,7 +17,8 @@ For an air-gapped installation of Kubewarden,
 you need a private Open Container Initiative (OCI) registry accessible by your Kubernetes cluster.
 Kubewarden Policies are WebAssembly modules,
 therefore you can store them in an OCI-compliant registry as OCI artifacts.
-You need to add Kubewarden's images and policies to this OCI registry.
+You need to add Kubewarden's images and policies to this OCI registry. You can
+see a rough list of Kubewarden artifacts in the [Artifacts reference](../../reference/artifacts.md) page.
 The following sections describe the process.
 
 ## Save container images in your workstation

diff --git a/docs/reference/artifacts.md b/docs/reference/artifacts.md
@@ -0,0 +1,38 @@
+---
+sidebar_label: Artifacts
+sidebar_position: 20
+title: Artifacts
+description: List of Kubewarden artifacts
+keywords: [artifacts, support, airgap, images]
+doc-persona: [kubewarden-operator]
+doc-type: [reference]
+doc-topic: [operator-manual, artifacts, registry, images]
+---
+
+<head>
+  <link rel="canonical" href="https://docs.kubewarden.io/reference/artifacts"/>
+</head>
+
+## Kubewarden artifacts
+
+### Binaries
+
+Our `kwctl` CLI tool is published via [GitHub releases](https://github.com/kubewarden/kwctl/releases).
+
+### OCI artifacts
+
+For OCI artifacts, we publish everything in ghcr.io under
+https://github.com/orgs/kubewarden/packages. This includes:
+
+- [`kubewarden/packages/policies/*`](https://github.com/orgs/kubewarden/packages/policies)
+  are policy WASM OCI artifacts.
+- [`kubewarden/packages/charts/*`](https://github.com/orgs/kubewarden/packages/charts)
+  are the our Helm charts as OCI artifacts. They follow SLSA standards.
+- Our container images are published as OCI images: `kubewarden-controller, policy-server, audit-scanner, kubectl`.
+- There's also `packages/tests/*` containing artifacts used in e2e tests, purposedfully separated.
+
+### Helm charts via HTTPS
+
+For typical Helm charts, they are published under our Helm chart HTTPS
+repository under https://charts.kubewarden.io (without SLSA nor signatures, yet
+this type of Helm repository allows for searchs).