Deprecate artifact, deregister a version, or unassign a stage.
The command supports three use cases:
# deprecate an artifact: $ gto deprecate nn # deprecate a version: $ gto deprecate nn v0.0.1 # unassign a stage: $ gto deprecate nn v0.0.1 prod
Sometimes you need to mark an artifact version no longer ready for a specific
consumer, and maybe signal a downstream system about this. You can use
gto deprecate for that:
$ gto deprecate awesome-model v0.0.1 prod Created git tag 'awesome-model#prod!#2' that unassigns a stage from 'v0.0.1'
Sometimes you need mark a specific artifact version as a no longer ready for
usage. You could just delete a git tag, but if you want to preserve a history of
the actions, you may again use
$ gto deprecate awesome-model v0.0.1 Created git tag 'firstname.lastname@example.org!' that deregistered a version.
Sometimes you need to need to mark the artifact as "deprecated", usually meaning it's outdated and will no longer be developed. To do this, you could run:
$ gto deprecate awesome-model Created Git tag 'awesome-model@deprecated' that deprecates an artifact.
--repo <text>- Local or remote repository [default: .]
--message <text>- Message to annotate the Git tag with
--simple <text>- Use simple notation, e.g.
rf#prod-5[supported values: auto, true, false] [default: auto]
--force- Create the Git tag even if it already exists and is in effect
--delete- Delete the git tag(s) instead of creating the new one
--push- Push created git tag to
origin. The value is ignored if the
repooption is set to a remote URL. In that case tags are pushed to or created on the remote repo automatically.
--help- Show this message and exit.