Skip to content

Sync Upsun skill with latest configuration guidance (fba1ad70a503)#24

Draft
pjcdawkins wants to merge 1 commit intomainfrom
auto/sync-upsun-skill-fba1ad70a503
Draft

Sync Upsun skill with latest configuration guidance (fba1ad70a503)#24
pjcdawkins wants to merge 1 commit intomainfrom
auto/sync-upsun-skill-fba1ad70a503

Conversation

@pjcdawkins
Copy link
Copy Markdown
Collaborator

Automated sync of the Upsun skill with configuration guidance in the
internal platformsh/ai repository.

Signature: fba1ad70a503

Files updated (regenerated deterministically from the Jinja guides):

  • plugins/upsun/skills/upsun/references/config.md
  • plugins/upsun/skills/upsun/references/config/directus.md
  • plugins/upsun/skills/upsun/references/config/django.md
  • plugins/upsun/skills/upsun/references/config/drupal.md
  • plugins/upsun/skills/upsun/references/config/echo.md
  • plugins/upsun/skills/upsun/references/config/express.md
  • plugins/upsun/skills/upsun/references/config/flask.md
  • plugins/upsun/skills/upsun/references/config/gatsby.md
  • plugins/upsun/skills/upsun/references/config/gin.md
  • plugins/upsun/skills/upsun/references/config/go.md
  • plugins/upsun/skills/upsun/references/config/hugo.md
  • plugins/upsun/skills/upsun/references/config/jekyll.md
  • plugins/upsun/skills/upsun/references/config/js.md
  • plugins/upsun/skills/upsun/references/config/laravel.md
  • plugins/upsun/skills/upsun/references/config/nextjs.md
  • plugins/upsun/skills/upsun/references/config/nuxt.md
  • plugins/upsun/skills/upsun/references/config/php.md
  • plugins/upsun/skills/upsun/references/config/python.md
  • plugins/upsun/skills/upsun/references/config/rails.md
  • plugins/upsun/skills/upsun/references/config/reactjs.md
  • plugins/upsun/skills/upsun/references/config/ruby.md
  • plugins/upsun/skills/upsun/references/config/sinatra.md
  • plugins/upsun/skills/upsun/references/config/static.md
  • plugins/upsun/skills/upsun/references/config/strapi.md
  • plugins/upsun/skills/upsun/references/config/sylius.md
  • plugins/upsun/skills/upsun/references/config/symfony.md
  • plugins/upsun/skills/upsun/references/config/vite.md
  • plugins/upsun/skills/upsun/references/config/vuejs.md
  • plugins/upsun/skills/upsun/references/config/wordpress.md

Source locations in platformsh/ai:

  • guides/per-group/<lang>.md.jinja — per-language references.
  • guides/per-result/<framework>.md.jinja — per-framework references.
  • The chapter index (references/config.md) is built from the file list.

Rendering reuses internal/registry in platformsh/ai, so versions here
match what the configuration-generation API recommends.

If these changes aren't wanted, close the PR; a subsequent run will open a
fresh PR on a new branch (the closed PR stays closed). A new PR is opened
automatically when the source guidance changes.

Copilot AI review requested due to automatic review settings April 22, 2026 21:05
@pjcdawkins pjcdawkins marked this pull request as draft April 22, 2026 21:06
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR synchronizes the Upsun skill’s configuration reference documentation with the latest internal configuration guidance, regenerating per-language and per-framework templates and updating the chapter index.

Changes:

  • Replaces the main references/config.md content with an index of per-language and per-framework guides.
  • Adds/regenerates reference configuration templates for common languages (Go, Node.js, PHP, Python, Ruby, static sites) and frameworks (e.g., Drupal, Symfony, Next.js, Nuxt, Strapi, WordPress).
  • Updates version pointers and guidance notes to align with the canonical Upsun image registry.

Reviewed changes

