skills.rest
beclab
beclabOFFICIAL
Explore all skills by this author →
GitHub

olares-chart

Convert repositories, docker-compose files, or Helm charts into deployable Olares application charts.

5.2k|321|Updated Apr 29, 2024
Search Tags:#kubernetes#docker-compose#Deployment#self-hosting#app packaging#olares#helm chart
One-click install
npx skills add https://github.com/beclab/Olares --skill olares-chart
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: olares-chart
Source: https://github.com/beclab/Olares/tree/main/cli/skills/olares-chart
Command: npx skills add https://github.com/beclab/Olares --skill olares-chart

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Porting an existing application to the Olares personal cloud requires building arch-correct container images, authoring a valid OlaresManifest, wiring storage, middleware, entrances, environment variables, and GPU resources, then deploying and debugging the result — a multi-axis process with many platform-specific pitfalls that lint alone cannot catch.

Core Features & Use Cases

  • Chart authoring and conversion: Scaffold an Olares chart from a docker-compose file with olares-cli chart from-compose, hand-author an OlaresManifest for a generic Helm chart, validate with chart lint, and package with chart package.
  • Image packaging guidance: Build and push pullable, node-architecture-correct images to Docker Hub or ghcr, since Olares only pulls images and never builds from source.
  • Deploy and diagnose loop: Upload, install, watch, and iterate on the app against your own Olares cluster, with guidance for runtime failures, permission issues, entrance timeouts, and architecture mismatches.
  • Use Case: Take an open-source project that ships only a docker-compose file, convert it into an Olares chart, wire its database as system middleware, build an arm64 image for your node, and deploy it to your own Olares until it reaches the running state.

Quick Start

Ask the AI to port a specific repository or docker-compose file into an Olares app and deploy it to your Olares using olares-cli.

Frequently Asked Questions about olares-chart

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a docker-compose app to Olares?▼

Run olares-cli chart from-compose with your compose file to scaffold an Olares chart, refine the generated OlaresManifest for storage, entrances, and middleware, then validate with chart lint. After lint passes, package the chart, upload it, and install it on your Olares with market install.

How do I convert a GitHub repository into an Olares app?▼

First author a docker-compose file from the source code if none exists, then run chart from-compose to generate the chart skeleton. Build and push an arch-correct image for your Olares node, refine the manifest, lint, and deploy via market upload and install.

Why does my Olares app fail with exec format error after deployment?▼

This means the container image architecture does not match the Olares node architecture. Query the node architecture with olares-cli cluster node list, rebuild the image for that specific architecture, push it, and redeploy the chart.

Does olares-cli chart lint catch all chart errors?▼

No. Lint validates chart structure but not Olares runtime correctness, such as missing metadata.appid, undeclared userspace mount permissions, wrong uid ownership, or entrance apiTimeout limits. These issues only surface during upload, install, or runtime.

Can I deploy an Olares chart without logging in?▼

Local authoring commands like from-compose, lint, and package work without login. Building images for a specific Olares and any deployment step require an active logged-in olares-cli profile, since they communicate with a running cluster.

How do I fix a chart stuck in upgradeFailed state on Olares?▼

Fix the underlying chart issue, bump the version in both Chart.yaml and OlaresManifest.yaml, re-package and re-upload, then run market upgrade with the new version. Do not use install, since app-service rejects install for an app that already exists.

Related Skills

Explore More Software Engineering Skills→
kweaver-aikweaver-ai

ci

Automate CI workflows for multi-arch image builds, chart versioning, and Helm packaging.

Official
Intermediate
GiovanniDragoGiovanniDrago

flutter-fdroid-publish

Automate Flutter Android app publication to F-Droid with reproducible builds and merge requests.

Community
Advanced
devantler-techdevantler-tech
2

gitops-cluster-debug

Diagnose Flux reconciliation failures on live Kubernetes clusters.

Official
Advanced
MearmanMearman
3

npm-exists

Check whether an npm package name exists in the registry.

Community
Intermediate