Hey, what is the best collection of docs that explains how to migrate and transition my local pulumi deploy logic to pulumi cloud? Thanks

what does your local pulumi deploy logic look like? do you mean migrating your state store to use pulumi cloud, or are you looking for tips around orchestrating updates?

Mostly the state migration. We have a few Python Pulumi projects (catalog Postgres on Hetzner + Cloudflare, plus an auth/sidecar stack with split sub-stacks, all running on the local file backend right now pulumi login --local, all using PULUMI_CONFIG_PASSPHRASE for secret encryption. Feploy logic is just pulumi preview / up driven by per-project manage.sh wrappers. Doppler at runtime when deploying for secrets and envvars for deployment. Nothing too much on the orchestration side right now

Here is the main doc about migrating state backends: https://www.pulumi.com/docs/iac/concepts/state-and-backends/#migrating-between-state-backends Essentially the process is you run

pulumi stack export

on your stack to get its current state file, and then you log into the new backend and run

pulumi stack import

to import the state file into a new stack on the new backend. You can keep using the passphrase secret provider, or you can also switch it to use the pulumi cloud encryption backend: https://www.pulumi.com/docs/iac/concepts/secrets/#changing-the-secrets-provider-for-a-stack

Thanks!