diff options
Diffstat (limited to 'doc/development/cells/index.md')
-rw-r--r-- | doc/development/cells/index.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/doc/development/cells/index.md b/doc/development/cells/index.md new file mode 100644 index 00000000000..30dccd91c9d --- /dev/null +++ b/doc/development/cells/index.md @@ -0,0 +1,37 @@ +--- +stage: Data Stores +group: Tenant Scale +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments +--- + +# GitLab Cells Development Guidelines + +For background of GitLab Cells, refer to the [blueprint](../../architecture/blueprints/cells/index.md). + +## Essential and additional workflows + +To make the application work within the GitLab Cells architecture, we need to fix various +[workflows](../../architecture/blueprints/cells/index.md#2-essential-workflows). + +Here is the suggested approach: + +1. Pick a workflow to fix. +1. For each table affected for the chosen workflow, choose the approriate + [GitLab schema](../database/multiple_databases.md#gitlab-schema). +1. Identify all cross-joins, cross-transactions, and cross-database foreign keys for + these tables. + See the [multiple databases guide](../database/multiple_databases.md) + on how to identify, and allowlist these items. +1. Fix the cross-joins and cross-database foreign keys necessary for the + workflow to work with GitLab Cells. + See the [multiple databases guide](../database/multiple_databases.md) + on how to fix these items. +1. For the cross-joins, cross-transactions, and cross-database foreign keys that + were not fixed, open and schedule issues to fix later. +1. Confirm the fixes work by completing the workflow successfully in a local + GDK running multiple cells. + +Refer to following epics for examples: + +- [User can create group on Cell 2 while users are shared between Cells](https://gitlab.com/groups/gitlab-org/-/epics/9813) +- [Essential workflows: User can create Project](https://gitlab.com/groups/gitlab-org/-/epics/11683) |