resetPackage
Reset a package to its initialized state. This is useful for:
- Forcing a stuck bundle off the canvas
- Redeploying a package from scratch
- Clearing state when delete_state is true
The package's status _will_ be set to INITIALIZED.
By default, the state will not be destroyed. If you want to destroy the state, set delete_state to true. By default, the params will not be cleared. If you want to clear the params, set delete_params to true. By default, the deployments will not be deleted. If you want to delete the deployments, set delete_deployments to true.
This mutation is an escape hatch and can lose data.
Please make sure to pull any state first.
Read our manage state guide on setting up your state backend.
OpenTofu
> tofu state pull > /somewhere/safe.tfstate
Terraform
> terraform state pull > /somewhere/safe.tfstate
resetPackage(
organizationId: ID!
id: ID!
deleteState: Boolean!
deleteParams: Boolean!
deleteDeployments: Boolean!
): PackagePayload
Arguments
resetPackage.organizationId
● ID!
non-null scalar
resetPackage.id
● ID!
non-null scalar
Package ID or {project.slug}-{environment.slug}-{manifest.slug} i.e.: ecomm-staging-database
resetPackage.deleteState
● Boolean!
non-null scalar
Destroy the state of the package
resetPackage.deleteParams
● Boolean!
non-null scalar
Clear the params of the package
resetPackage.deleteDeployments
● Boolean!
non-null scalar
Delete deployment history for this package