CI Agent

The CI Agent in Facets automates the integration between your existing Continuous Integration (CI) pipelines and the Facets Control Plane. With this agent, you no longer need to manually edit your CI configuration files to make them Facets-compliant. Instead, you can upload your existing CI file to Facets, and with a single click, generate a Facets-compliant version that is ready to use.

Once generated, you can place this updated file in your Git repository. From there, every time you push a commit to a configured branch, Facets CI Agent will ensure that the container image built is automatically attached to the corresponding environment as per the CI/CD workflow defined in your project.

Read More about CI/CD in facets here

How the CI Agent Works

Benefits of the CI Agent

• Zero Manual Changes: No need to edit YAML or pipeline definitions by hand.
• Seamless Adoption: Works with your existing CI tools (GitHub Actions, GitLab CI, Jenkins, CircleCI, etc.).
• Consistent Deployments: Every commit leads to an image build that is reliably attached to environments in Facets.
• Policy-Driven: Ensures that workflows remain aligned with the deployment and compliance policies defined in Facets.

Troubleshooting

Generated file not working? Ensure you have added the correct secrets (e.g., registry credentials, Facets tokens) to your CI platform.

Image not attaching automatically? Confirm that the CI/CD workflow for the project in Facets is set to "Use CI/CD Workflow Set at the Project Level."

Existing pipeline steps overwritten? Facets does not delete or override your custom steps; it only appends necessary Facets steps. Review the generated file before committing.

FAQ

1. Can I still customise my CI pipeline?

Yes, the generated file can be edited. You can add, remove, or reorder steps as long as the Facets-required steps remain intact.

2. What CI platforms are supported?

Facets currently supports GitHub Actions, GitLab CI, Jenkins, and CircleCI. Additional platforms may be added later.

3. Does this replace the Facets CLI?

No. The CI Agent complements Facets CLI. While CLI is useful for ad-hoc image pushes or credential refresh, the CI Agent ensures automated integration with your Git pipelines.