External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-01-10 15:32:07 -03:30
Code Issues Packages Projects Releases Wiki Activity
awx/tools/docker-compose/docs/data_migration.md
Ryan Petrello 269e71c069
clarify this migration is only for 17.x -> 18.x
2021-03-10 09:41:50 -05:00

1.7 KiB
Raw Blame History

Migrating Data from Local Docker

If you are migrating data from a Local Docker installation (17.0.1 and prior) to AWX 18.0 or higher, you can migrate your data to the development environment via the migrate.yml playbook.

Note: This will also convert your postgresql bind-mount into a docker volume.

Migrate data with migrate.yml

First, in the inventory file, set your pg_password, broadcast_websocket_secret, secret_key, and any other settings you need for your deployment. Make sure you use the same values from the inventory file in your existing pre-18.0.0 Docker deployment.

If you used a custom pgdocker or awxcompose location, you will need to set the postgres_data_dir and old_docker_compose_dir variables.

  1. Run the migrate playbook to migrate your data to the new postgresql container and convert the data directory to a volume mount.
$ ansible-playbook  -i tools/docker-compose/inventory tools/docker-compose/ansible/migrate.yml -e "migrate_local_docker=true" -e "postgres_data_dir=~/.awx/pgdocker" -e "old_docker_compose_dir=~/.awx/awxcompose"
  1. Change directory to the top of your awx checkout, and follow the development environment installation instructions to start your containers:
$ make docker-compose-build
$ make docker-compose
$ docker exec tools_awx_1 make clean-ui ui-devel

  1. After ensuring your data has been successfully migrated, you may delete your old data directory (typically stored at ~/.awx/pgdocker).

  2. Note that after migration, the development environment will be available at https://localhost:8043/ (not http://localhost).