Copilot reviewed 29 out of 29 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
plugins/upsun/skills/upsun/references/config.md Reworked into an index page linking per-language/framework reference docs.
plugins/upsun/skills/upsun/references/config/directus.md Adds Directus reference configuration template and operational notes.
plugins/upsun/skills/upsun/references/config/django.md Adds Django reference configuration template (uv-based) and deployment notes.
plugins/upsun/skills/upsun/references/config/drupal.md Adds Drupal reference configuration template including Drush + mounts + caching.
plugins/upsun/skills/upsun/references/config/echo.md Adds Echo (Go) reference configuration template and DB options guidance.
plugins/upsun/skills/upsun/references/config/express.md Adds Express reference configuration template for Node.js apps.
plugins/upsun/skills/upsun/references/config/flask.md Adds Flask reference configuration template (uv + gunicorn) and options.
plugins/upsun/skills/upsun/references/config/gatsby.md Adds Gatsby reference configuration template and cache mount guidance.
plugins/upsun/skills/upsun/references/config/gin.md Adds Gin reference guidance pointing to Go baseline patterns.
plugins/upsun/skills/upsun/references/config/go.md Adds Go baseline reference template plus DB and worker patterns.
plugins/upsun/skills/upsun/references/config/hugo.md Adds Hugo static-site reference configs (Nix/composable + pinned binary).
plugins/upsun/skills/upsun/references/config/jekyll.md Adds Jekyll static-site reference config (composable image).
plugins/upsun/skills/upsun/references/config/js.md Adds Node.js baseline reference config template and package manager notes.
plugins/upsun/skills/upsun/references/config/laravel.md Adds Laravel reference config template (migrations, mounts, env setup).
plugins/upsun/skills/upsun/references/config/nextjs.md Adds Next.js reference template including writable .next handling.
plugins/upsun/skills/upsun/references/config/nuxt.md Adds Nuxt reference template including writable .nuxt handling.
plugins/upsun/skills/upsun/references/config/php.md Adds PHP baseline guidance for build/runtime/extension configuration.
plugins/upsun/skills/upsun/references/config/python.md Adds Python baseline guidance for uv/poetry/pipenv/pip.
plugins/upsun/skills/upsun/references/config/rails.md Adds Rails reference template including DB and worker notes.
plugins/upsun/skills/upsun/references/config/reactjs.md Adds high-level React guidance pointing to Node.js baseline patterns.
plugins/upsun/skills/upsun/references/config/ruby.md Adds Ruby baseline guidance for JS deps, DB URL, workers, mounts.
plugins/upsun/skills/upsun/references/config/sinatra.md Adds Sinatra reference template and DB option notes.
plugins/upsun/skills/upsun/references/config/static.md Adds static site guidance including composable image recommendation.
plugins/upsun/skills/upsun/references/config/strapi.md Adds Strapi reference template including DB service and secrets guidance.
plugins/upsun/skills/upsun/references/config/sylius.md Adds Sylius reference template including frontend build + mounts + cron guidance.
plugins/upsun/skills/upsun/references/config/symfony.md Adds Symfony reference template including database and messenger worker notes.
plugins/upsun/skills/upsun/references/config/vite.md Adds Vite static-site reference template and caching guidance.
plugins/upsun/skills/upsun/references/config/vuejs.md Adds Vue.js static-site reference template and caching guidance.
plugins/upsun/skills/upsun/references/config/wordpress.md Adds WordPress reference template (Bedrock + adjustments) and caching notes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +46 to +48
export PROJECT_NAME='Directus on Upsun'
export ADMIN_EMAIL='admin@example.com'
export ADMIN_PASSWORD='password'

**Configuration Details**:

- **Database Service**: PostgreSQL 16 service. Service named "db" exposes standard DB_ environment variables.
Comment on lines +59 to +66
- **Database Client**: Set automatically based on relationship service type
- **Admin Panel**: Accessible through Strapi's built-in interface
- **API Access**: All routes pass through to Strapi application

**Database Setup**:
- Strapi automatically configures database connection from `DATBASE_` variables Upsun provides for a relationship named `database`
- No manual environment variable configuration required
- Database migrations run during application startup
Comment on lines +33 to +35
commands:
start: bundle exec rails server

expires: 1w

mounts:
web/app/wp-content/cache:
- **API Access**: All routes pass through to Strapi application

**Database Setup**:
- Strapi automatically configures database connection from `DATBASE_` variables Upsun provides for a relationship named `database`
Comment on lines +38 to +39
^/(api|health):
passthru: true
Comment on lines +35 to +39
echo >> "$settings_dir"/settings.py "\n# Upsun configuration"
echo >> "$settings_dir"/settings.py 'ALLOWED_HOSTS = ["*"]'
if ! grep -q STATIC_ROOT "$settings_dir"/settings.py; then
echo >> "$settings_dir"/settings.py 'STATIC_ROOT = BASE_DIR / "static"'
echo >> "$settings_dir"/settings.py 'STATIC_URL = "/static/"'

# Set up environment variables for use at runtime.
echo >> .environment 'export DATABASE_URL="${DB_SCHEME}://${DB_USERNAME}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_PATH}"'
echo >> .environment 'export WP_HOME=$(echo $PLATFORM_ROUTES | base64 --decode | jq -r "to_entries[] | select(.value.primary == true) | .key")'
Comment on lines +29 to +38
CACHE_ENABLED=true
CACHE_STORE=redis
REDIS_HOST=\$REDIS_HOST
REDIS_PORT=\$REDIS_PORT
RATE_LIMITER_ENABLED=true
RATE_LIMITER_STORE=redis
RATE_LIMITER_REDIS_HOST=\$REDIS_HOST
RATE_LIMITER_REDIS_PORT=\$REDIS_PORT
KEY=\$PLATFORM_PROJECT_ENTROPY
SECRET=\$PLATFORM_PROJECT_ENTROPY
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants