Hosted Control Plane

Overview

A Hosted Control Plane enables you to manage and run your jobs, pipelines, and builds efficiently in a scalable environment. This guide walks you through the steps to set up your Hosted Control Plane, create queues for runners, and integrate BuildKit if needed.

Prerequisites

• Ensure that your Connector setup is complete before proceeding.

Steps to Set Up Hosted Control Plane

1. Create the Control Plane

Once your connector is ready, you can proceed to create the control plane. This serves as the central management hub for your jobs and pipelines.

2. Check Control Plane Details

After the control plane is created, verify its status and details to ensure it’s operational.

3. Create a Queue for Runners

Now that the control plane is ready, you need to create a queue for the runner. This queue will manage the execution of tasks. Depending on your use cases, you can create multiple queues.

4. Monitor Queue Health

Once the queue is created, monitor its health status. A healthy queue will automatically register available runners.

5. Create a Pipeline Using the Queue

Next, create a pipeline and assign it to the queue by specifying the queue’s name in the runs_on field.

6. (Optional) Set Up BuildKit for Multi-Arch Builds

If your project requires BuildKit for Docker builds, especially for multi-architecture support, you'll need to create a BuildKit instance. Note that multi-architecture BuildKit is available only for enterprise users.

Conclusion

With the Hosted Control Plane, queues for runners, and optional BuildKit setup, your system is now ready to efficiently manage and run jobs. You can easily scale by adding more queues, runners, or BuildKit instances depending on your project needs.

If you have any issues or require further assistance, please refer to the support documentation or contact your system administrator.