Compatibility
From v0.2.0 onward, releases prioritize stable backward compatibility; breaking changes are called out here and reflected in semver. This release still includes CLI renames and entry-point consolidation (below); later releases will follow the policy more strictly.
Breaking changes
Update scripts, docs, and CI before upgrading.
| Item | v0.1.0 | v0.2.0 |
|---|---|---|
| Infrastructure CLI | aigear-gcp-infra |
aigear-infra |
| Model CLI | aigear-model-yaml, aigear-deploy-model |
aigear-model (--yaml + deploy / update / delete / status) |
| Image CLI | implicit multi-image ops; --prune |
explicit --all; --prune removed |
Highlights
aigear-infra:--update,--delete,--statuswith dependency ordering; updatable resources include Cloud Build triggers and GKE (node pools / autoscaling).- Cloud Build: trigger create / update / delete and
--statusare now a supported, documented capability (v0.1.0 had only internal placeholders). aigear-model: unified deploy / update / delete / status and--yaml(lazy imports reduce cold-start time).aigear-image:LocalImage/RegistryImagereplaceArtifactsImage; deletion, retagging, registry cleanup;--allfor multi-image ops.aigear-scheduler:--list,--pause,--resume,--run.aigear-env-schema:--delete,--show.AIGEAR_ENV_PATH: override defaultenv.jsonpath.- Quality: stronger tests/CI (PR workflow,
aigear[dev]); manygcloudwrite paths userun_sh(check=True)instead of"ERROR"substring checks.
Known limitations
- Some
CloudBuildpaths inbuild.pystill use"ERROR"output checks; migration planned for a later minor release. - No deep drift detection (semantic diff of live GCP vs
env.json). aigear-infra --deletedoes not fully automate teardown for every resource type (Artifact Registry, KMS, Pre-VM, etc.) — see README and CLI reference.
Upgrade
- Replace
aigear-gcp-infra→aigear-infra;aigear-model-yaml/aigear-deploy-model→aigear-model. - Add
aigear-image --allwhere needed; remove--prune. - Smoke-test:
aigear-infra --status,aigear-model --help,aigear-image --help. For Cloud Build, verifycloud_buildconfig and lifecycle flags in staging.