Deployment model

A DinaSync agent, abbreviated DSA, is an installed process in the customer environment. It establishes outbound HTTPS and mTLS communication with the Codinamo control plane, claims jobs, persists state, and reports events.

One agent can serve multiple targets assigned to it.

A deployment target, abbreviated TAR, is a workspace entity describing a destination and update strategy. It can represent a machine, Docker container, Compose project, or Swarm service.

A target may exist without an assigned agent. This supports infrastructure planning before agent enrollment.

DINASYNC_DEPLOY resolves a target reference and creates a job containing the release and immutable target revision. The assigned agent claims that job and reports state and logs to the backend.

Enrollment, application-encrypted local state, job leasing, outbox delivery, target configuration, restricted Docker execution, cancellation, logs, and final status reporting are implemented.

The agent supports Docker Compose reconciliation, replacement of one named Docker container, and Docker Swarm service updates. It does not expose arbitrary shell execution.

Automatic health verification and rollback policies are not implemented yet. A failed Docker command is reported to the originating Codinamo run instead of being hidden or retried as an unrelated operation.