Skip to content

Commit b0c9489

Browse files
docs: OCI Helm Registries without authentication (#8973)
* docs: OCI Helm Registries without authentication * chore: trigger Netlify * docs: Apply suggestions from code review Co-authored-by: Amanda Churi Filanowski <[email protected]> * docs: Apply suggestions from code review part 2 * docs: Apply suggestions from code review part 3 * ci: auto-formatting prettier issues --------- Co-authored-by: Amanda Churi Filanowski <[email protected]>
1 parent e36fa9f commit b0c9489

File tree

3 files changed

+52
-11
lines changed

3 files changed

+52
-11
lines changed

docs/docs-content/registries-and-packs/registries/oci-registry/add-oci-helm.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,9 @@ You can add an OCI type Helm registry to Palette and use the Helm Charts in your
1313

1414
- Tenant admin access to Palette.
1515

16-
- Credentials to access the OCI registry. If you are using an Amazon Elastic Container Registry (ECR), you must have the
17-
AWS credentials to an IAM user or add a trust relationship to an IAM role so that Palette can access the registry.
16+
- If the registry uses basic authentication, credentials to access the OCI registry. If you are using an Amazon Elastic
17+
Container Registry (ECR), you must have the AWS credentials to an IAM user or add a trust relationship to an IAM role
18+
so that Palette can access the registry.
1819

1920
- If the OCI registry is using a self-signed certificate, or a certificate that is not signed by a trusted certificate
2021
authority (CA), you will need the certificate to add the registry to Palette.
@@ -83,6 +84,42 @@ Use the following steps to add an OCI Helm registry to Palette. Select the tab t
8384
registry you are adding.
8485

8586
<Tabs groupId="registry">
87+
88+
<TabItem value="no-authentication" label="No Authentication">
89+
90+
1. Log in to [Palette](https://console.spectrocloud.com) as a Tenant administrator.
91+
92+
2. From the left main menu, select **Tenant Settings**.
93+
94+
3. From the **Tenant Settings Menu**, select **Registries**.
95+
96+
4. On the**OCI Registries** tab, select **Add New OCI Registry**.
97+
98+
5. Enter the **Name** of the registry. For **Provider** type, select **Helm**.
99+
100+
6. For **OCI Authentication Type**, select **Basic**.
101+
102+
7. Toggle the **Synchronization** option to enable or disable synchronization for the registry. To learn more about the
103+
synchronization behavior of Helm registries, refer to the [Helm Registry](../helm-charts.md#synchronization-behavior)
104+
resource.
105+
106+
8. Provide the registry URL in the **Endpoint** field.
107+
108+
9. For **Base Content Path**, enter the base path to the repository in the registry where the Helm Charts are stored.
109+
You can specify multiple base paths by pressing the **ENTER** key after each path. Providing multiple base paths is
110+
useful when Helm Charts are stored in different directories or projects, such as multiple projects in a Harbor
111+
registry.
112+
113+
10. Leave the **Username** and **Password** fields empty.
114+
115+
11. If your OCI registry server is using a self-signed certificate or if the server certificate is not signed by a
116+
trusted CA, check the **Insecure Skip TLS Verify** box to skip verifying the x509 certificate, and click **Upload
117+
file** to upload the certificate.
118+
119+
12. Click **Confirm** to add the registry.
120+
121+
</TabItem>
122+
86123
<TabItem value="basic" label="Basic">
87124

88125
1. Log in to the [Palette](https://console.spectrocloud.com) as a Tenant administrator.

docs/docs-content/registries-and-packs/registries/oci-registry/oci-registry.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,19 +11,19 @@ Palette supports the configuration of multiple Open Container Initiative (OCI) r
1111
registry to Palette and use OCI artifacts in your cluster profiles. Palette only supports custom OCI registries that are
1212
hosting the following type of artifacts; Helm Charts, Zarf packages, and Packs.
1313

14-
Registries that comply with the OCI specification and support basic authentication are supported. OCI-compliant
15-
registries with basic authentication are labeled as **Basic**. Palette also supports some third-party registry
16-
providers, such as AWS ECR.
14+
Registries that comply with the OCI specification and support basic authentication are supported, although you can also
15+
add registries that do not require authentication. OCI-compliant registries with basic authentication are labeled as
16+
**Basic**. Palette also supports certain third-party registry providers, such as AWS ECR.
1717

1818
## Supported OCI Registries
1919

20-
The following type of OCI registries are supported:
20+
The following table describes the types of OCI registries that are supported.
2121

22-
| **Provider** | **Description** | **Basic** | **AWS ECR** |
23-
| ------------ | -------------------------------- | --------- | ----------- |
24-
| Helm | OCI based Helm Chart registries. |||
25-
| Zarf | OCI based Zarf registries. |||
26-
| Packs | OCI based Packs registries. |||
22+
| **Provider** | **Description** | **No Authentication** | **Basic** | **AWS ECR** |
23+
| ------------ | -------------------------------- | --------------------- | --------- | ----------- |
24+
| Helm | OCI-based Helm Chart registries. | |||
25+
| Zarf | OCI-based Zarf registries. | |||
26+
| Packs | OCI-based Packs registries. | |||
2727

2828
## Limitations
2929

docs/docs-content/release-notes/release-notes.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ tags: ["release-notes"]
5050

5151
#### Improvements
5252

53+
- You can now add OCI Helm registries that do not require authentication to Palette. This allows you to leverage
54+
publicly available OCI Helm Charts in your cluster profiles. Refer to the
55+
[Add OCI Helm Registry](../registries-and-packs/registries/oci-registry/add-oci-helm.md) guide to learn more.
56+
5357
#### Deprecations and Removals
5458

5559
### Edge

0 commit comments

Comments
 (0)