Bitbucket Data CenterInstall

Overview

This node integrates with the Bitbucket Data Center API to manage projects and other related resources. Specifically, for the Project - Create operation, it allows users to create a new project within their Bitbucket Data Center instance by specifying essential details such as the project key, name, and an optional description.

Common scenarios where this node is beneficial include automating project setup workflows, integrating Bitbucket project creation into CI/CD pipelines, or managing multiple projects programmatically without manual intervention in the Bitbucket UI.

Practical example:
A DevOps engineer can use this node to automatically create a new Bitbucket project whenever a new product line is initiated, ensuring consistent naming conventions and descriptions are applied.

Properties

Output

The output JSON contains the response from the Bitbucket Data Center API after creating the project. This typically includes details about the newly created project such as its key, name, description, links, and metadata returned by the API.

If the creation is successful, the output will be a JSON object representing the project resource. If there is an error, the node may return an error message instead.

No binary data output is involved in this operation.

Dependencies

• Requires access to a Bitbucket Data Center server.
• Requires credentials configured in n8n for authentication, either via:
  • A personal access token credential, or
  • Basic authentication credential (username and password).
• The node uses the Bitbucket Data Center REST API endpoint /rest/api/1.0/projects to create projects.

Troubleshooting

• Common issues:

  • Authentication failures: Ensure that the provided API token or basic auth credentials have sufficient permissions to create projects.
  • Duplicate project key: The project key must be unique; attempting to create a project with an existing key will result in an error.
  • Invalid input: Missing required fields like project key or name will cause the request to fail.

• Error messages:

  • "Bitbucket Data Center API request failed: ..." indicates an issue with the API call, possibly due to network problems, invalid credentials, or insufficient permissions.
  • "The operation "create" is not supported for resource "project" would indicate a misconfiguration but should not occur if using the node correctly.

• Resolution tips:

  • Verify credentials and permissions in Bitbucket.
  • Double-check that the project key is unique and follows any naming constraints.
  • Confirm all required parameters are provided and valid.

Links and References

• Bitbucket Data Center REST API Documentation - Projects
• Bitbucket Data Center Authentication
• n8n Documentation on Credentials