Commit a1a4e3e0 authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Merge branch 'docs-update-test-fixture-import-export-dev-instructions' into 'master'

Update test fixture instructions for import/export dev docs

See merge request gitlab-org/gitlab!32405
parents 456e2d87 1fce77fc
...@@ -339,14 +339,13 @@ Fixtures used in Import/Export specs live in `spec/fixtures/lib/gitlab/import_ex ...@@ -339,14 +339,13 @@ Fixtures used in Import/Export specs live in `spec/fixtures/lib/gitlab/import_ex
There are two versions of each of these fixtures: There are two versions of each of these fixtures:
- A human readable single JSON file with all objects, called either `project.json` or `group.json`. - A human readable single JSON file with all objects, called either `project.json` or `group.json`.
- A tree.tar.gz file containing a tree of files in `ndjson` format. **Please do not edit this file manually unless strictly necessary.** - A folder named `tree`, containing a tree of files in `ndjson` format. **Please do not edit files under this folder manually unless strictly necessary.**
The tools to generate the NDJSON tree from the human-readable JSON files live in the [`gitlab-org/memory-team/team-tools`](https://gitlab.com/gitlab-org/memory-team/team-tools/-/blob/master/import-export/) project. The tools to generate the NDJSON tree from the human-readable JSON files live in the [`gitlab-org/memory-team/team-tools`](https://gitlab.com/gitlab-org/memory-team/team-tools/-/blob/master/import-export/) project.
### Project ### Project
**Please use `legacy-project-json-to-ndjson.sh` to generate the NDJSON tree.** **Please use `legacy-project-json-to-ndjson.sh` to generate the NDJSON tree.**
Once you're done generating the files, please package them using `tar -czf tree.tar.gz tree` from the same directory as the `tree` directory generated is located.
The NDJSON tree will look like this: The NDJSON tree will look like this:
...@@ -380,10 +379,7 @@ tree ...@@ -380,10 +379,7 @@ tree
### Group ### Group
**Please use `legacy-group-json-to-ndjson.rb` to generate the NDJSON tree.** This script can be found in [`gitlab-org/memory-team/team-tools!7`](https://gitlab.com/gitlab-org/memory-team/team-tools/-/merge_requests/7). **Please use `legacy-group-json-to-ndjson.rb` to generate the NDJSON tree.**
Once this MR is merged, the script will be found in the directory mentioned earlier.
Once you're done generating the files, please package them using `tar -czf tree.tar.gz tree` from the same directory as the `tree` directory generated is located.
The NDJSON tree will look like this: The NDJSON tree will look like this:
...@@ -409,4 +405,4 @@ tree ...@@ -409,4 +405,4 @@ tree
└── 4352.json └── 4352.json
``` ```
CAUTION: **Caution:** When updating these fixtures, please ensure you update the `json` files and the `tar.gz` archives, as the tests apply to both. CAUTION: **Caution:** When updating these fixtures, please ensure you update both `json` files and `tree` folder, as the tests apply to both.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment