From c245abefcbdef2582e89c6c5a2f22b9d335c3f0a Mon Sep 17 00:00:00 2001 From: Ryan Petrello Date: Tue, 23 Feb 2021 17:23:37 -0500 Subject: [PATCH] some more data migration notes some things I noticed while going through an upgrade --- tools/docker-compose/docs/data_migration.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/tools/docker-compose/docs/data_migration.md b/tools/docker-compose/docs/data_migration.md index ee987c93f5..2196f49221 100644 --- a/tools/docker-compose/docs/data_migration.md +++ b/tools/docker-compose/docs/data_migration.md @@ -5,20 +5,24 @@ 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. -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. +First, in the [`inventory` file](../inventory), 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](../ansible/migrate.yml) to migrate your data to the new postgresql container and convert the data directory to a volume mount. ```bash $ 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" ``` -2. Change directory to the top of your awx checkout and start your containers +2. Change directory to the top of your awx checkout, and follow the [development environment installation instructions](../README.md) to start your containers: ```bash +$ make docker-compose-build $ make docker-compose +$ docker exec tools_awx_1 make clean-ui ui-devel ``` 3. After ensuring your data has been successfully migrated, you may delete your old data directory (typically stored at `~/.awx/pgdocker`). + +4. Note that after migration, the development environment will be available at https://localhost:8043/ (not http://localhost).