docker-swarm
Propósito
ORM ligero y cliente API para Docker Swarm en Ruby. Expone las primitivas del Docker Engine (Service, Node, Task, Container, Network, Volume, Config, Secret, Swarm, System, Image) como modelos ActiveModel con CRUD, validaciones y logs estructurados KV. Excon directo sobre el socket Unix (default) o TCP.
Setup
# Gemfile
gem 'docker-swarm', '~> 0.6'bundle installQuick start:
require 'docker_swarm'
DockerSwarm.configure do |config|
config.socket_path = "unix:///var/run/docker.sock" # default
config.log_level = Logger::INFO
end
DockerSwarm::System.up # => "OK"
DockerSwarm::Service.all # => [#<Service ...>, ...]
DockerSwarm::Service.find("svc-id") # => nil si no existePara el contrato completo de la gema (símbolos públicos, gotchas, integración) ver skill/SKILL.md.
Índice de artefactos
Documentación normada (RFC-001) por capa:
| Capa | Artefacto | Estado |
|---|---|---|
| Datos | — |
n/a (gema sin DB) |
| Glosario | docs/glossary/glossary.md |
F1 completo |
| Comportamiento | docs/behavior/behavior.md |
F1 backfill on-demand (8 flujos) |
| API (operaciones) | — | F2 pendiente; contrato resumido inline en skill/SKILL.md
|
| Interfaz | — | F2 pendiente; contrato resumido inline en skill/SKILL.md
|
| Topología | — | F2 pendiente |
| Eventos | — |
n/a (la gema no emite eventos) |
n/a = no aplica al tipo de repo. F2 pendiente = capa declarada en la RFC pero todavía no implementada en dev-structure; el contenido relevante vive transitoriamente en skill/SKILL.md (RFC-008 §2 coexistencia transitoria).
Desarrollo
bundle exec rspec --tag ~type:integration # unit suite
bundle exec rspec # incluye integration (requiere Docker socket)
bundle exec rubocop -a # lintRelease: /gem-release (publica a RubyGems via GitHub Action al tag v*).
Licencia
MIT — ver LICENSE.