Validate Instrumentor Changes within Cells Infrastructure

Overview

When making changes to the Instrumentor, it’s important to validate these changes within the Cells Infrastructure to ensure they function properly in our Cells Organization.

Additionally, you may need to test your changes alongside supporting services in our Cells Organization, such as the HTTP Router and Topology Service.

Note

This process is specifically for validating that changes work within Cells Infrastructure and does NOT replace the review requirements for the Instrumentor tool itself. The sandbox and testing in CI of Instrumentor must still be maintained to validate changes for the Dedicated product and PubSec.

How to create a Cell with your Instrumentor Changes

Step 1: Create and Submit Your Changes Create a Merge Request (MR) with your changes to the Instrumentor repository.

Step 2: Wait for Image Building Wait for the CI jobs to complete, which will build Instrumentor images for your branch.

Step 3: Provision a Test Cell Provision a new Cell by updating the instrumentor_version in the TENANT_MODEL with your branch name.

Note

The instrumentor_version must use kebab case. Image tags in Instrumentor automatically transform branch names to match this format. Example: no_hooks_gitaly becomes no-hooks-gitaly.

Step 4: Test Your Changes

Validate that your changes are working as expected in the cell environment.

Note

To iterate on your Instrumentor changes, follow the Instrument Development Flow

Step 5: Clean Up

Once testing is complete and you’ve verified everything works, de-provision the cell.