overlane release rollback

Roll back a release: move the project's pin back to the previous release and install it

Asks the service to move the pin back one release, then installs that release the way release update does. Destructive: it reverts the project’s release. Without a terminal it needs –force.

Usage

overlane release rollback [--approve DIGEST] [--dry-run] [--force]

Flags

Flag	Type	Required	Description
`--approve`	string	no	Approve this exact release digest when it changes executable files or policy
`--dry-run`	boolean	no	Print the requests and file changes this command would make, then stop. Needs no credentials.
`--force`	boolean	no	Confirm a destructive action when there is no terminal to ask on. Without it, exit 2.

Examples

overlane release rollback --dry-run
overlane release rollback --force

Behavior

Effect: destructive (deletes or reverts; needs --force without a terminal).
Needs credentials: yes. Uses the network: yes.
Supports --dry-run: yes. Accepts --force: yes.
Machine-readable description: overlane schema release rollback.

Result

With --json (the default when stdout is not a terminal) the command prints this JSON Schema’s shape on stdout.

{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "pinnedTo": {
          "type": "object",
          "properties": {
            "digest": {
              "type": "string"
            },
            "version": {
              "type": "string"
            }
          },
          "required": [
            "digest",
            "version"
          ],
          "additionalProperties": false
        },
        "install": {
          "type": "object",
          "properties": {
            "version": {
              "type": "string"
            },
            "digest": {
              "type": "string"
            },
            "alreadyInstalled": {
              "type": "boolean"
            },
            "changeKinds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "restart": {
              "type": "string"
            },
            "files": {
              "type": "object",
              "properties": {
                "added": {
                  "type": "number"
                },
                "changed": {
                  "type": "number"
                },
                "removed": {
                  "type": "number"
                }
              },
              "required": [
                "added",
                "changed",
                "removed"
              ],
              "additionalProperties": false
            },
            "approvalRecorded": {
              "type": "boolean"
            },
            "restartNote": {
              "type": "string"
            }
          },
          "required": [
            "version",
            "digest",
            "alreadyInstalled",
            "changeKinds",
            "restart",
            "files",
            "approvalRecorded"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "pinnedTo",
        "install"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "dryRun": {
          "type": "boolean",
          "const": true
        },
        "service": {
          "type": "string"
        },
        "requests": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "method": {
                "type": "string"
              },
              "path": {
                "type": "string"
              },
              "body": {},
              "note": {
                "type": "string"
              }
            },
            "required": [
              "method",
              "path"
            ],
            "additionalProperties": false
          }
        },
        "commands": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "writes": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "action": {
                "type": "string",
                "enum": [
                  "write",
                  "append",
                  "delete"
                ]
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "action",
              "description"
            ],
            "additionalProperties": false
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "dryRun",
        "requests",
        "commands",
        "writes",
        "notes"
      ],
      "additionalProperties": false
    }
  ]
}

See exit codes for the status the process returns.