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 install

Quick 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 existe

Para 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	completo (primitivas + arquitectura interna)
Comportamiento	docs/behavior/behavior.md	backfill on-demand (8 flujos)
Configuración	docs/config/configuracion.md	inventario base (7 opciones, sin env vars)
Interfaz	docs/interface/interface.md	API Ruby pública (11 modelos + Base + concerns)
Topología	docs/topology/topology.md	3 deps runtime + grafo de contexto
Errores	docs/errors/errors.md	jerarquía + mapeo HTTP + política §c
Consumidas	docs/consumed/docker-engine-api.md	Docker Engine API + retry/degradación §c/§e
Test	docs/test/testing.md	suite RSpec unit+integration + gaps/contract/PII §e-h (§g sin incidentes)
Release	docs/release/release.md	completo — §a estructura (tag v*→RubyGems, patrón 1) + §b enrich (deploy/rollback/ambientes/dueño)
API (operaciones)	—	n/a (gema sin superficie HTTP/CLI/eventos; superficie pública = Interfaz)
Eventos	—	n/a (la gema no emite eventos)
Seguridad	—	n/a (sin authn/authz propios; frontera auth-hacia-Docker en docs/consumed/docker-engine-api.md §a)
Multi-tenancy	—	n/a (gema stateless sin DB ni scope de tenant)
Data-lifecycle	—	n/a (sin persistencia/PII/retención; fixtures sintéticas)

n/a = no aplica al tipo de repo.

Desarrollo

bundle exec rspec --tag ~type:integration   # unit suite
bundle exec rspec                            # incluye integration (requiere Docker socket)
bundle exec rubocop -a                       # lint

Release: /gem-release (publica a RubyGems via GitHub Action al tag v*).

Licencia

MIT — ver LICENSE.