Cells
- Offering: GitLab.com
- Status: Experiment
This feature is available for administrators of GitLab.com only. This feature is not available for GitLab Self-Managed or GitLab Dedicated instances.
Cells 1.0 is in development. For more information about the state of cell development, see epic 12383.
This page explains how to configure the GitLab Rails console for cell functionality. For more information on the proposed design and terminology, see the design document for Cells.
Configuration
The cells related configuration in config/gitlab.yml
is in this format:
cell:
enabled: true
id: 1
database:
skip_sequence_alteration: false
topology_service_client:
address: topology-service.gitlab.example.com:443
ca_file: /home/git/gitlab/config/topology-service-ca.pem
certificate_file: /home/git/gitlab/config/topology-service-cert.pem
private_key_file: /home/git/gitlab/config/topology-service-key.pem
Configuration | Default value | Description |
---|---|---|
cell.enabled | false | To configure whether the instance is a Cell or not. false means all Cell features are disabled. session_cookie_prefix_token is not affected, and can be set separately. |
cell.id | nil | Required to be a positive integer when cell.enabled is true . Otherwise, it must be nil . This is the unique integer identifier for the cell in a cluster. This ID is used inside the routable tokens. When cell.id is nil , the other attributes inside the routable tokens, like organization_id will still be used |
cell.database.skip_sequence_alteration | false | When true , skips database sequence alteration for the cell. Enable for the legacy cell (cell-1 ) before the monolith cell is available for use, being tracked in this epic: Phase 6: Monolith Cell. |
cell.topology_service_client.address | "topology-service.gitlab.example.com:443" | Required when cell.enabled is true . Address and port of the topology service server. |
cell.topology_service_client.ca_file | "/home/git/gitlab/config/topology-service-ca.pem" | Required when cell.enabled is true . Path to the CA certificate file for secure communication. |
cell.topology_service_client.certificate_file | "/home/git/gitlab/config/topology-service-cert.pem" | Required when cell.enabled is true . Path to the client certificate file. |
cell.topology_service_client.private_key_file | "/home/git/gitlab/config/topology-service-key.pem" | Required when cell.enabled is true . Path to the private key file. |
Related configuration
For information on how to configure other components of the cells architecture, see:
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support