Conecte su cuenta de Bitbucket para que sus sitios se implementen desde un repositorio

Qué ventajas le ofrece conectarlo

Conectar Bitbucket permite que un sitio web se implemente desde uno de sus repositorios de Bitbucket Cloud: envíe un push a la rama y el sitio se actualizará.

Antes de comenzar

Una cuenta de Bitbucket Cloud con acceso a los repositorios que desee implementar.

1. Cree la clave en Bitbucket

Bitbucket ofrece dos tipos de credenciales, y cualquiera de ellas funciona:

• Un token de acceso para un repositorio, proyecto o espacio de trabajo, creado desde la propia configuración de ese repositorio, proyecto o espacio de trabajo en Access tokens. Está vinculado a ese repositorio, proyecto o espacio de trabajo en lugar de a una persona. Otórguele acceso de lectura a los repositorios.
• Un token de API en su cuenta de Atlassian. Seleccione su perfil y, a continuación, Account settings → Security → Create and manage API tokens → Create API token with scopes. Asígnele un nombre, establezca una fecha de vencimiento, elija Bitbucket como la aplicación y seleccione acceso de lectura a los repositorios. Bitbucket muestra el token una sola vez; cópielo en ese momento.

2. Conéctelo aquí

Abra Integrations en su panel de control y elija Connect an account. Elija Code hosting como grupo y Bitbucket como cuenta, complete API token —y, si ha creado un token en su cuenta de Atlassian en lugar de un token de acceso, también Account username— y pulse Connect account.

Probamos lo que pega antes de guardar nada. Las claves que no funcionan nunca se almacenan, y la respuesta indica cuál fue el problema. Las claves válidas se guardan cifradas en nuestra bóveda de secretos —nunca en nuestra base de datos— y no se vuelven a mostrar nunca, ni siquiera a usted.

El nombre de usuario determina cómo enviamos el token, por lo que debe introducirlo solo para un token de cuenta. Un token de acceso introducido con un nombre de usuario, o un token de cuenta sin él, será rechazado.

Qué sucede después

• Un sitio web puede implementarse directamente desde un repositorio de esta cuenta: elíjalo en la conexión de repositorios del sitio, seleccione el repositorio y la rama, y un push iniciará la implementación.
• Cada una de las demás ramas puede obtener su propia vista previa, lo que le permite revisar un cambio antes de que llegue al sitio en vivo.
• Los alojamientos estáticos basados en Git, como Render y Azure Static Web Apps, utilizan esta conexión como origen del código del sitio web.

Si no se conecta

Falta un repositorio. Un token de acceso solo alcanza al repositorio, proyecto o espacio de trabajo en el que se creó. Cree uno en el nivel que cubra todos los repositorios que necesite.

Funcionaba y dejó de hacerlo. Ambos tipos de token pueden vencer. Cree uno nuevo y conéctelo.

Indica que la clave fue rechazada. Casi siempre se debe a una de estas tres razones: un espacio o un salto de línea copiado junto con ella, una clave que ha vencido o una clave que fue revocada o regenerada después de haberla copiado. Cree una nueva y péguela de nuevo.

Se conecta, pero más tarde algo falla. La clave se autentica, pero carece de un permiso necesario para la acción. Cree una nueva clave con los permisos indicados anteriormente, desconecte la conexión anterior y conecte la nueva clave.

Desconexión

Abra Integrations, busque la cuenta y pulse Disconnect. Esto elimina la clave almacenada de inmediato. Cualquier elemento que la estuviera utilizando se detendrá en su siguiente acción, y las pantallas que dependían de ella lo advertirán en lugar de fallar de forma silenciosa.

Desconectar no deshace lo que ya se hizo: los registros, las implementaciones o los ajustes que modificamos en su cuenta permanecen como están. Si cree que la propia clave ha podido filtrarse, revóquela también en el proveedor; desconectarla elimina nuestra copia, no la de ellos.