Configuración de Bitbucket

DevOps Insights llegará al final de su vida útil y dejará de estar disponible el 31 de agosto de 2026. Continuous Delivery dejará de estar disponible en las siguientes regiones el 12 de febrero de 2027: au-syd, ca-mon, ca-tor, us-east. Code Risk Analyzer también dejará de estar disponible en todas las regiones a partir de esa fecha. Si en una región no se hace uso activo de estas funciones, es posible que dichas funciones se dejen de ofrecer antes de lo previsto en esa región y dejen de aceptar nuevas instancias. Más información

Guarda tu código fuente en un repositorio (repo) nuevo o ya existente en bitbucket.org y participa en la programación colaborativa a través de wikis, el seguimiento de incidencias y las solicitudes de incorporación de cambios.

Configure Bitbucket para colaborar con su equipo en código:

Desde la IBM Cloud consola, haga clic en el del menú hamburguesa > Automatización de plataformas > Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas a la que desea añadir Bitbucket.

a. Pulse Añadir herramienta.

b. En la sección Integraciones de herramientas, pulse Bitbucket.

Si está configurando esta integración de herramientas en IBM Cloud Público y no ha autorizado a IBM Cloud para que acceda a Bitbucket, pulse Autorizar para ir al sitio web de Bitbucket. Si no tiene ninguna sesión de Bitbucket activa, se le solicitará que inicie sesión. Pulse Otorgar acceso para permitir que las Cadenas de herramientas de IBM Cloud accedan a las siguientes partes de la cuenta de Bitbucket:
- Leer la información de su cuenta. Obtener información básica de usuario para llenar la interfaz de usuario.
- Leer y modificar los problemas de los repositorios. Permitir que Continuous Delivery actualice los problemas para indicar cuándo despliega el conducto confirmaciones que se adjuntan a dichos problemas.
- Leer los valores del proyecto de su equipo y leer los repositorios contenidos en los proyectos de su equipo. Permitir que Continuous Delivery se integre con los repositorios que son propiedad de los equipos.
- Leer y modificar los repositorios y sus solicitudes de extracción. Permitir que Continuous Delivery envíe código de ejemplo a los repositorios, cuando los usuarios soliciten el código.
- Administrar los repositorios. Permitir que Continuous Delivery cree nuevos repositorios, cuando lo soliciten los usuarios.
- Leer la información de la pertenencia al equipo. Permitir que Continuous Delivery muestre una lista de sus equipos en el menú Propietario que se visualiza al crear un nuevo repositorio.
- Leer y modificar los webhooks de sus repositorios. Permitir que el conducto active las compilaciones cuando las confirmaciones se envíen a un repositorio.
Si tiene una sesión de Bitbucket activa pero no ha especificado la contraseña recientemente, es posible que se le solicite que especifique su contraseña de Bitbucket para confirmar.
Pulse el servidor de Bitbucket que desee utilizar.
Si tiene un repositorio de Bitbucket que desea utilizar, escriba el URL para el repositorio. Para el tipo de repositorio, pulse Existente.
Si desea utilizar un repositorio nuevo de Bitbucket, escriba un nombre para el repositorio, escriba el URL del repositorio que está clonando o bifurcando y seleccione el tipo de repositorio:

a. Para crear un repositorio vacío, pulse Nuevo.

b. Para crear una copia de un repositorio, pulse Clonar.

c. Para bifurcar un repositorio para que pueda aportar cambios a través de solicitudes de extracción, pulse Bifurcar.
Para crear un repositorio privado en el servidor, marque el recuadro de selección Convertir este repositorio en privado.
Para utilizar Problemas de Bitbucket para realizar un seguimiento de los problemas, marque el recuadro de selección Habilitar problemas de Bitbucket.
Para realizar un seguimiento del despliegue de cambios en el código mediante la creación de etiquetas y comentarios en las confirmaciones, y etiquetas y comentarios en los problemas a los que hacen referencia las confirmaciones, marque el recuadro de selección Hacer un seguimiento del despliegue cambios de código.
Pulse Crear integración.
En la cadena de herramientas, en la tarjeta Herramientas de terceros, pulse la integración de la herramienta Bitbucket para el repositorio de Bitbucket con el que desee trabajar. Se abrirá el sitio web de Bitbucket, donde puede ver el contenido del repositorio.
Si ha habilitado Problemas de Bitbucket, pulse Problemas de Bitbucket para abrirlo. Puede utilizar esta instancia de Problemas de Bitbucket para toda la cadena de herramientas, aunque la cadena de herramientas contenga varios repositorios Bitbucket.

Si no tiene privilegios de propietario o maestro para el repositorio al que está enlazando, la integración estará limitada porque no puede utilizar un webhook. Los webhooks se necesitan para ejecutar automáticamente un conducto cuando se envía una confirmación al repositorio. Sin un webhook, debe iniciar los conductos manualmente.

Configuración de Bitbucket mediante la API

La integración de herramientas de Bitbucket admite los siguientes parámetros de configuración que puedes utilizar con la API y los HTTP SDK de Toolchain al crear, leer y actualizar integraciones de herramientas.

Debe especificar la propiedad tool_type_id en el cuerpo de la solicitud con el valor bitbucketgit.

Parámetros de integración de la herramienta Bitbucket
Parámetro	Uso	Tipo	Argumento de Terraform	Descripción
url_raíz_api	opcional, actualizable	Serie	url_raíz_api	La URL de la API de Bitbucket, como `https://api.bitbucket.org`.
rama_predeterminada	opcional, actualizable	Serie	rama_predeterminada	El nombre de la rama predeterminada, por ejemplo, `main`.
enable_traceability	opcional, actualizable, `Default: false`	Boolean	enable_traceability	Establece este valor en « `true` » para realizar un seguimiento de la implementación de los cambios en el código mediante la creación de etiquetas, marcas y comentarios en las confirmaciones, las solicitudes de incorporación de cambios y los incidencias a las que se hace referencia.
id_git	opcional, inmutable	Serie	id_git	Establezca este valor en `bitbucketgit` para bitbucket.org, o en el GUID de un servidor Bitbucket personalizado.
has_issues	opcional, actualizable, `Default: true`	Boolean	problemas_de_cadena_de_herramientas_habilitados	Establezca este valor en `true` para habilitar los problemas en el repositorio de Bitbucket y para añadir una tarjeta de herramienta Problemas a la cadena de herramientas. Establezca este valor en `false` para eliminar la tarjeta de integración de herramientas de la cadena de herramientas. Este valor no afecta a si los problemas están habilitados en el propio repositorio de Bitbucket.
propietario_integración	opcional, actualizable	Serie	propietario_integración	El usuario que realiza operaciones Git.
owner_id	opcional, inmutable	Serie	owner_id	El usuario o grupo de Bitbucket que es propietario del repositorio. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
repositorio_privado	opcional, inmutable, `Default: false`	Boolean	repositorio_privado	Establezca este valor en `true` para que el repositorio sea privado al crear un repositorio, o al clonar o bifurcar un repositorio. Este parámetro no se utiliza cuando se enlaza a un repositorio existente.
id_reposición	opcional, inmutable	Serie	id_reposición	El ID del repositorio de Bitbucket.
repo_name	opcional, inmutable	Serie	repo_name	El nombre del repositorio de Bitbucket que se va a crear. Este parámetro es necesario al crear un repositorio, o clonar o bifurcar un repositorio. Este valor se calcula cuando se enlaza a un repositorio existente.
repo_url	opcional, inmutable	Serie	repo_url	El URL del repositorio Bitbucket para la integración de esta herramienta. Este parámetro es necesario cuando se enlaza a un repositorio existente. Este valor se calcula al crear un repositorio, o clonar o bifurcar un repositorio.
url_repo_origen	opcional, inmutable	Serie	url_repo_origen	El URL del repositorio que desea bifurcar o clonar. Este parámetro es necesario cuando bifurca o clona un repositorio, pero no se utiliza al crear un repositorio o enlace a un repositorio existente.
url_señal	opcional, actualizable	Serie	url_señal	El token URL que se utiliza para autorizar con el servidor Bitbucket.
tipo	necesario, inmutable	Serie	tipo	La operación que se debe realizar para inicializar la nueva integración de herramientas. Utilice `new` para crear un repositorio Git, `clone` para clonar un repositorio existente en un nuevo repositorio Git, `fork` para bifurcar un repositorio Git existente o `link` para enlazar a un repositorio Git existente.

Más información sobre Bitbucket

Para obtener más información sobre Bitbucket, consulta los recursos de Bitbucket Cloud.