Skip to main content

atmos pro lock

Purpose

This command implements the locking feature of Atmos Pro. Use this command to lock a stack in Atmos Pro so that it cannot be planned or applied by another process (pull request, CI/CD, etc.)

Usage​

Execute the pro lock command like this:

atmos pro lock --component <component> --stack <stack> --ttl <ttl> --message <message>

Description​

Atmos pro supports locking a stack in Atmos Pro so that it cannot be planned or applied by another process (pull request, CI/CD, etc.). Your CI/CD pipeline can use the atmos pro lock command to ensure it is the exclusive process interacting with a stack at the current time. Once your work is complete, you can unlock the stack by running the atmos pro unlock command.

tip

Run atmos pro lock --help to see all the available options

Examples​

atmos pro lock --component vpc --stack plat-ue2-dev --ttl 300 --message "Locked by $GITHUB_RUN_ID"
atmos pro lock --component vpc --stack plat-ue2-dev --ttl 300

Flags​

FlagDescriptionAliasRequired
--componentAtmos component to lock-cyes
--stackAtmos stack to lock-syes
--ttlThe time to live (TTL) for the lock, in seconds. Defaults to 30-tno
--messageA message to display to other users who try to lock the stack. Defaults to "Locked by Atmos"-mno