Skip to content

docs(apps): document seamless service/container runnables#21

Open
krokicki wants to merge 1 commit into
mainfrom
docs-apps-service-container
Open

docs(apps): document seamless service/container runnables#21
krokicki wants to merge 1 commit into
mainfrom
docs-apps-service-container

Conversation

@krokicki

@krokicki krokicki commented Jul 1, 2026

Copy link
Copy Markdown
Member

Documents the Apps-feature improvements that make container-based services (e.g. code-server) runnable without a launcher script. These docs pair with the backend changes on the fileglancer more-apps branch.

What's documented

  • FG_SERVICE_PORT / FG_HOSTNAME — env vars Fileglancer now exports for every service-type job (a free port picked on the compute node, plus the hostname).
  • auto_url — new service-only runnable field; when set, Fileglancer writes http://$FG_HOSTNAME:$FG_SERVICE_PORT to SERVICE_URL_PATH so the service needs no URL-writing code.
  • working_dir: repo auto-bind — the cached repo clone is now bind-mounted into containers, so the documented escape hatch actually works.

Files

  • services.mdx — new "Easy Path: Let Fileglancer Manage the Port and URL" section with a launcher-free container example and a readiness-tradeoff aside; reframes the manual URL-writing section as the advanced path.
  • execution.mdx — adds the new env vars to the "Variables Set by Fileglancer" table and notes the repo bind.
  • manifest-reference.mdx — adds the auto_url field row.

Context

These edits were originally made in the apps-updates working tree but never committed, so they were left out when apps-updates merged (PR #20). This branch is based on the current main and carries them forward.

🤖 Generated with Claude Code

Documents the Apps-feature improvements that let container-based services
run without a launcher script:

- FG_SERVICE_PORT / FG_HOSTNAME env vars for service jobs, and the new
  service-only `auto_url` field, with a launcher-free container example.
- working_dir: repo now auto-binds the cached repo clone into containers.

Covers services.mdx (new "Easy Path" section), execution.mdx (env var
table + bind-mount note), and manifest-reference.mdx (auto_url field).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant