diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index 07bf9c20d03ca..00e05f03474d4 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -76,3 +76,42 @@ Common modes: ```shell devservices up --mode symbolicator ``` + +## Migrating data from the deprecated `sentry devservices` + + + These instructions can result in data loss. Please proceed with caution. This is an example with postgres, but can be done with other docker volumes as well. + + +Volume names are different for each service. + +Clickhouse: + - old: `sentry_clickhouse` + - new: `snuba_clickhouse-data` + +Postgres: + - old: `sentry_postgres` + - new: `sentry_postgres-data` + +Kafka: + - old: `sentry_kafka` + - new: `kafka_kafka-data` + +Redis: + - old: `sentry_redis` + - new: `redis_redis-data` + +```shell +# Create a new postgres volume +docker volume create sentry_postgres-data + +# Copy over the data from the old volume +docker run --rm \ + -v sentry_postgres:/old_volume \ + -v sentry_postgres-data:/new_volume \ + ubuntu \ + bash -c "cd /old_volume && cp -a . /new_volume" + +# Validate that data has been copied over +docker run --rm -v sentry_postgres-data:/data ubuntu ls -l /data +```