GitLab

Firefly integrates with GitLab to connect your infrastructure code repositories with your cloud resources. This integration enables powerful features like tracing cloud resources back to their defining code ("Jump to Code") and automatically creating Merge Requests for newly codified resources and drift remediation.

Prerequisites

• A GitLab account with access to your infrastructure repositories.

• Appropriate permissions to create OAuth applications.

• Repositories containing Terraform, CloudFormation, or other IaC files you want to connect to Firefly.

Setup Procedure

1. Log in to your GitLab account.

2. Click on your Avatar icon on the top right panel, then click on Preferences.

3. Select Applications, and then click on Add new application.

4. Select a name for the application.

5. In the Redirect URI, please paste the following URL: https://app.firefly.ai/integrations/gitlab-integration

6. In the scope section, please select the API option.

   Note: API must be selected for the integration to be successful.

7. Scroll to the bottom of the page and click Save application. You will be directed to a new screen where you can see the Application ID, Secret and Callback URL.

8. Please copy the Application ID and paste it in Firefly's GitLab Integration page.

9. Please copy the Secret and paste it in Firefly's GitLab Integration page.

10. After filling the information, click the Authorize button in Firefly's GitLab Integration page.

11. In the new page that you were directed to, press the Authorize <APPLICATION NAME> button.

    Note: You must authorize the application for the integration to be successful.

12. After authorizing the new application, you will be redirected back to Firefly's application.

13. After the integration is completed, please select the Project IDs and/or Group IDs for webhooks to be installed from the dropdown menu below the "Authorize" button.

Features Enabled

• Jump to Code: Trace resources in your cloud inventory back to the GitLab file and specific line that defines them.

• Automated Merge Requests: When Firefly codifies an unmanaged resource, it can commit the new infrastructure code as a Merge Request.

• IaC Tracking: Firefly maintains awareness of which resources are defined in code and which are not.

• Drift Remediation: Firefly can detect drift between the code and the actual resources and create a Merge Request to fix it.

• Workspace Integration: GitLab can be selected during Workspace creation or modification, enabling seamless integration with associated GitLab repositories.