Skip to main content

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​

ArgumentRequiredDescription
idRequiredChangeset ID (CHG_*).

Flags​

FlagTypeRequiredDescription
--namestringOptionalRename the changeset before committing (applied only once the commit is confirmed).
--descriptionstringOptionalReplace the changeset's description before committing.
--forcebooleanOptionalSkip 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​

FlagTypeRequiredDescription
--namestringOptionalChangeset name.
--descriptionstringOptionalChangeset 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​

ArgumentRequiredDescription
idRequiredChangeset ID (CHG_*).

Flags​

FlagTypeRequiredDescription
--forcebooleanOptionalSkip 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​

ArgumentRequiredDescription
idRequiredChangeset 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​

ArgumentRequiredDescription
changesetIdRequiredChangeset ID (CHG_*).
resourceIdRequiredResource 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​

ArgumentRequiredDescription
idRequiredChangeset 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​

FlagTypeRequiredDescription
--topstringOptionalItems per page (server default 100).
--skipstringOptionalNumber of items to skip.
--allbooleanOptionalFetch 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​

ArgumentRequiredDescription
idRequiredChangeset ID (CHG_*).
pathsOptionalFiles, directories or quoted globs.

Flags​

FlagTypeRequiredDescription
--dirstringOptionalGitOps 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​

ArgumentRequiredDescription
idRequiredChangeset ID (CHG_*).
pathsOptionalFiles, directories or quoted globs.

Flags​

FlagTypeRequiredDescription
--dirstringOptionalGitOps 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​

ArgumentRequiredDescription
idRequiredChangeset ID (CHG_*).

Flags​

FlagTypeRequiredDescription
--namestringOptionalNew changeset name.
--descriptionstringOptionalNew description (pass empty string to clear).

Also accepts the global flags, including the sign-in flags.


Perpetual CLI 0.5.0