perpetual changeset
Manage changesets.
perpetual changeset commit
Commit a changeset — applies ALL its draft changes atomically.
perpetual changeset commit <id> [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--name | string | Optional | Rename the changeset before committing (applied only once the commit is confirmed). |
--description | string | Optional | Replace the changeset's description before committing. |
--force | boolean | Optional | Skip confirmation prompt (required in non-interactive mode). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset create
Create a new (empty draft) changeset.
perpetual changeset create [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--name | string | Optional | Changeset name. |
--description | string | Optional | Changeset description. |
Also accepts the global flags, including the sign-in flags.
perpetual changeset delete
Delete a changeset (discards all its draft changes).
perpetual changeset delete <id> [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--force | boolean | Optional | Skip confirmation prompt (required in non-interactive mode). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset diff
Show what a changeset would change.
perpetual changeset diff <id>
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset discard-change
Discard a single proposed change within a changeset.
perpetual changeset discard-change <changesetId> <resourceId>
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
changesetId | Required | Changeset ID (CHG_*). |
resourceId | Required | Resource ID of the proposed change to discard. |
Also accepts the global flags, including the sign-in flags.
perpetual changeset get
Get changeset details.
perpetual changeset get <id>
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset list
List changesets.
perpetual changeset list [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--top | string | Optional | Items per page (server default 100). |
--skip | string | Optional | Number of items to skip. |
--all | boolean | Optional | Fetch every page (1000 items per request). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset stage
Stage GitOps files into an existing draft changeset in dependency order, without committing.
perpetual changeset stage <id> [paths] [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
paths | Optional | Files, directories or quoted globs. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--dir | string | Optional | GitOps root (default .). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset unstage
Discard the changes a draft changeset holds for these GitOps files.
perpetual changeset unstage <id> [paths] [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
paths | Optional | Files, directories or quoted globs. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--dir | string | Optional | GitOps root (default .). |
Also accepts the global flags, including the sign-in flags.
perpetual changeset update
Update changeset metadata.
perpetual changeset update <id> [flags]
Changes: Stages nothing.
Output: With --json, prints its result in the JSON envelope and any error in the error envelope.
Arguments
| Argument | Required | Description |
|---|---|---|
id | Required | Changeset ID (CHG_*). |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--name | string | Optional | New changeset name. |
--description | string | Optional | New description (pass empty string to clear). |
Also accepts the global flags, including the sign-in flags.
Perpetual CLI 0.5.0