DOCS / GUIDES

Migrating from the barn to the coop

Plan a move from on-premises hardware to the cloud without losing a feather.

Advanced20 min read
Before you beginYou need the cluck CLI, a Pollosoft account, and a coop to work in. This guide assumes you are comfortable with the basics. If you are not, start with Getting started.

Overview

Plan a move from on-premises hardware to the cloud without losing a feather. The whole thing takes about 20 minutes, and the commands below are the ones you will use along the way.

$ cluck coop create migration-target
$ cluck egg import --from s3://old-barn/exports
$ cluck molt run --dry-run

Steps

  1. Inventory. List every service, database, and cron job in the barn. The weird one in the corner is always important.
  2. Choose a strategy. Rehost the easy ones, replatform the medium ones, and rebuild the ones that make everyone sigh.
  3. Move data first. Replicate your databases to the coop and keep them in sync. Test with real traffic before cutting over.
  4. Cut over. Pick a quiet hour, switch DNS with RoostDNS, and keep the old barn warm for two weeks in case you need to scurry back.

Commands used

Keep going

Stuck? Check the error codes, the FAQ, or the glossary.