Overcast is alpha — behaviour and APIs may change between releases. Pin your version and read the changelog before upgrading.

overcast

Wiping and importing state

overcast reset wipes emulated state, all of it or one service's; overcast import cognito-users copies users out of a real AWS user pool into an Overcast one.

overcast reset clears emulated state. overcast import is the one command that reads from real AWS, and so far it copies Cognito users.

overcast reset s3
overcast import cognito-users --from-pool-id us-east-1_abc123 --to-pool-id us-east-1_def456

Part of the CLI reference.

overcast reset [service]

Wipes all emulated state, or one service’s, via POST /_overcast/reset[/{service}]. It is available on every daemon, not only a debug one: it grants no more power than deleting every resource by hand through the ordinary AWS API already does.

Caution

This destroys state. In an interactive terminal you are asked to confirm unless --yes/-y is given; a non-interactive caller (CI, a pipe) proceeds without prompting.

overcast reset                # wipe everything, with a confirmation prompt
overcast reset s3             # wipe only S3 state
overcast reset dynamodb --yes # skip the prompt

overcast import cognito-users

Copies users from a real AWS Cognito user pool into an Overcast pool, in batches. Passwords cannot be read out of AWS, so imported users land in FORCE_CHANGE_PASSWORD status.

FlagDefaultDescription
--from-pool-idRequired. Source user pool ID in real AWS.
--to-pool-idRequired. Target user pool ID in Overcast.
--from-profileAWS profile for the source account.
--from-region(auto)Region for the source pool.
--userImport one user by sub (UUID) instead of the whole pool.
--max-users0Cap on users imported (0 = unlimited).
--batch-size100Users per batch sent to the daemon.
overcast import cognito-users \
  --from-pool-id us-east-1_abc123 --to-pool-id us-east-1_def456