Container and orchestration plugins

Automax provides explicit plugins for container hosts and controller-side cluster operations.

Docker and Podman

Container plugins run on the selected remote target through the step SSH session. Use backend: docker or backend: podman.

- id: pull_image
  use: container.image.pull
  with:
    backend: podman
    image: registry.example/app:1.2.3

Container and Compose operations include deterministic manual command rendering for handovers and recovery:

- id: compose_check
  use: container.compose.config.check
  with:
    backend: docker
    project_dir: /srv/app
    file: compose.yaml

- id: compose_up
  use: container.compose.up
  with:
    backend: docker
    project_dir: /srv/app
    file: compose.yaml
    detach: true
    compose_services:
      - web

Destructive operations such as image removal, container removal, container stop and Compose down require confirm: true.

Kubernetes

Kubernetes plugins are controller-side in this release. They call kubectl from the Automax controller and use the controller's configured authentication.

- id: apply_manifest
  use: kubernetes.apply
  with:
    context: prod
    namespace: apps
    manifest: deploy.yaml
    server_side: true

Supported Kubernetes operations include context checks, namespace checks, apply, delete, rollout status, resource get and logs. kubernetes.delete requires confirm: true.

Helm

Helm plugins are controller-side and call helm from the Automax controller.

- id: deploy_chart
  use: helm.upgrade
  with:
    release: web
    chart: ./chart
    namespace: apps
    install: true
    atomic: true
    wait: true
    helm_timeout: 5m
    values_files:
      - values-prod.yaml
    set:
      - image.tag=1.2.3

Use helm.template and helm.lint for preflight rendering and validation. helm.rollback and helm.uninstall require confirm: true.