Standardize your software creation workflow by creating templates that integrate best practices and adhere to your organization’s standards.
Templates are cataloged as components, include boilerplate code, and can include webhooks for automating the rest of your toolchain.
To take the following steps, you must be a Compass admin.
In the main navigation, select Apps.
Find the Bitbucket or GitHub app and select Install.
Once the app is installed, you need to configure the app so it can connect to your repositories.
To take the following steps, you must be a admin of the Bitbucket Cloud workspace you want to connect to Compass.
In the main navigation, select Apps.
Find the Bitbucket app, select Configure, and allow the app to access your Atlassian account.
Select Connect Bitbucket, and continue to Bitbucket's permissions page.
The Authorize for workspace list displays the workspaces that you are an admin of. Select a workspace to connect with Compass.
Select Grant Access.
Once you’re connected to a Bitbucket workspace, you’ll be taken back to the Bitbucket app in Compass.
To take the following steps, you must be a GitHub organization owner.
In the main navigation, select Apps.
Find the GitHub app, select Configure, and allow the app to access your Atlassian account.
Select Connect GitHub, and continue to GitHub’s permissions page.
In GitHub, select the organization account you want to connect to.
Once you’re connected to a GitHub organization, you’ll be taken back to the GitHub app in Compass.
Components created from a template fork that template's repository. Make sure you have a base repository link to add to the template.
Start creating a template from anywhere in Compass by pressing c t.
You can create a maximum of one template on a Free plan and 20 on a Standard plan.
In the main navigation, select Templates.
On the Templates page, select Create.
Fill out the basic information for the template.
Select Next.
Optionally paste a webhook link to send a JSON event when a component is created from the template.
Compass will send an HTTP POST request to the webhook, sharing a JSON payload that describes the new component. This means you can continue automation or orchestration of a new software component in your development environment.
To see what the event looks like, refer to the JSON event preview.
You cannot add or edit a webhook after a template is created. We’re adding this functionality soon.
Optionally add one or more parameters to the template. Learn more about parameters.
Parameters are used in conjunction with the webhook, and all parameters and their values are sent in the webhook payload as shown in JSON event preview.
Select Next. You'll be taken to the template's Review page.
If you're happy with everything select Create.
Check that you’re adding a valid Bitbucket or GitHub repository link from the workspace(s) or organization(s) connected to the respective app.
Sometimes this happens due to a network error. Delete the template and create a new one with the webhook you want to add.
There is currently a limit of 100 parameters per template. If you need more than 100 parameters please reach out as we'd love to chat with you!
We're working on improving templates with the following features:
GitLab support.
Edit templates after they’re created.
Validate webhooks as templates are created.
Additional parameter types, such as single select and multi-select.
Customize webhook events to call third-party APIs when components are created from templates (for example, create a new service in Opsgenie each time a component is created from a template).
Rate this page: