github kimdre/doco-cd v0.113.0-rc.2

pre-release4 hours ago

This pre-release removes three deprecated features that have reached end-of-life.

🚨 Breaking Changes

  1. Job execution mode: the one_shot alias for one_off is no longer supported.
    Use one_off instead; one_shot values are rejected.

  2. Auto-discovery labels: legacy label formats are retired:

    • cd.doco.deployment.auto_discover
    • cd.doco.deployment.auto_discover.delete
    • cd.doco.deployment.auto_discovery.delete

    New deployments use cd.doco.deployment.auto_discovery and the JSON configuration label cd.doco.deployment.auto_discovery.config.

  3. SSH private keys: PKCS#1 ENCRYPTED PRIVATE KEY support is removed because
    it relied on the deprecated Go x509.DecryptPEMBlock() API. Use modern OpenSSH
    or unencrypted PEM key formats.

Automatic migration

Existing deployments using legacy auto-discovery labels are migrated automatically:

  • Swarm service labels are converted in place without restarting tasks.
  • Legacy delete settings are preserved in the new JSON configuration label.
  • Standalone containers remain discoverable during the transition and receive the
    current labels on their next deployment.

User actions

  • Change one_shot to one_off in job definitions.
  • Convert password-protected SSH keys to a supported modern format.
  • No manual relabeling is required for existing auto-discovered deployments.

New label to deploy new services in created/stopped state.

Docker Compose services are started automatically after they are created or updated. To let an external tool control a service's lifecycle, set the cd.doco.deployment.autostart service label to false.

services:
  on-demand:
    image: example/on-demand:latest
    labels:
      cd.doco.deployment.autostart: "false"

The label defaults to true. When it is false:

  • A service without an existing container is created but not started.
  • A stopped service remains stopped when it is recreated or updated.
  • A running service is restarted normally when it is recreated or updated.
  • A service that remains stopped is excluded from deployment readiness checks.

More info in the wiki: https://doco.cd/next/Deploy-Settings/#preserve-a-services-running-state


What's Changed

🚨 Breaking Changes

  • refactor!: remove deprecated one_shot alias for jobs, deprecated labels, and PKCS#1 SSH support by @kimdre in #1757

✨ Features

  • feat(config): add service autostart control label by @kimdre in #1756

🌟 Improvements

  • fix(migration): handle multiple migration errors and continue processing by @kimdre in #1758

📦 Dependencies

  • fix(deps): update module github.com/google/go-containerregistry to v0.22.0 by @renovate[bot] in #1749
  • chore(deps): update github/codeql-action digest to cdf488f by @renovate[bot] in #1752
  • fix(deps): update aws-sdk-go-v2 monorepo by @renovate[bot] in #1753

Full Changelog: v0.113.0-rc.1...v0.113.0-rc.2

Don't miss a new doco-cd release

NewReleases is sending notifications on new releases.