ertia app install#

Install application into environment

Synopsis#

Install the application into the target environment.

Two installation strategies are supported:

branch        Installs the latest CI build from a given git branch.
              Defaults to "main" if no branch is specified.

semver-range  Installs the latest release matching a minimum semver version.
              Defaults to "0.0.0" (latest stable) if no version is specified.
              Use a pre-release suffix (e.g. 0.0.0-0) to include pre-releases.

For advanced filtering, use –tags-semver and –tags-include together to provide a raw semver constraint and tag regex directly.

ertia app install [flags]

Examples#

  # Latest CI build from main (these are equivalent)
  ertia app install
  ertia app install --strategy=branch
  ertia app install --strategy=branch --branch=main

  # Latest CI build from a feature branch
  ertia app install --strategy=branch --branch=my-feature

  # Latest stable release (no pre-releases)
  ertia app install --env=prod --strategy=semver-range
  ertia app install --env=prod --strategy=semver-range --min-version=0.0.0

  # Latest stable release (with pre-releases)
  ertia app install --env=prod --strategy=semver-range --min-version=0.0.0-0

  # Latest release in major version 1
  ertia app install --env=prod --strategy=semver-range --min-version=1.0.0

  # Advanced: provide raw semver constraint and tag filter directly
  ertia app install --semver=">= 1.2.0" --semver-include-tags=".*-CICD[.][0-9]+[.]main[.].*$"

Options#

      --branch string                Git branch to install from (used with --strategy=branch) (default "main")
  -h, --help                         help for install
      --min-version string           Minimum semver version to install (used with --strategy=semver-range, e.g. "1.0.0", "0.0.0-0")
      --semver string                Raw semver constraint (must be set together with --semver-include-tags)
      --semver-include-tags string   Raw tag filter regex (must be set together with --semver)
      --strategy string              Installation strategy: "branch" or "semver-range" (default "branch")

Options inherited from parent commands#

  -e, --env string      Environment to target
  -t, --tenant string   Tenant to target (Inferred by default)

SEE ALSO#

Auto generated by spf13/cobra on 11-Mar-2026#