From a2f6346fca65df604e7f308716daa95671bebde1 Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:28:07 -0800 Subject: [PATCH 1/6] add instructions to migrate data from old devservices --- .../devservices.mdx | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index 07bf9c20d03ca..d75fb42ba0447 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -76,3 +76,32 @@ Common modes: ```shell devservices up --mode symbolicator ``` + +## Migrating data from `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: `snuba_clickhouse-data` +Postgres: `sentry_postgres-data` +Kafka: `kafka_kafka-data` +Redis: `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 +``` + From 16b9c477aafce8d615d358137c22964eaa3bd931 Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:30:09 -0800 Subject: [PATCH 2/6] Add old docker volume names too --- .../devservices.mdx | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index d75fb42ba0447..46c3425552071 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -85,10 +85,21 @@ devservices up --mode symbolicator Volume names are different for each service. -Clickhouse: `snuba_clickhouse-data` -Postgres: `sentry_postgres-data` -Kafka: `kafka_kafka-data` -Redis: `redis_redis-data` +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 From a9db3a087ad27b72013dc47937bcda0187d7a89a Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:32:12 -0800 Subject: [PATCH 3/6] get rid of special character --- develop-docs/development-infrastructure/devservices.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index 46c3425552071..b0a6af4cf076f 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -106,7 +106,7 @@ Redis: docker volume create sentry_postgres-data # Copy over the data from the old volume -docker run --rm \  +docker run --rm \ -v sentry_postgres:/old_volume \ -v sentry_postgres-data:/new_volume \ ubuntu \ From 6081cfc3cffeee2dda8e35bdd0d99ff58b6e7558 Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:33:04 -0800 Subject: [PATCH 4/6] remove extra newline from end of file --- develop-docs/development-infrastructure/devservices.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index b0a6af4cf076f..cd8df81acc2a2 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -115,4 +115,3 @@ docker run --rm \ # Validate that data has been copied over docker run --rm -v sentry_postgres-data:/data ubuntu ls -l /data ``` - From e459039de626e1d9dce35474f3232967ff03367b Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:40:37 -0800 Subject: [PATCH 5/6] tweak header to mention sentry devservices is deprecated --- .../development-infrastructure/devservices.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index cd8df81acc2a2..91ef39baac65e 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -77,7 +77,7 @@ Common modes: devservices up --mode symbolicator ``` -## Migrating data from `sentry devservices` +## 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. @@ -85,19 +85,19 @@ devservices up --mode symbolicator Volume names are different for each service. -Clickhouse: +- Clickhouse: - old: `sentry_clickhouse` - new: `snuba_clickhouse-data` -Postgres: +- Postgres: - old: `sentry_postgres` - new: `sentry_postgres-data` -Kafka: +- Kafka: - old: `sentry_kafka` - new: `kafka_kafka-data` -Redis: +- Redis: - old: `sentry_redis` - new: `redis_redis-data` From 9b62f6fcf22ba595bc06f01de6a39a8a42defe28 Mon Sep 17 00:00:00 2001 From: Hubert Deng Date: Thu, 23 Jan 2025 11:57:34 -0800 Subject: [PATCH 6/6] remove unnecessary bullet points --- develop-docs/development-infrastructure/devservices.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/develop-docs/development-infrastructure/devservices.mdx b/develop-docs/development-infrastructure/devservices.mdx index 91ef39baac65e..00e05f03474d4 100644 --- a/develop-docs/development-infrastructure/devservices.mdx +++ b/develop-docs/development-infrastructure/devservices.mdx @@ -85,19 +85,19 @@ devservices up --mode symbolicator Volume names are different for each service. -- Clickhouse: +Clickhouse: - old: `sentry_clickhouse` - new: `snuba_clickhouse-data` -- Postgres: +Postgres: - old: `sentry_postgres` - new: `sentry_postgres-data` -- Kafka: +Kafka: - old: `sentry_kafka` - new: `kafka_kafka-data` -- Redis: +Redis: - old: `sentry_redis` - new: `redis_redis-data`