composer

Manage Docker Compose stacks on self-hosted Composer via REST API.

1|Updated Mar 18, 2024
One-click install
npx skills add https://github.com/erfianugrah/dotfiles --skill composer-erfianugrah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: composer
Source: https://github.com/erfianugrah/dotfiles/tree/main/.pi/agent/skills/composer
Command: npx skills add https://github.com/erfianugrah/dotfiles --skill composer-erfianugrah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reliably deploy, update, restart, and remove Docker Compose stacks on a self-hosted Composer platform without running local compose commands that might target the wrong host or leak sensitive operations onto the wrong machine.

Core Features & Use Cases

  • Automated stack lifecycle via REST API: create stacks from git or local sources, reconcile environment, run up/build/down/restart/pull, and manage imports.
  • Production guardrails and observability: enforces auth roles, provides OpenAPI-driven endpoint discovery, supports async jobs and real-time SSE streams for logs and pipeline runs.
  • Pipeline-based orchestration and webhooks: run scheduled or event-driven pipelines composed of compose actions, shell commands, docker exec, and HTTP requests where allowed.
  • Security-critical credential handling: includes a hard safety rule to never run the daemon on the dev box, plus guidance for WAF workarounds when credential-shaped bodies are blocked.

Quick Start

Ask the AI to list your stacks on the production instance using COMPOSER_API_KEY and the Composer base URL by running a curl GET to /api/v1/stacks.

Frequently Asked Questions about composer

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

FAQPage Schema
How do I manage Docker Compose stacks remotely via a REST API?

You can manage Docker Compose stacks remotely via a REST API by targeting a self-hosted Composer instance to perform CRUD operations, deployments, and environment reconciliation without running local compose commands. This prevents accidental operations on the wrong host.

What is the safest way to automate Docker Compose deployments on a production host?

The safest way to automate Docker Compose deployments on a production host is to use API-driven orchestration with enforced auth roles and production guardrails, ensuring you never run the composerd daemon directly on your dev machine.

How do I stream logs and pipeline runs for Docker Compose operations?

You can stream logs and pipeline runs for Docker Compose operations by utilizing real-time SSE streams provided by the Composer platform, allowing you to monitor async jobs and event-driven pipeline executions over the API.

How do I orchestrate pipelines with Docker Compose actions and shell commands?

You orchestrate pipelines with Docker Compose actions and shell commands by defining event-driven or scheduled pipelines on the Composer platform, chaining compose actions, docker exec, and HTTP requests within allowed operational guardrails.

Why are my API requests blocked when sending credentials to deploy Docker Compose stacks?

API requests deploying Docker Compose stacks may be blocked by WAF rules intercepting credential-shaped bodies. The Skill provides specific WAF workarounds to ensure security-critical credential handling passes correctly during stack automation.

Does the Composer API require OpenAPI specifications for endpoint discovery?

Yes, the Composer API relies on OpenAPI-driven endpoint discovery to ensure safe targeting and spec-driven automation, requiring correct API authentication via API key, cookie, or bearer token to manage stack lifecycles.