Skip to main content

EnvironmentRedeployPlan

DRY RUN preview of redeployEnvironment: exactly what moving the environment to a target release version would do — component version diffs (game-api, Buddy, base images), whether game-DB schema DDL applies, and the pipeline tasks/steps that would run — WITHOUT creating a change order or touching any VM. Blockers list everything that would make the real mutation fail.

type EnvironmentRedeployPlan {
  environmentSlug: String!
  currentVersion: String
  targetVersion: String
  deployMode: String
  changeOrderKind: String
  schemaWillApply: Boolean!
  schemaGitRef: String
  componentChanges: [EnvironmentComponentChange!]!
  tasks: [EnvironmentPlannedTask!]!
  blockers: [String!]!
  notes: [String!]!
}

Fields​

EnvironmentRedeployPlan.environmentSlug ● String! non-null scalar​

Environment slug.

EnvironmentRedeployPlan.currentVersion ● String scalar​

Release version the environment currently observes (null before first deploy).

EnvironmentRedeployPlan.targetVersion ● String scalar​

Release version the redeploy would move to (the requested version, or the latest available for the class when omitted). Null when no version resolves — see blockers.

EnvironmentRedeployPlan.deployMode ● String scalar​

How the redeploy would run: 'services' (in-place bump on existing VMs) or 'full' (full reprovision). Null when blocked before resolution.

EnvironmentRedeployPlan.changeOrderKind ● String scalar​

Change-order kind the real mutation would enqueue ('redeploy_environment_services' or 'deploy_environment_version').

EnvironmentRedeployPlan.schemaWillApply ● Boolean! non-null scalar​

True when the plan applies the game schema (create-schema.sql at the target's schemaGitRef) to the tenant game DB in place. False when the observed schema ref already matches (apply skipped) or when blocked.

EnvironmentRedeployPlan.schemaGitRef ● String scalar​

Git ref whose create-schema.sql would be applied.

EnvironmentRedeployPlan.componentChanges ● [EnvironmentComponentChange!]! non-null object​

Per-component version diff between what the environment runs and what the target release pins.

EnvironmentRedeployPlan.tasks ● [EnvironmentPlannedTask!]! non-null object​

Pipeline tasks the change order would run (enumerated for 'services' mode; empty for 'full' mode and when blocked).

EnvironmentRedeployPlan.blockers ● [String!]! non-null scalar​

Why the real redeployEnvironment call would be rejected right now (active change order, missing flavors, version not deployable, ...). Empty when the redeploy would proceed.

EnvironmentRedeployPlan.notes ● [String!]! non-null scalar​

Human-readable highlights of what the redeploy does (game-api tag movement, Buddy artifact resolution, schema apply/skip, VM counts).

Returned By​

environmentRedeployPlan query