External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-01-11 18:09:57 -03:30
Code Issues Packages Projects Releases Wiki Activity
awx/tools/docker-compose/docs/data_migration.md
Christian M. Adams 2239c8d6e5
Add full path to data migration example in docs
2021-02-23 09:07:37 -05:00

2.5 KiB
Raw Blame History

Migrating Data from Local Docker

If you are migrating data from a Local Docker installation (17.0.1 and prior), you can migrate your data to the development environment via the migrate.yml playbook, or by using the manual steps described below.

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

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 secret key value you had with your previous Local Docker deployment.

Migrate data with migrate.yml

If you had 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/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 start your containers
$ make docker-compose
  1. After ensuring your data has been successfully migrated, you may delete your old data directory (typically stored at ~/.awx/pgdocker).

Migrating data manually

  1. With Local Docker still running, perform a pg_dumpall:

Note: If Local Docker is no longer running docker-compose -f ~/.awx/awxcompose/docker-compose.yml up postgres

$ docker-compose -f ~/.awx/awxcompose/docker-compose.yml exec postgres pg_dumpall -U awx > awx_dump.sql
  1. Remove all local docker containers (specifically awx_postgres)
$ docker -f rm awx_postgres
  1. Template the new docker-compose.yml
$ ansible-playbook -i tools/ansible/inventory tools/ansible/sources.yml
  1. Start a container with a volume (using the new tools/docker-compose/_sources/docker-compose.yml)
$ docker-compose -f ../docker-compose/_sources/docker-compose.yml up postgres
  1. Restore to new awx_postgres
$ docker-compose -f ../docker-compose/_sources/docker-compose.yml exec -T postgres psql -U awx -d awx -p 5432 < awx_dump.sql
  1. Run the docker-compose.yml to start the containers
$ docker-compose -f ../docker-compose/_sources/docker-compose.yml up task
  1. Check to ensure your data migration was successful, then you can delete your the awx_dump.sql backup and your old data directory.