Skip to content

docs: enhance catalog management section with sync and import instruc… #58

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
iasthc merged 1 commit into from
Jan 6, 2026
Merged

docs: enhance catalog management section with sync and import instruc… #58

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 30 additions & 1 deletion src/content/docs/service/applications/04-store.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,35 @@ Each application card displays:
- **Description**: A brief description of the application.
- **Repository**: The source repository of the chart (e.g., `otterscale/`). Official OtterScale charts are marked with a "Official" badge.

## Managing the Catalog

The Store provides tools to keep your application catalog up-to-date and flexible. You can find the **Import** and **Sync** buttons at the top right of the page.

### Synchronize with ArtifactHub

To populate the store with popular community applications, use the **Sync** feature.

- Clicking the **Sync** button initiates a synchronization process with [ArtifactHub](https://artifacthub.io/).
- The system automatically fetches the **top 60 most popular Helm charts** based on ArtifactHub rankings.

@gemini-code-assist gemini-code-assist Bot Jan 6, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The documentation for the 'Sync' feature is clear about what it adds, but it's ambiguous about what happens to existing charts in the catalog. The term 'synchronization' could imply that charts not in ArtifactHub's top 60 are removed. To prevent user confusion or anxiety about losing their charts, I recommend explicitly stating that the sync process is additive and does not remove existing charts.

- The system automatically fetches the **top 60 most popular Helm charts** based on ArtifactHub rankings. This is an additive process and will not affect existing charts in your catalog.

- This ensures your cluster has quick access to widely used tools (such as Argo CD, Prometheus, or Airflow) without manual configuration.

### Import Custom Charts

If you need to deploy a specific chart that is not included in the standard catalog or the ArtifactHub sync list, you can import it manually.

<Steps>

1. Click the **Import** button.
2. In the **Import Chart** dialog, paste the direct link to the chart's `.tgz` file.
* *Example:* `https://charts.bitnami.com/bitnami/nginx-15.0.0.tgz`
3. Click **Confirm**.

</Steps>

<Aside type="note">
Ensure the URL points directly to a valid tarball (`.tgz`) file. Once imported, the chart will appear in the application list and be ready for installation.
</Aside>

## Application Details

Clicking on an application card opens a details panel with two main tabs:
Expand Down Expand Up @@ -72,4 +101,4 @@ For existing releases listed in the **Releases** tab, you can perform the follow

- **Edit**: Update the release configuration (e.g., change values or upgrade version).
- **Rollback**: Revert the release to a previous revision.
- **Delete**: Uninstall the release from the cluster.
- **Delete**: Uninstall the release from the cluster.
Loading