Create a Project Using Bitbucket Cloud

Contentstack Launch streamlines your content delivery by connecting directly to your code repository. This guide provides step-by-step instructions for importing your project into Contentstack Launch using Bitbucket Cloud as your repository host.

Unlike GitHub, which allows direct connections, Bitbucket Cloud requires installing a Marketplace app at the organizational level to establish the connection.

Note:The auto-deploy feature in Launch is currently not available for repositories hosted on Bitbucket Cloud.

Prerequisites

• Active Contentstack Launch Account: Make sure you're ready to go with an active Launch account.
• Bitbucket Cloud Admin Access: You'll need administrative control within your Bitbucket Cloud organization.
• Bitbucket Cloud Repository: The project you want to import has to be on Bitbucket Cloud.
• OAuth Consumer Permissions: Ensure you're allowed to install OAuth consumers in your Bitbucket Cloud organization.

Install the Bitbucket Cloud Marketplace App

Follow the steps given below to install the Bitbucket Cloud app from Contetnstack Marketplace

1. Log in to your Contentstack account and select the Marketplace icon from the left navigation panel.
2. Click Apps from the left panel.
3. Within the Marketplace, you can see the available apps. Hover over the Bitbucket Cloud app and click Install.
4. Authorize the app to let it integrate with your Bitbucket Cloud organization.
5. Grant the necessary permissions to allow Contentstack to access your Bitbucket Cloud repositories.

Connect your Bitbucket Cloud Account to Launch

Note: Only the Organization Admin/Owner has the right to create projects in a stack for Launch.

Now that the app is installed, let's follow the steps given below to establish a connection between your Bitbucket Cloud and Contentstack Launch.

1. Click the Launch option from the left navigation panel, as shown below.
2. Click + New Project.
3. Select Bitbucket Cloud as your repository host. During this step, Contentstack Launch will request access to the repositories that you manage.

Configure and Deploy your Project in Launch

Now that we have connected your Bitbucket Cloud account with Contentstack Launch, we will now configure the project using the following steps:

1. Select the repository you want to import.
2. Then, define the following settings:
   1. Environment Variables: Add any required environment variables.
   2. Build Commands: Specify the build and deployment commands for your project.
   3. Output Directory: Define the folder for your built project (for example, dist or build).
3. Once all the fields are filled with appropriate values and the configuration is complete, click the Deploy button.
4. Monitor the deployment logs to ensure the process completes successfully.

Delete your Project from Launch

To delete the project:

1. Select your project from the Launch dashboard.
2. Click the Settings icon.
3. In the General section, click the Delete Project button under Delete Project.
4. In the Delete Project modal, enter DELETE and click the Yes, Delete button.

This deletes your project successfully.

Troubleshooting Common Issues

Below, we have listed some common issues you might encounter, along with their solutions.

1. Connection Failure:
   1. Ensure the Marketplace app is installed and active in your Bitbucket Cloud organization.
   2. Verify that you have granted the necessary permissions during the app installation.
2. Repository Not Found:
   1. Confirm that the repository is hosted in the authenticated Bitbucket Cloud account.
   2. Ensure you have Product admin access to access the repository.