Conversation
ganeshdipdumbare
commented
Mar 24, 2026
- refactor skills
There was a problem hiding this comment.
Pull request overview
This PR refactors the Upsun “skills” documentation by removing the legacy using-upsun skill content and introducing a new consolidated upsun skill with a smaller reference set, plus a minor Cursor plugin manifest tweak.
Changes:
- Remove the
plugins/upsun/skills/using-upsun/skill and its reference docs. - Add a new
plugins/upsun/skills/upsun/skill entrypoint and a.upsun/config.yamlreference template page. - Minor formatting/punctuation update in the Cursor plugin manifest.
Reviewed changes
Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| plugins/upsun/skills/using-upsun/references/troubleshooting.md | Deleted legacy troubleshooting reference doc. |
| plugins/upsun/skills/using-upsun/references/services-databases.md | Deleted legacy services/databases reference doc. |
| plugins/upsun/skills/using-upsun/references/resources-scaling.md | Deleted legacy resources/scaling reference doc. |
| plugins/upsun/skills/using-upsun/references/projects-organizations.md | Deleted legacy projects/organizations reference doc. |
| plugins/upsun/skills/using-upsun/references/integration-variables.md | Deleted legacy integrations/variables reference doc. |
| plugins/upsun/skills/using-upsun/references/environments.md | Deleted legacy environments reference doc. |
| plugins/upsun/skills/using-upsun/references/development-tools.md | Deleted legacy development tools reference doc. |
| plugins/upsun/skills/using-upsun/references/deployments.md | Deleted legacy deployments reference doc. |
| plugins/upsun/skills/using-upsun/references/backups.md | Deleted legacy backups reference doc. |
| plugins/upsun/skills/using-upsun/references/access-security.md | Deleted legacy access/security reference doc. |
| plugins/upsun/skills/using-upsun/references/COMMAND-INDEX.md | Deleted legacy command index reference doc. |
| plugins/upsun/skills/using-upsun/SKILL.md | Deleted legacy using-upsun skill entrypoint. |
| plugins/upsun/skills/upsun/references/config.md | Added .upsun/config.yaml reference templates and common type values. |
| plugins/upsun/skills/upsun/SKILL.md | Added new consolidated Upsun skill entrypoint and workflows. |
| plugins/upsun/.cursor-plugin/plugin.json | Minor manifest description punctuation change. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
| ## Common `type` values | ||
|
|
||
| | Runtime | Value | | ||
| |-----------|------------------| | ||
| | Node.js | `nodejs:22` | | ||
| | PHP | `php:8.3` | | ||
| | Python | `python:3.12` | | ||
| | Ruby | `ruby:3.3` | | ||
| | Go | `golang:1.23` | | ||
| | Java | `java:21` | | ||
|
|
||
| | Service | Value | | ||
| |------------|--------------------| | ||
| | PostgreSQL | `postgresql:16` | | ||
| | MySQL | `mysql:11.4` | | ||
| | Redis | `redis:7.2` | | ||
| | MongoDB | `mongodb:7.0` | | ||
| | OpenSearch | `opensearch:2` | | ||
| | RabbitMQ | `rabbitmq:3.13` | |
There was a problem hiding this comment.
Should rely on https://meta.upsun.com/images for languages, services and version
There was a problem hiding this comment.
Yes or the regular templated export from the API (whichever is easiest first)
|
|
||
| ## Safety rules | ||
|
|
||
| - Production deploy without a recent backup → create one first; confirm before proceeding |
There was a problem hiding this comment.
Unsure we might want to do this
| - List apps, workers, and services with current sizes first | ||
| - Target sizes: XS / S / M / L / XL / 2XL |
There was a problem hiding this comment.
upsun has no sizing
|
|
||
| ### Deploy / Redeploy | ||
| - Never assume `main` is production — confirm | ||
| - Running database migrations? → recommend `stopstart` deployment strategy and a pre-deploy backup |
There was a problem hiding this comment.
this would need a dedicated article about continuous DB update with rolling deployment, maybe later?
|
|
||
| Walk the developer through these steps in order. Do one at a time; confirm each before moving on. | ||
|
|
||
| ### 1. Install CLI |
There was a problem hiding this comment.
we might also document upgrading