Prerequisites
Before you start, make sure:- You have Admin permission on the Bitbucket workspace where you want to install the app
- At least one repository contains Terraform, Pulumi, or other infrastructure-as-code files
Steps
Navigate to Integrations
- Log in to your Yasu dashboard at app.yasu.cloud
- Go to Settings → Integrations
- Click Connect next to Bitbucket
Install the Forge app
A new tab opens to the Atlassian Marketplace Forge install page.
- Select the workspace you want to connect
- Click Install to add the Yasu Forge app
- Return to the Yasu tab when the installation is complete
The Forge app uses Atlassian’s webtrigger architecture to securely communicate between Bitbucket and Yasu.
Link your workspace
Back in Yasu, the page automatically detects the Forge app installation. When your workspace appears, click Link Workspace to complete the connection.
Detection typically takes 10–30 seconds. If it does not appear, click Open Install Page Again to verify the app was installed.
Select repositories
- Browse the available repositories in your connected workspace
- Click Add on the repositories you want Yasu to analyze
- Click Save Configuration
Verify PR analysis
- Open or update a pull request that modifies infrastructure code in one of the selected repositories
- Wait for the Yasu webhook to fire
- Confirm the cost analysis comment appears on the PR
PR analysis comments typically appear within 1–2 minutes of opening or updating a pull request.
Troubleshooting
Forge app install page does not open
Forge app install page does not open
Common causes:
- A popup blocker is preventing the new tab from opening
- You do not have Admin permission on the Bitbucket workspace
Yasu does not detect the Forge app
Yasu does not detect the Forge app
Common causes:
- The app was installed into a different workspace than expected
- The installation did not complete successfully
PR comments are not appearing
PR comments are not appearing
What to check:
- Verify the repository is selected in Yasu’s integration settings
- Confirm the pull request modifies infrastructure-as-code files (Terraform, Pulumi, CloudFormation, etc.)
- Check that the Forge app is listed as installed in your Bitbucket workspace settings